Role

    apiVersion: rbac.authorization.k8s.io/v1

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

    Role 是一个按命名空间划分的 PolicyRule 逻辑分组，可以被 RoleBinding 作为一个单元引用。

    • apiVersion: rbac.authorization.k8s.io/v1

    • kind: Role

    标准的对象元数据。

    • rules ([]PolicyRule)

      rules 包含了这个 Role 的所有 PolicyRule。

      PolicyRule 包含描述一个策略规则的信息，但不包含该规则适用于哪个主体或适用于哪个命名空间的信息。

      • rules.apiGroups ([]string)

        apiGroups 是包含资源的 apiGroup 的名称。 如果指定了多个 API 组，则允许对任何 API 组中的其中一个枚举资源来请求任何操作。

      • rules.resources ([]string)

        resources 是此规则所适用的资源的列表。 “*” 表示所有资源。

    • rules.verbs ([]string)，必需

      verbs 是适用于此规则中所包含的所有 ResourceKinds 的动作。 “*” 表示所有动作。

    • rules.resourceNames ([]string)

      resourceNames 是此规则所适用的资源名称白名单，可选。 空集合意味着允许所有资源。

    • rules.nonResourceURLs ([]string)

      nonResourceURLs 是用户应有权访问的一组部分 URL。 允许使用 “*”，但仅能作为路径中最后一段且必须用于完整的一段， 因为非资源 URL 没有划分命名空间。 此字段仅适用于从 ClusterRoleBinding 引用的 ClusterRole。 rules 可以应用到 API 资源（如 “pod” 或 “secret”）或非资源 URL 路径（如 “/api”）， 但不能同时应用于两者。

    RoleList 是 Role 的集合。

    • apiVersion: rbac.authorization.k8s.io/v1

    • kind: RoleList

    • metadata (ListMeta)

    标准的对象元数据。

    • items ([])，必需

      items 是 Role 的列表。

    HTTP 请求

    GET /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles/{name}

    参数

    • name (路径参数): string，必需

      Role 的名称

    • namespace (路径参数): string，必需

      namespace

    • pretty (查询参数): string

    响应

    200 (): OK

    401: Unauthorized

    list 列出或观测类别为 Role 的对象

    HTTP 请求

    GET /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles

    参数

    • namespace (路径参数): string，必需

    • allowWatchBookmarks (查询参数): boolean

      allowWatchBookmarks

    • continue (查询参数): string

    • fieldSelector (查询参数): string

      fieldSelector

    • labelSelector (查询参数): string

    • limit (查询参数): integer

      limit

    • pretty (查询参数): string

    • resourceVersion (查询参数): string

      resourceVersion

    • resourceVersionMatch (查询参数): string

    • timeoutSeconds (查询参数): integer

      timeoutSeconds

    • watch (查询参数): boolean

    响应

    200 (): OK

    HTTP 请求

    GET /apis/rbac.authorization.k8s.io/v1/roles

    参数

    • allowWatchBookmarks (查询参数): boolean

      allowWatchBookmarks

    • continue (查询参数): string

    • fieldSelector (查询参数): string

      fieldSelector

    • labelSelector (查询参数): string

    • limit (查询参数): integer

      limit

    • pretty (查询参数): string

    • resourceVersion (查询参数): string

      resourceVersion

    • resourceVersionMatch (查询参数): string

    • timeoutSeconds (查询参数): integer

      timeoutSeconds

    • watch (查询参数): boolean

    响应

    200 (): OK

    401: Unauthorized

    create 创建 Role

    HTTP 请求

    POST /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles

    参数

    • namespace (路径参数): string，必需

    • body: Role，必需

    • dryRun (查询参数): string

    • fieldValidation (查询参数): string

      fieldValidation

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (Role): Created

    202 (): Accepted

    401: Unauthorized

    HTTP 请求

    PUT /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles/{name}

    参数

    • name (路径参数): string，必需

      Role 的名称

    • namespace (路径参数): string，必需

      namespace

    • body: ，必需

    • dryRun (查询参数): string

      dryRun

    • fieldManager (查询参数): string

    • fieldValidation (查询参数): string

      fieldValidation

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (Role): Created

    401: Unauthorized

    patch 部分更新指定的 Role

    HTTP 请求

    PATCH /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles/{name}

    参数

    • name (路径参数): string，必需

      Role 的名称

    • namespace (路径参数): string，必需

    • body: Patch，必需

    • dryRun (查询参数): string

    • fieldManager (查询参数): string

      fieldManager

    • fieldValidation (查询参数): string

    • force (查询参数): boolean

      force

    • pretty (查询参数): string

    响应

    200 (): OK

    201 (Role): Created

    401: Unauthorized

    HTTP 请求

    DELETE /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles/{name}

    参数

    • name (路径参数): string，必需

      Role 的名称

    • namespace (路径参数): string，必需

    • body: DeleteOptions

    • dryRun (查询参数): string

    • gracePeriodSeconds (查询参数): integer

      gracePeriodSeconds

    • pretty (查询参数): string

    • propagationPolicy (查询参数): string

      propagationPolicy

    响应

    200 (Status): OK

    202 (): Accepted

    401: Unauthorized

    deletecollection 删除 Role 的集合

    HTTP 请求

    DELETE /apis/rbac.authorization.k8s.io/v1/namespaces/{namespace}/roles

    参数

    • namespace (路径参数): string，必需

    • body: DeleteOptions

    • continue (查询参数): string

    • dryRun (查询参数): string

      dryRun

    • fieldSelector (查询参数): string

    • gracePeriodSeconds (查询参数): integer

      gracePeriodSeconds

    • labelSelector (查询参数): string

    • limit (查询参数): integer

      limit

    • pretty (查询参数): string

    • propagationPolicy (查询参数): string

      propagationPolicy

    • resourceVersion (查询参数): string

    • resourceVersionMatch (查询参数): string

      resourceVersionMatch

    • timeoutSeconds (查询参数): integer

    响应

    200 (): OK

    401: Unauthorized