diff --git a/content/zh-cn/docs/reference/kubernetes-api/authorization-resources/cluster-role-v1.md b/content/zh-cn/docs/reference/kubernetes-api/authorization-resources/cluster-role-v1.md index c528d0c36f..2160bbe2ed 100644 --- a/content/zh-cn/docs/reference/kubernetes-api/authorization-resources/cluster-role-v1.md +++ b/content/zh-cn/docs/reference/kubernetes-api/authorization-resources/cluster-role-v1.md @@ -7,10 +7,8 @@ content_type: "api_reference" description: "ClusterRole 是一个集群级别的 PolicyRule 逻辑分组，可以被 RoleBinding 或 ClusterRoleBinding 作为一个单元引用。" title: "ClusterRole" weight: 5 -auto_generated: false --- `apiVersion: rbac.authorization.k8s.io/v1` `import "k8s.io/api/rbac/v1"` + +- **metadata** (}}">ObjectMeta) + 标准的对象元数据。 - **aggregationRule** (AggregationRule) @@ -60,12 +60,13 @@ ClusterRole 是一个集群级别的 PolicyRule 逻辑分组， 如果设置了 aggregationRule，则 rules 将由控制器管理，对 rules 的直接变更会被该控制器阻止。 - **aggregationRule 描述如何定位并聚合其它 ClusterRole 到此 ClusterRole** + **aggregationRule 描述如何定位并聚合其它 ClusterRole 到此 ClusterRole。** - **aggregationRule.clusterRoleSelectors** ([]}}">LabelSelector) clusterRoleSelectors 包含一个选择器的列表，用于查找 ClusterRole 并创建规则。 如果发现任何选择器匹配的 ClusterRole，将添加其对应的权限。 + + - **rules.verbs** ([]string)，必需 verbs 是适用于此规则中所包含的所有 ResourceKinds 的动作。 @@ -122,6 +126,7 @@ ClusterRole 是一个集群级别的 PolicyRule 逻辑分组， 此字段仅适用于从 ClusterRoleBinding 引用的 ClusterRole。 rules 可以应用到 API 资源（如 “pod” 或 “secret”）或非资源 URL 路径（如 “/api”）， 但不能同时应用于两者。 + +- **metadata** (}}">ListMeta) - Items is a list of ClusterRoles - --> 标准的对象元数据。 - **items** ([]}}">ClusterRole)，必需 items 是 ClusterRole 的列表。 + @@ -166,6 +175,7 @@ ClusterRoleList 是 ClusterRole 的集合。 #### HTTP 请求 GET /apis/rbac.authorization.k8s.io/v1/clusterroles/{name} + #### 参数 -- **name** (路径参数): string，必需 +- **name**（**路径参数**）：string，必需 ClusterRole 的名称 -- **pretty** (查询参数): string +- **pretty**（**查询参数**）：string }}">pretty @@ -193,6 +203,7 @@ GET /apis/rbac.authorization.k8s.io/v1/clusterroles/{name} 200 (}}">ClusterRole): OK 401: Unauthorized + #### 参数 -- **allowWatchBookmarks** (**查询参数**): boolean +- **allowWatchBookmarks**（**查询参数**）：boolean }}">allowWatchBookmarks -- **continue** (**查询参数**): string +- **continue**（**查询参数**）：string }}">continue -- **fieldSelector** (**查询参数**): string +- **fieldSelector**（**查询参数**）：string }}">fieldSelector -- **labelSelector** (**查询参数**): string +- **labelSelector**（**查询参数**）：string }}">labelSelector -- **limit** (**查询参数**): integer +- **limit**（**查询参数**）：integer }}">limit -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty -- **resourceVersion** (**查询参数**): string +- **resourceVersion**（**查询参数**）：string }}">resourceVersion -- **resourceVersionMatch** (**查询参数**): string +- **resourceVersionMatch**（**查询参数**）：string }}">resourceVersionMatch -- **timeoutSeconds** (**查询参数**): integer +- **timeoutSeconds**（**查询参数**）：integer }}">timeoutSeconds -- **watch** (**查询参数**): boolean +- **watch**（**查询参数**）：boolean }}">watch + @@ -274,6 +277,7 @@ GET /apis/rbac.authorization.k8s.io/v1/clusterroles 200 (}}">ClusterRoleList): OK 401: Unauthorized + #### 参数 -- **body**: }}">ClusterRole，必需 +- **body**：}}">ClusterRole，必需 -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun -- **fieldManager** (**查询参数**): string +- **fieldManager**（**查询参数**）：string }}">fieldManager -- **fieldValidation** (**查询参数**): string +- **fieldValidation**（**查询参数**）：string }}">fieldValidation -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty + @@ -326,6 +328,7 @@ POST /apis/rbac.authorization.k8s.io/v1/clusterroles 202 (}}">ClusterRole): Accepted 401: Unauthorized + #### 参数 -- **name** (**路径参数**): string，必需 +- **name**（**路径参数**）：string，必需 ClusterRole 的名称 -- **body**: }}">ClusterRole，必需 +- **body**：}}">ClusterRole，必需 -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun -- **fieldManager** (**查询参数**): string +- **fieldManager**（**查询参数**）：string }}">fieldManager -- **fieldValidation** (**查询参数**): string +- **fieldValidation**（**查询参数**）：string }}">fieldValidation -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty + @@ -382,6 +383,7 @@ PUT /apis/rbac.authorization.k8s.io/v1/clusterroles/{name} 201 (}}">ClusterRole): Created 401: Unauthorized + #### 参数 -- **name** (**路径参数**): string，必需 +- **name**（**路径参数**）：string，必需 ClusterRole 的名称 -- **body**: }}">Patch，必需 +- **body**：}}">Patch，必需 -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun -- **fieldManager** (**查询参数**): string +- **fieldManager**（**查询参数**）：string }}">fieldManager -- **fieldValidation** (**查询参数**): string +- **fieldValidation**（**查询参数**）：string }}">fieldValidation -- **force** (**查询参数**): boolean +- **force**（**查询参数**）：boolean }}">force -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty + @@ -444,6 +443,7 @@ PATCH /apis/rbac.authorization.k8s.io/v1/clusterroles/{name} 201 (}}">ClusterRole): Created 401: Unauthorized + #### 参数 -- **name** (**路径参数**): string，必需 +- **name**（**路径参数**）：string，必需 ClusterRole 的名称 -- **body**: }}">DeleteOptions +- **body**：}}">DeleteOptions -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun -- **gracePeriodSeconds** (**查询参数**): integer +- **gracePeriodSeconds**（**查询参数**）：integer }}">gracePeriodSeconds -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty -- **propagationPolicy** (**查询参数**): string +- **propagationPolicy**（**查询参数**）：string }}">propagationPolicy + @@ -500,6 +498,7 @@ DELETE /apis/rbac.authorization.k8s.io/v1/clusterroles/{name} 202 (}}">Status): Accepted 401: Unauthorized + #### 参数 -- **body**: }}">DeleteOptions +- **body**：}}">DeleteOptions -- **continue** (**查询参数**): string +- **continue**（**查询参数**）：string }}">continue -- **dryRun** (**查询参数**): string +- **dryRun**（**查询参数**）：string }}">dryRun -- **fieldSelector** (**查询参数**): string +- **fieldSelector**（**查询参数**）：string }}">fieldSelector -- **gracePeriodSeconds** (**查询参数**): integer +- **gracePeriodSeconds**（**查询参数**）：integer }}">gracePeriodSeconds -- **labelSelector** (**查询参数**): string +- **labelSelector**（**查询参数**）：string }}">labelSelector -- **limit** (**查询参数**): integer +- **limit**（**查询参数**）：integer }}">limit -- **pretty** (**查询参数**): string +- **pretty**（**查询参数**）：string }}">pretty -- **propagationPolicy** (**查询参数**): string +- **propagationPolicy**（**查询参数**）：string }}">propagationPolicy -- **resourceVersion** (**查询参数**): string +- **resourceVersion**（**查询参数**）：string }}">resourceVersion -- **resourceVersionMatch** (**查询参数**): string +- **resourceVersionMatch**（**查询参数**）：string }}">resourceVersionMatch -- **timeoutSeconds** (**查询参数**): integer +- **timeoutSeconds**（**查询参数**）：integer }}">timeoutSeconds +