查询镜像仓库列表
更新时间 2026-10-20 09:40:40
最近更新时间: 2026-10-20 09:40:40
接口功能介绍
查询镜像仓库列表
接口约束
无
URI
GET /v2/listRepository
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| instanceId | 是 | String | 实例ID | f04e47d9b48747958c9f4516cf1a8d82 | |
| namespaceName | 否 | String | 命名空间名称 | crs-ns1 | |
| repositoryName | 否 | String | 镜像仓库名称，支持模糊查询 | myrepo | |
| pageNum | 否 | Integer | 当前页码（默认为1） | 1 | |
| pageSize | 否 | Integer | 每页条数（默认为10,最大值为50） | 10 | |
| orderBy | 否 | String | 排序字段(namespaceName：命名空间名称，createdTime：创建时间，modifiedTime：修改时间，repositoryName：仓库名称，默认值：modifiedTime) | createdTime | |
| order | 否 | String | 排序方式(desc：降序排序，asc：升序排序，默认值：desc) | desc |
请求参数
请求头header参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| Content-Type | 是 | String | 类型 | application/json | |
| regionId | 是 | String | 资源池编码（资源池ID，您可以查看容器镜像服务资源池获取） | bb9fdb42056f11eda1610242ac110002 |
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 响应码 （800为请求成功，900为失败 ） | 800 | |
| message | String | 返回信息 | ||
| error | String | 错误码 | ||
| returnObj | Object | 返回结果 | returnObj |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| total | Integer | 总条数 | 5 | |
| size | Integer | 每页条数 | 10 | |
| current | Integer | 当前页码 | 1 | |
| pages | Integer | 总页数 | 1 | |
| records | Array of Objects | 镜像仓库列表 | record |
表 record
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| repositoryId | String | 镜像仓库ID | 9c7f70ae24dbdf535d81f6f94cc8fe01 | |
| namespaceName | String | 命名空间名称 | crs-ns1 | |
| repositoryName | String | 镜像仓库名称 | myrepo | |
| isPublic | Boolean | 镜像仓库是否为公开 | true | |
| accelerate | Boolean | 是否开启镜像加速，仅对企业版实例生效 | false | |
| regionId | String | 资源池编码 | bb9fdb42056f11eda1610242ac110002 | |
| description | String | 镜像仓库说明 | desc | |
| state | String | 资源状态：ACTIVE - 正常；DELETING - 删除中；DELETE_FAILED - 删除失败 | ACTIVE | |
| createdTime | String | 镜像仓库创建时间 | 2023-03-22 17:20:04 | |
| modifiedTime | String | 镜像仓库修改时间 | 2023-03-22 17:20:04 |
枚举参数
无
请求示例
请求url
GET https://crs-global.ctapi.ctyun.cn/v2/listRepository?instanceId=f04e47d9b48747958c9f4516cf1a8d82&pageNum=1&pageSize=10
请求头header
{
"Content-Type": "application/json",
"regionId": "bb9fdb42056f11eda1610242ac110002"
}
请求体body
无
响应示例
{
"statusCode": 800,
"message": "",
"returnObj": {
"records": [
{
"repositoryId": "9c7f70ae24dbdf535d81f6f94cc8fe01",
"repositoryName": "myrepo",
"namespaceName": "crs-ns1",
"isPublic": true,
"accelerate": false,
"regionId": "bb9fdb42056f11eda1610242ac110002",
"description": "test",
"state": "ACTIVE",
"createdTime": "2023-02-14 16:18:54",
"modifiedTime": "2023-02-14 16:18:54"
}
],
"total": 1,
"size": 10,
"current": 1,
"pages": 1
}
}
状态码
请参考 状态码
错误码
请参考 错误码
