RBAC相关接口
更新时间：2025-08-21
授权
描述
给指定用户授权集群的 RBAC 权限
请求结构
Plain Text
1POST /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| clusterID | String | 是 | RequestBody 参数 | 待授权的集群 ID。特殊值 all，表示授权所有已有集群。 |
| userID | String | 是 | RequestBody 参数 | 待授权的用户 ID。 |
| namespace | String | 否 | RequestBody 参数 | 待授权的命名空间。仅当 clusterID 不为空或 all 时有用。特殊值 all 和 ""，表示授权所有命名空间。 |
| role | String | 是 | RequestBody 参数 | 授予的 RBAC 角色，取值：
|
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| data | List<CreateRBACMessage> | 是 | 每个集群的授权结果 |
| requestID | String | 是 | 请求 ID，问题定位提供该 ID |
CreateRBACMessage
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| success | Boolean | 是 | 是否成功 |
| clusterID | String | 是 | 集群 ID |
| message | String | 否 | 失败时的提示信息 |
请求示例: 授权所有已有集群
clusterID设为all- 无需设置
namespace参数 - 其它参数参考 API 文档按需设置
Plain Text
1POST /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "clusterID": "all",
7 "userID": "60a039xxxxxxxxxxxxxxxx",
8 "role": "cce:readonly"
9}请求示例: 授权指定集群所有命名空间
clusterID设为指定集群 IDnamespace设为all- 其它参数参考 API 文档按需设置
Plain Text
1POST /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "clusterID": "cce-xxxxxxx",
7 "userID": "60a039xxxxxxxxxxxxxxxx",
8 "namespace": "all",
9 "role": "cce:devops"
10}请求示例: 授权指定集群指定命名空间
clusterID设为指定集群 IDnamespace设为指定命名空间- 其它参数参考 API 文档按需设置
Plain Text
1POST /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "clusterID": "cce-xxxxxxx",
7 "userID": "60a039xxxxxxxxxxxxxxxx",
8 "namespace": "default",
9 "role": "cce:admin"
10}返回示例
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: d2ce8f50-529a-4663-9265-ad08c94633c8
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5{
6 "requestID": "d2ce8f50-529a-4663-9265-ad08c94633c8",
7 "data": [
8 {
9 "success": true,
10 "clusterID": "cce-6m8tij7z"
11 }
12 ]
13}RBAC 列表
描述
查询用户的 RBAC 列表
请求结构
Plain Text
1GET /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| userID | String | 是 | Query 参数 | 用户 ID |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 | 描述 |
|---|---|---|---|
| data | List<GetRBACMessage> | 是 | RBAC 查询结果 |
| requestID | String | 是 | 请求 ID, 问题定位提供该 ID |
GetRBACMessage
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| role | String | 是 | RBAC 角色 |
| clusterID | String | 是 | 集群 ID |
| namespace | String | 是 | 命名空间，特殊取值 all |
| clusterName | String | 否 | 集群名字 |
请求示例
Plain Text
1GET /v2/rbac?userID=60a039xxxxxxxxxxxxxxxx HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de返回示例
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 97342dc7-29a1-4ed9-a75d-904bb293d295
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7 "requestID": "97342dc7-29a1-4ed9-a75d-904bb293d295",
8 "data": [{
9 "role": "cce:readonly",
10 "clusterID": "cce-aaaaaa",
11 "namespace": "all",
12 "clusterName": "test-resource"
13 },
14 {
15 "role": "cce:readonly",
16 "clusterID": "cce-bbbbbb",
17 "namespace": "test-ns",
18 "clusterName": "test04"
19 }
20 ]
21}删除 RBAC 权限
描述
删除用户的 RBAC 权限
请求结构
Plain Text
1DELETE /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| clusterID | String | 是 | RequestBody 参数 | 集群 ID，必须是具体的集群 ID，不能是 all。 |
| userID | String | 是 | RequestBody 参数 | 用户 ID |
| namespace | String | 是 | RequestBody 参数 | 命名空间，需跟授权时保持一致，如果授权时是 all，则必须也是 all。 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| requestID | String | 是 | 请求 ID, 问题定位提供该 ID |
请求示例
Plain Text
1DELETE /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "clusterID": "cce-xxxxxxx",
7 "userID": "60a039xxxxxxxxxxxxxxxx",
8 "namespace": "default"
9}返回示例
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 928a21b5-d117-4a83-a274-fd7d6f413524
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7 "requestID": "928a21b5-d117-4a83-a274-fd7d6f413524"
8}重置 RBAC Kubeconfig
描述
失效用户旧的 RBAC Kubeconfig，生成新的 Kubeconfig。注意：执行该方法后，旧的 RBAC Kubeconfig 不可用。
请求结构
Plain Text
1PUT /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| clusterID | String | 是 | RequestBody 参数 | 集群 ID，必须是具体的集群 ID，不能是 all。 |
| userID | String | 否 | RequestBody 参数 | 用户 ID，未填写时表示当前用户 |
| namespace | String | 是 | RequestBody 参数 | 命名空间，需跟授权时保持一致，如果授权时是 all，则必须也是 all。 |
| role | String | 是 | RequestBody 参数 | 角色，需跟授权时保持一致。 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| requestID | String | 是 | 请求 ID, 问题定位提供该 ID |
请求示例
Plain Text
1PUT /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de返回示例
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: 105ce04b-1a42-4f77-9d22-ab6f413f9d69
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5
6{
7 "requestID": "105ce04b-1a42-4f77-9d22-ab6f413f9d69"
8}申请临时访问凭证
描述
申请指定集群的临时凭证，可指定凭证生效时间
请求结构
Plain Text
1POST /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| clusterID | String | 是 | RequestBody 参数 | 待授权的集群 ID。特殊值 all，表示授权所有已有集群。 |
| temp | Boolean | 是 | RequestBody 参数 | 必须是 true，说明需要申请临时访问凭证。 |
| expireHours | Integer | 是 | RequestBody 参数 | 临时凭证生效时间，单位是小时 |
| kubeConfigType | String | 是 | RequestBody 参数 | 临时凭证的类型，取值：
|
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| temporaryKubeConfig | String | 是 | 临时凭证 Kubeconfig |
| requestID | String | 是 | 请求 ID，问题定位提供该 ID |
请求示例: 申请 7天的 vpc 临时访问凭证
Plain Text
1POST /v2/rbac HTTP/1.1
2Host: cce.bj.baidubce.com
3Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2019-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
4
5{
6 "clusterID": "cce-xxxx",
7 "temp": true,
8 "expireHours": 168,
9 "kubeConfigType": "vpc"
10}返回示例
Plain Text
1HTTP/1.1 200 OK
2X-Bce-Request-Id: d2ce8f50-529a-4663-9265-ad08c94633c8
3Date: Thu, 16 Mar 2020 06:29:48 GMT
4Content-Type: application/json;charset=UTF-8
5{
6 "requestID": "d2ce8f50-529a-4663-9265-ad08c94633c8",
7 "temporaryKubeConfig": "apiVersion: v1\nclusters:\n- cluster:\n certificate-authority-data: xxxx......"
8}