6.12. SelfSubjectRulesReview [authorization.k8s.io/v1]
- 描述
- SelfSubjectRulesReview 枚举当前用户可以在命名空间内执行的操作集合。返回的操作列表可能不完整,具体取决于服务器的授权模式,在评估过程中出现任何错误。UI 应使用 SelfSubjectRulesReview 来显示/隐藏操作,或者快速让最终用户有关其权限的原因。外部系统不应使用它来驱动授权决策,因为这会带来混淆、缓存生命周期/撤销和纠正问题。SubjectAccessReview 和 LocalAccessReview 是对 API 服务器的授权决策的正确方法。
- 类型
-
对象
- 必填
-
spec
-
6.12.1. 规格 复制链接链接已复制到粘贴板!
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 标准列表元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| SelfSubjectRulesReviewSpec 定义 SelfSubjectRulesReview 的规格。 |
|
| SubjectRulesReviewStatus 包含规则检查的结果。根据服务器配置的授权者集合以及评估过程中遇到的任何错误,此检查可能不完整。由于授权规则是可添加的,如果一个规则出现在列表中,它会安全地假设该权限具有该权限,即使该列表不完整。 |
6.12.1.1. .spec 复制链接链接已复制到粘贴板!
- 描述
- SelfSubjectRulesReviewSpec 定义 SelfSubjectRulesReview 的规格。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 用于评估规则的命名空间。必需。 |
6.12.1.2. .status 复制链接链接已复制到粘贴板!
- 描述
- SubjectRulesReviewStatus 包含规则检查的结果。根据服务器配置的授权者集合以及评估过程中遇到的任何错误,此检查可能不完整。由于授权规则是可添加的,如果一个规则出现在列表中,它会安全地假设该权限具有该权限,即使该列表不完整。
- 类型
-
对象
- 必填
-
resourceRules
-
nonResourceRules
-
incomplete
-
属性 | 类型 | 描述 |
---|---|---|
|
| 评估错误可以和 Rules 结合使用。它表示规则评估过程中发生了错误,如不支持规则评估的授权者,ResourceRules 和/或 NonResourceRules 可能不完整。 |
|
| 当此调用返回的规则不完整时,不完整。当授权者(如外部授权者)不支持规则评估时,这通常是遇到的。 |
|
| nonResourceRules 是允许主题对非资源执行的操作列表。列表顺序并不重要,可能包含重复项,可能不完整。 |
|
| NonResourceRule 包含描述非资源规则的信息 |
|
| resourceRules 是允许主题对资源执行的操作列表。列表顺序并不重要,可能包含重复项,可能不完整。 |
|
| ResourceRule 是主题允许对资源执行的操作列表。列表顺序并不重要,可能包含重复项,可能不完整。 |
6.12.1.3. .status.nonResourceRules 复制链接链接已复制到粘贴板!
- 描述
- nonResourceRules 是允许主题对非资源执行的操作列表。列表顺序并不重要,可能包含重复项,可能不完整。
- 类型
-
array
6.12.1.4. .status.nonResourceRules[] 复制链接链接已复制到粘贴板!
- 描述
- NonResourceRule 包含描述非资源规则的信息
- 类型
-
对象
- 必填
-
verbs
-
属性 | 类型 | 描述 |
---|---|---|
|
| NonResourceURLs 是一组用户应有权访问的部分 url。允许 s,但只能作为路径中的完整最终步骤。"表示全部。 |
|
| verb 是 kubernetes 非资源 API 动词列表,例如 get, post, put, delete, patch, head, options. "rhacm" 表示全部。 |
6.12.1.5. .status.resourceRules 复制链接链接已复制到粘贴板!
- 描述
- resourceRules 是允许主题对资源执行的操作列表。列表顺序并不重要,可能包含重复项,可能不完整。
- 类型
-
array
6.12.1.6. .status.resourceRules[] 复制链接链接已复制到粘贴板!
- 描述
- ResourceRule 是主题允许对资源执行的操作列表。列表顺序并不重要,可能包含重复项,可能不完整。
- 类型
-
对象
- 必填
-
verbs
-
属性 | 类型 | 描述 |
---|---|---|
|
| apiGroups 是包含资源的 APIGroup 的名称。如果指定了多个 API 组,则允许对任何 API 组中的其中一个枚举资源请求的任何操作。"VirtualMachine" 表示所有 API 组。 |
|
| resourceNames 是规则应用到的可选名称列表。空集表示允许所有内容。"Demo" 表示所有操作。 |
|
| resources 是此规则应用到的资源列表。" 表示指定 apiGroups 中的所有资源。"/foo" 代表指定 apiGroups 中所有资源的子资源 'foo'。 |
|
| verb 是 kubernetes resource API 动词列表,例如 get, list, watch, create, update, delete, proxy. " the all"。 |
6.12.2. API 端点 复制链接链接已复制到粘贴板!
可用的 API 端点如下:
/apis/authorization.k8s.io/v1/selfsubjectrulesreviews
-
POST
:创建一个 SelfSubjectRulesReview
-
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
POST
- 描述
- 创建 SelfSubjectRulesReview
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
201 - Created | |
202 - Accepted | |
401 - Unauthorized | 空 |