SelfSubjectRulesReview

apiVersion: authorization.k8s.io/v1

import "k8s.io/api/authorization/v1"

SelfSubjectRulesReview

SelfSubjectRulesReview 枚举当前用户可以在命名空间内执行的操作集。返回的操作列表可能不完整，具体取决于服务器的授权模式以及评估期间遇到的任何错误。SelfSubjectRulesReview 应由 UI 使用以显示/隐藏操作，或让最终用户快速了解其权限。它不应由外部系统用来驱动授权决策，因为这会引发混乱的代理、缓存生存期/撤销和正确性问题。SubjectAccessReview 和 LocalAccessReview 是将授权决策推迟到 API 服务器的正确方法。

• apiVersion: authorization.k8s.io/v1

• kind: SelfSubjectRulesReview

• metadata (ObjectMeta)

  标准列表元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

• spec (SelfSubjectRulesReviewSpec), 必需

  Spec 包含有关正在评估的请求的信息。

• status (SubjectRulesReviewStatus)

  Status 由服务器填充，并指示用户可以执行的操作集。

  SubjectRulesReviewStatus 包含规则检查的结果。此检查可能不完整，具体取决于服务器配置的授权器集以及评估期间遇到的任何错误。因为授权规则是累加的，所以如果规则出现在列表中，则可以安全地假设主体具有该权限，即使该列表不完整。

  • status.incomplete (布尔值), 必需

    当此调用返回的规则不完整时，Incomplete 为 true。当授权器（例如外部授权器）不支持规则评估时，通常会遇到这种情况。

  • status.nonResourceRules ([]NonResourceRule), 必需

    NonResourceRules 是主体允许对非资源执行的操作列表。列表顺序无关紧要，可能包含重复项，并且可能不完整。

    NonResourceRule 包含描述非资源规则的信息

    • status.nonResourceRules.verbs ([]string), 必需

      Verb 是 Kubernetes 非资源 API 动词列表，例如：get、post、put、delete、patch、head、options。“*”表示所有。

    • status.nonResourceRules.nonResourceURLs ([]string)

      NonResourceURLs 是一组用户应该有权访问的部分 URL。s 是允许的，但只能作为路径中的完整最终步骤。“”表示所有。

  • status.resourceRules ([]ResourceRule), 必需

    ResourceRules 是主体允许对资源执行的操作列表。列表顺序无关紧要，可能包含重复项，并且可能不完整。

    ResourceRule 是主体允许对资源执行的操作列表。列表顺序无关紧要，可能包含重复项，并且可能不完整。

    • status.resourceRules.verbs ([]string), 必需

      Verb 是 Kubernetes 资源 API 动词列表，例如：get、list、watch、create、update、delete、proxy。“*”表示所有。

    • status.resourceRules.apiGroups ([]string)

      APIGroups 是包含资源的 APIGroup 的名称。如果指定了多个 API 组，则允许针对任何 API 组中枚举的任何资源请求的任何操作。“*”表示所有。

    • status.resourceRules.resourceNames ([]string)

      ResourceNames 是规则适用的可选白名单。空集表示允许所有内容。“*”表示所有。

    • status.resourceRules.resources ([]string)

      Resources 是此规则适用的资源列表。“”表示指定 apiGroups 中的所有资源。“/foo”表示指定 apiGroups 中所有资源的子资源“foo”。

  • status.evaluationError (string)

    EvaluationError 可以与 Rules 一起出现。它表示在规则评估期间发生错误，例如不支持规则评估的授权器，并且 ResourceRules 和/或 NonResourceRules 可能不完整。

SelfSubjectRulesReviewSpec

SelfSubjectRulesReviewSpec 定义 SelfSubjectRulesReview 的规范。

• namespace (string)

  要评估规则的命名空间。必需。

操作

create 创建 SelfSubjectRulesReview

HTTP 请求

POST /apis/authorization.k8s.io/v1/selfsubjectrulesreviews

参数

• body: SelfSubjectRulesReview, 必需

• dryRun (在查询中): string

  dryRun

• fieldManager (在查询中): string

  fieldManager

• fieldValidation (在查询中): string

  fieldValidation

• pretty (在查询中): string

  pretty

响应

200 (SelfSubjectRulesReview): 正常

201 (SelfSubjectRulesReview): 已创建

202 (SelfSubjectRulesReview): 已接受

401: 未授权