RoleBinding

RoleBinding 引用了一个角色，但不包含该角色。

apiVersion: rbac.authorization.k8s.io/v1

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

RoleBinding

RoleBinding 引用了一个角色，但不包含该角色。它可以引用同一命名空间中的 Role 或全局命名空间中的 ClusterRole。它通过 Subjects 添加了 who 信息，并通过其存在的命名空间添加了命名空间信息。给定命名空间中的 RoleBindings 仅在该命名空间中生效。

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

  • kind: RoleBinding

  • metadata (ObjectMeta)

    标准对象的元数据。

  • roleRef (RoleRef), 必需

    RoleRef 可以引用当前命名空间中的 Role 或全局命名空间中的 ClusterRole。如果无法解析 RoleRef，则授权者必须返回错误。此字段是不可变的。

    RoleRef 包含指向正在使用的角色的信息

    • roleRef.apiGroup (字符串), 必需

      APIGroup 是被引用资源的组

    • roleRef.kind (字符串), 必需

      Kind 是被引用资源的类型

    • roleRef.name (字符串), 必需

      Name 是被引用资源的名称

  • subjects ([]Subject)

    原子操作：在合并期间将被替换

    Subjects 保存角色应用到的对象的引用。

    Subject 包含对角色绑定应用到的对象或用户身份的引用。这可以保存直接 API 对象引用，也可以保存非对象的值，例如用户和组名称。

    • subjects.kind (字符串), 必需

      被引用对象的类型。此 API 组定义的值为“User”、“Group”和“ServiceAccount”。如果授权者无法识别类型值，则授权者应报告错误。

    • subjects.name (字符串), 必需

      被引用对象的名称。

    • subjects.apiGroup (字符串)

      APIGroup 保存被引用主题的 API 组。对于 ServiceAccount 主题，默认为 ""。对于 User 和 Group 主题，默认为 "rbac.authorization.k8s.io"。

    • subjects.namespace (字符串)

      被引用对象的命名空间。如果对象类型是非命名空间的，例如“User”或“Group”，并且此值不为空，则授权者应报告错误。

RoleBindingList

RoleBindingList 是 RoleBindings 的集合

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

  • kind: RoleBindingList

  • metadata (ListMeta)

    标准对象的元数据。

  • items ([]RoleBinding), 必需

    Items 是 RoleBindings 的列表

操作

get 读取指定的 RoleBinding

HTTP 请求

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

参数

  • name (在路径中): 字符串, 必需

    RoleBinding 的名称

  • namespace (在路径中): 字符串, 必需

    命名空间

  • pretty (在查询中): 字符串

    pretty

响应

200 (RoleBinding): OK

401: 未授权

list 列出或监视 RoleBinding 类型的对象

HTTP 请求

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

参数

响应

200 (RoleBindingList): OK

401: 未授权

list 列出或监视 RoleBinding 类型的对象

HTTP 请求

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

参数

响应

200 (RoleBindingList): OK

401: 未授权

create 创建一个 RoleBinding

HTTP 请求

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

参数

响应

200 (RoleBinding): OK

201 (RoleBinding): 已创建

202 (RoleBinding): 已接受

401: 未授权

update 替换指定的 RoleBinding

HTTP 请求

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

参数

  • name (在路径中): 字符串, 必需

    RoleBinding 的名称

  • namespace (在路径中): 字符串, 必需

    命名空间

  • body: RoleBinding, 必需

  • dryRun (在查询中): 字符串

    dryRun

  • fieldManager (在查询中): 字符串

    fieldManager

  • fieldValidation (在查询中): 字符串

    fieldValidation

  • pretty (在查询中): 字符串

    pretty

响应

200 (RoleBinding): OK

201 (RoleBinding): 已创建

401: 未授权

patch 部分更新指定的 RoleBinding

HTTP 请求

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

参数

  • name (在路径中): 字符串, 必需

    RoleBinding 的名称

  • namespace (在路径中): 字符串, 必需

    命名空间

  • body: Patch, 必需

  • dryRun (在查询中): 字符串

    dryRun

  • fieldManager (在查询中): 字符串

    fieldManager

  • fieldValidation (在查询中): 字符串

    fieldValidation

  • force (在查询中): 布尔值

    force

  • pretty (在查询中): 字符串

    pretty

响应

200 (RoleBinding): OK

201 (RoleBinding): 已创建

401: 未授权

delete 删除一个 RoleBinding

HTTP 请求

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

参数

响应

200 (Status): OK

202 (Status): 已接受

401: 未授权

deletecollection 删除 RoleBinding 的集合

HTTP 请求

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

参数

响应

200 (Status): OK

401: 未授权

此页面是自动生成的。

如果您计划报告此页面的问题，请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间为太平洋标准时间 2024 年 8 月 28 日下午 6:01：更新 v1.31 的生成的 API 参考 (8ba98c79c1)