机器人账户接口
更新时间：2025-09-25
使用前提
- 已成功创建企业版实例。
获取机器人账号列表
接口描述
获取当前实例的机器人账号列表。
请求结构
Plain Text
1GET /v1/instances/{instanceId}/robots?status={status}&pageNo={pageNo}&pageSize={pageSize} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| status | String | 否 | Query参数 | 状态筛选字段，可选值enabled：启用,disabled：禁用 |
| pageNo | Integer | 否 | Query参数 | 当前页 |
| pageSize | Integer | 否 | Query参数 | 每页记录数，默认为10，最大100 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| pageNo | Integer | 当前页 |
| pageSize | Integer | 每页记录数 |
| total | Integer | 实例机器人账号总数 |
| robots | List<Robot> | 机器人账号列表 |
请求示例
Plain Text
1GET /v1/instances/instances-test/robots HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2025-09-23T03:05:45Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Thu, 23 Sep 2025 03:05:46 GMT
4X-Bce-Gateway-Region: BD
5X-Bce-Request-Id: b679248a-1004-42aa-b4a5-92be2952a1b8
6
7{
8 "total": 2,
9 "pageNo": 1,
10 "pageSize": 10,
11 "robots": [
12 {
13 "creationTime": "2025-09-23T14:34:20.441Z",
14 "description": "test",
15 "disable": false,
16 "duration": 30,
17 "editable": false,
18 "expiresAt": 1761230060,
19 "id": 2710,
20 "level": "system",
21 "name": "ccr$test-robot",
22 "permissions": [
23 {
24 "access": [
25 {
26 "action": "pull",
27 "resource": "repository"
28 }
29 ],
30 "kind": "project",
31 "namespace": "niukl"
32 }
33 ],
34 "updateTime": "2025-09-23T14:34:20.441Z"
35 },
36 {
37 "creationTime": "2025-09-23T14:33:32.807Z",
38 "description": "测试机器人",
39 "disable": false,
40 "duration": 30,
41 "editable": false,
42 "expiresAt": 1761230012,
43 "id": 2709,
44 "level": "system",
45 "name": "ccr$test2",
46 "permissions": [
47 {
48 "access": [
49 {
50 "action": "pull",
51 "resource": "repository"
52 }
53 ],
54 "kind": "project",
55 "namespace": "cce-public"
56 },
57 {
58 "access": [
59 {
60 "action": "pull",
61 "resource": "repository"
62 },
63 {
64 "action": "push",
65 "resource": "repository"
66 }
67 ],
68 "kind": "project",
69 "namespace": "cce-test"
70 },
71 {
72 "access": [
73 {
74 "action": "pull",
75 "resource": "repository"
76 }
77 ],
78 "kind": "project",
79 "namespace": "demo1"
80 }
81 ],
82 "updateTime": "2025-09-23T14:33:32.807Z"
83 }
84 ]
85}创建机器人账号
接口描述
创建机器人账号，根据用户提交参数创建机器人账号。
注意：创建请求后请根据返回结果保存用户名及密码，密码仅在创建返回响应体可以获取，无法再次找回密码，如果忘记密码请重置秘钥。
请求结构
Plain Text
1POST /v1/instances/{instanceId}/robots HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string
4
5{
6 "name": {name},
7 "secret": {secret},
8 "disable": {disable},
9 "duration": {duration},
10 "description": {description},
11 "permissions": [
12 {
13 "access": [
14 {
15 "action": {action},
16 "resource": {resource}
17 }
18 ],
19 "kind": {kind},
20 "namespace": {namespace}
21 }
22 ]
23}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | CCR实例ID |
| name | String | 是 | Body参数 | 机器人账号名称。注意：创建成功后的机器人账号会自动加上前缀ccr$，如填写 test，则实际使用的用户名为：ccr$test。长度限制在1~65之间，必须以小写字母或数字开头和结尾，支持小写字母、数字及特殊字符._-，但特殊字符不可连续 |
| secret | String | 否 | Body参数 | 账号密码，如果不填则由系统自动生成。 长度8~65，必须包含大、小写字母、数字或特殊字符，特殊字符允许!@#$%^*() |
| disable | Boolean | 否 | Body参数 | 是否禁用，默认是false |
| duration | Integer | 是 | Body参数 | 账号有效期，单位：天，-1表示永不过期 |
| description | String | 否 | Body参数 | 账号描述，长度0~1024个字符 |
| permissions | List<Robot.Permission> | 是 | Body参数 | 权限 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Integer | 机器人账号ID |
| name | String | 账号名称 |
| secret | String | 账号密码 |
| creationTime | String | 创建时间 |
| expiresAt | Integer | 过期时间 Unix 时间戳，-1表示永不过期 |
请求示例
Plain Text
1POST /v1/instances/instances-test/projects HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2025-09-23T03:16:14Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6
4
5
6{
7"name": "test02",
8"duration": 7,
9"secret":"mypassword@123A",
10"description":"test02 desc",
11"permissions":[
12 {
13 "access": [
14 {
15 "action": "pull",
16 "resource": "repository"
17 },
18 {
19 "action": "push",
20 "resource": "repository"
21 }
22 ],
23 "kind": "project",
24 "namespace": "ns1"
25 },
26 {
27 "access": [
28 {
29 "action": "pull",
30 "resource": "repository"
31 }
32 ],
33 "kind": "project",
34 "namespace": "ns2"
35 }
36
37]}
响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Thu, 23 Sep 2025 03:05:46 GMT
4X-Bce-Gateway-Region: BD
5X-Bce-Request-Id: 4ad94983-4dbb-44e8-832e-a8ec8b5c3aec
6
7{
8 "creationTime": "2025-09-23T13:41:13.244Z",
9 "expiresAt": 1759326073,
10 "id": 2715,
11 "name": "ccr$test02",
12 "secret": "mypassword@123A"
13}更新机器人账号
接口描述
更新机器人账号。
请求结构
Plain Text
1PUT /v1/instances/{instanceId}/robots/{robotID} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string
4
5{
6 "disable": {disable},
7 "duration": {duration},
8 "description": {description},
9 "permissions": [
10 {
11 "access": [
12 {
13 "action": {action},
14 "resource": {resource}
15 }
16 ],
17 "kind": {kind},
18 "namespace": {namespace}
19 }
20 ]
21}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| robotID | String | 是 | Path参数 | 机器人账号ID |
| disable | Boolean | 否 | Body参数 | 是否禁用，默认是false |
| duration | Integer | 否 | Body参数 | 账号有效期，单位：天，-1表示永不过期 |
| description | String | 否 | Body参数 | 账号描述，长度0~1024个字符 |
| permissions | List<Robot.Permission> | 否 | Body参数 | 权限 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
无额外响应参数
请求示例
Plain Text
1PUT /v1/instances/instances-test/robots/2715 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2025-09-23T03:23:34Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6
4
5{
6 "disable": false,
7 "duration": 22,
8 "description":"test02 desc-update",
9 "permissions":[
10 {
11 "access": [
12 {
13 "action": "pull",
14 "resource": "repository"
15 },
16 {
17 "action": "push",
18 "resource": "repository"
19 }
20 ],
21 "kind": "project",
22 "namespace": "ns1"
23 },
24 {
25 "access": [
26 {
27 "action": "pull",
28 "resource": "repository"
29 }
30 ],
31 "kind": "project",
32 "namespace": "ns2"
33 }
34
35 ]
36
37}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Thu, 23 Sep 2025 03:05:46 GMT
4X-Bce-Gateway-Region: BD
5X-Bce-Request-Id: df959f0d-a7c4-48b4-9dfe-f77fb9802e90
6
7{}删除机器人账号
接口描述
删除机器人账号。
请求结构
Plain Text
1DELETE /v1/instances/{instanceId}/robots/{robotID} HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| robotID | String | 是 | Path参数 | 机器人账号ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
如果请求成功无响应参数。如果请求失败则返回标准错误结构。
请求示例
Plain Text
1DELETE /v1/instances/instances-test/robots/2715 HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2025-09-23T03:25:41Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6响应示例
Plain Text
1Content-Type: application/json; charset=utf-8
2Date: Thu, 23 Sep 2025 03:05:46 GMT
3X-Bce-Gateway-Region: BD
4X-Bce-Request-Id: b42840ec-a200-49c9-86bd-58687b7009bb刷新机器人账号秘钥
接口描述
刷新机器人账号秘钥。
请求结构
Plain Text
1PUT /v1/instances/{instanceId}/robots/{robotID}/secret HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: authorization string
4
5{
6 "secret": {secret}
7}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必选 | 参数位置 | 描述 |
|---|---|---|---|---|
| instanceId | String | 是 | Path参数 | 实例ID |
| robotID | String | 是 | Path参数 | 机器人账号ID |
| secret | String | 否 | Body参数 | 新密码，如果不填则由系统自动生成。 长度8~65，必须包含大、小写字母、数字或特殊字符，特殊字符允许!@#$%^*() |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| secret | String | 账号密码 |
请求示例
Plain Text
1PUT /v1/instances/instances-test/robots/2715/secret HTTP/1.1
2Host: ccr.bd.baidubce.com
3Authorization: bce-auth-v1/123456/2025-09-23T03:19:27Z/1800/host/0a859ce949951fe15a4eb6874a9765f9e8a6f7147f206cf47e270c34c862b8c6
4
5{
6 "secret": ""
7}响应示例
Plain Text
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Thu, 23 Sep 2025 03:05:46 GMT
4X-Bce-Gateway-Region: BD
5X-Bce-Request-Id: 6a169a3e-c6ec-42dd-8522-43092cb84c5c
6
7
8{
9 "secret": "HRFlZDYv4HTBqHwsJLyCkDz"
10}