创建机器人账号
更新时间：2026-06-09
接口描述
创建机器人账号，根据用户提交参数创建机器人账号。
注意：创建请求后请根据返回结果保存用户名及密码，密码仅在创建返回响应体可以获取，无法再次找回密码，如果忘记密码请重置秘钥。
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
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 | 是 | URL参数 | 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<RobotPermission> | 是 | Body参数 | 权限 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | Integer | 机器人账号ID |
| name | String | 账号名称 |
| secret | String | 账号密码 |
| creationTime | String | 创建时间 |
| expiresAt | Integer | 过期时间 Unix 时间戳，-1表示永不过期 |
请求示例
Plain Text
1POST /v1/instances/ccr-4k74gw7d/robots 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}评价此篇文章