列举机器人账户。 ## 请求说明为获得低延迟，建议您根据资源所在的地域选择对应的服务地址，详情参见 [服务地址](https://www.volcengine.com/docs/6420/1584339)。 * 请求方式：POST * 请求地址：https://cr.cn\-beijing.volcengineapi.com?Action=ListRobotAccounts&Version=2022\-05\-12 ## 调试 ## 请求参数调用该 API 时，除了以下请求参数外，还需传入公共请求参数。公共请求参数说明，请参见 [火山引擎公共参数文档](https://www.volcengine.com/docs/6369/67268)。 |**参数** |**类型** |**是否必选** |**示例值** |**描述** | |---|---|---|---|---| |Action |String |是 |ListRobotAccounts |接口名称。当前 API 的名称为 `ListRobotAccounts`。 | |Version |String |是 |2022\-05\-12 |接口版本。当前 API 的版本为 `2022-05-12`。 | |Registry |String |是 |registrya |机器人账号所在的实例名。 | |Filter |Object of [RobotAccountFilter](#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*"] |用户名描述过滤器。支持通过 \* 模糊匹配。 | ## 请求示例 ```json POST https://cr.cn-beijing.volcengineapi.com?Action=ListRobotAccounts&Version=2022-05-12 { "Registry": "registrya" } ``` ## 返回参数 |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |TotalCount |Long |20 |列举的机器人账号的总数。 | |PageNumber |Long |2 |页数。 | |PageSize |Long |10 |单页大小。 | |Items |Array of [RobotAccount](#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](#permission) |[{"Resource":"\*","Actions":"CreateRepository"] |机器人账户的操作权限。 | ### Permission |**参数** |**类型** |**示例值** |**描述** | |---|---|---|---| |Actions |Array of String |PushRepository |支持的操作权限：|\ | | | ||\ | | | |* CreateRepository：创建镜像仓库。|\ | | | |* PullRepository：拉取镜像。|\ | | | |* PushRepository：推送镜像。 | |Resource |String |* |操作的资源对象。 | ## 返回示例 ```json { "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": "*" } ] } ] } } ``` ## 错误码本接口无特有错误码，公共错误码请参见 [公共错误码](https://www.volcengine.com/docs/6420/79348)。