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

文档中心

立即注册

导航

ListRobotAccounts

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

列举机器人账户。

请求说明

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

调试

API Explorer

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

去调试

请求参数

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

参数	类型	是否必选	示例值	描述
Action	String	是	ListRobotAccounts	接口名称。当前 API 的名称为 `ListRobotAccounts`。
Version	String	是	2022-05-12	接口版本。当前 API 的版本为 `2022-05-12`。
Registry	String	是	registrya	机器人账号所在的实例名。
Filter	Object of RobotAccountFilter	否		机器人账户搜索过滤器。
PageNumber	Long	否	2	页码，从 1 开始，默认为 1。
PageSize	Long	否	10	单页大小。

RobotAccountFilter

参数	类型	是否必选	示例值	描述
Disabled	Boolean	否	true	是否禁用。
Usernames	Array of String	否	["crrobot@usernam1","crrobot@username2"]	用户名过滤器。支持通过 * 模糊匹配。
Descriptions	Array of String	否	["description"]	用户名描述过滤器。支持通过 * 模糊匹配。

请求示例

POST https://open.volcengineapi.com?Action=ListRobotAccounts&Version=2022-05-12
{
    "Registry": "registrya"
}

返回参数

参数	类型	示例值	描述
TotalCount	Long	20	列举的机器人账号的总数。
PageNumber	Long	2	页数。
PageSize	Long	10	单页大小。
Items	Array of RobotAccount		机器人账户详细信息。

RobotAccount

参数	类型	示例值	描述
Disabled	Boolean	true	是否禁用。
Username	String	crrobot@username1	机器人账户的名称。
ExpiresAt	Long	-1	过期的时间戳。
CreateTime	String	2022-05-20T13:00:55Z	创建的时间戳。
UpdateTime	String	2022-05-20T13:00:55Z	更新的时间戳。
Description	String	descriptionxxxxx	机器人账户的描述。
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

操作的资源对象。

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230604110420****100232280022D31",
        "Action": "ListRobotAccounts",
        "Version": "2022-05-12",
        "Service": "cr",
        "Region": "cn-north-1"
    },
    "Result": {
        "TotalCount": 1,
        "PageNumber": 1,
        "PageSize": 10,
        "Items": [
            {
                "Disabled": true,
                "Username": "crrobot@username1",
                "ExpiresAt": -1,
                "CreateTime": "2022-05-20T13:00:55Z",
                "UpdateTime": "2022-05-20T13:00:55Z",
                "Description": "descriptionxxxxx",
                "Permissions": [
                    {
                        "Actions": [
                            ""
                        ],
                        "Resource": "*"
                    }
                ]
            }
        ]
    }
}

错误码

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