CreateRobotAccount--镜像仓库-火山引擎

文档中心

立即注册

导航

CreateRobotAccount

最近更新时间：2025.06.09 14:36:47首次发布时间：2025.06.09 14:36:47

创建机器人账户。

请求说明

请求方式：POST
请求地址：https://open.volcengineapi.com?Action=CreateRobotAccount&Version=2022-05-12

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

调用该 API 时，除了以下请求参数外，还需传入公共请求参数。公共请求参数说明，请参见火山引擎公共参数文档。

参数	类型	是否必选	示例值	描述
Action	String	是	CreateRobotAccount	接口名称。当前 API 的名称为 `CreateRobotAccount`。
Version	String	是	2022-05-12	接口版本。当前 API 的版本为 `2022-05-12`。
Registry	String	是	registrya	机器人账户所在的实例名。
Username	String	是	crrobot@username1	机器人账户的名称，格式为 `crrobot@****`。
Password	String	否	yourpassword	登录机器人账户的密码，不填时生成随机密码。
Description	String	否	用于cicd	机器人账户的描述。
Duration	Long	是	-1	生效的时长，单位为天，上限为 366。无限期填 `-1`。
Permissions	Array of Permission	是	[{"Resource":"*","Actions":"CreateRepository"]	机器人账号权限范围。

Permission

参数	类型	是否必选	示例值	描述
Actions	Array of String	是	PushRepository	支持的操作权限： CreateRepository：创建镜像仓库。 PullRepository：拉取镜像。 PushRepository：推送镜像。
Resource	String	是	*	操作的资源对象。

参数

类型

是否必选

示例值

描述

Actions

Array of String

是

PushRepository

支持的操作权限：

CreateRepository：创建镜像仓库。
PullRepository：拉取镜像。
PushRepository：推送镜像。

Resource

String

是

操作的资源对象。

请求示例

POST https://open.volcengineapi.com?Action=CreateRobotAccount&Version=2022-05-12
{
    "Registry": "registrya",
    "Username": "crrobot@username1",
    "Duration": -1,
    "Permissions": [
        {
            "Resource": "*",
            "Actions": [
                "PullRepository"
            ]
        }
    ]
}

返回参数

参数	类型	示例值	描述
Username	String	crrobot@username1	机器人账户的名称。
Password	String	password1	登录机器人账号的密码。

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "CreateRobotAccount",
        "Version": "2022-05-12",
        "Service": "cr",
        "Region": "cn-north-1"
    },
    "Result": {
        "Username": "crrobot@username1",
        "Password": "password1"
    }
}

错误码

本接口无特有错误码，公共错误码请参见公共错误码。