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 组中的其中一个枚举资源来请求任何操作。 “” 表示核心 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

    响应

    401: Unauthorized

    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，必需

    • body: Role，必需

    • dryRun（查询参数）：string

    • fieldManager（查询参数）：string

      fieldManager

    • fieldValidation（查询参数）：string

    • pretty（查询参数）：string

      pretty

    响应

    200 (Role): OK

    201 (): Created

    401: Unauthorized

    patch 部分更新指定的 Role

    HTTP 请求

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

    参数

    • name（路径参数）：string，必需

    • 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，必需

      namespace

    • body:

    • dryRun（查询参数）：string

      dryRun

    • gracePeriodSeconds（查询参数）：integer

    • pretty（查询参数）：string

      pretty

    • propagationPolicy（查询参数）：string

    响应

    200 (): OK

    202 (Status): Accepted

    401: Unauthorized

    deletecollection 删除 Role 的集合

    HTTP 请求

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

    参数

    • namespace（路径参数）：string，必需

      namespace

    • body:

    • continue（查询参数）：string

      continue

    • dryRun（查询参数）：string

    • fieldSelector（查询参数）：string

      fieldSelector

    • gracePeriodSeconds（查询参数）：integer

    • labelSelector（查询参数）：string

      labelSelector

    • limit（查询参数）：integer

    • pretty（查询参数）：string

      pretty

    • propagationPolicy（查询参数）：string

    • resourceVersion（查询参数）：string

      resourceVersion

    • resourceVersionMatch（查询参数）：string

    • timeoutSeconds（查询参数）：integer

      timeoutSeconds

    响应

    401: Unauthorized