查询镜像命名空间列表
更新时间 2026-10-20 09:41:36
最近更新时间: 2026-10-20 09:41:36
接口功能介绍
查询镜像命名空间列表
接口约束
无
URI
GET /v2/listNamespace
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| instanceId | 是 | String | 实例ID | f04e47d9b48747958c9f4516cf1a8d82 | |
| namespaceName | 否 | String | 命名空间名称，支持模糊搜索 | crs-ns1 | |
| pageNum | 否 | Integer | 当前页码（默认为1） | 1 | |
| pageSize | 否 | Integer | 每页条数（默认为10,最大值为50） | 10 | |
| orderBy | 否 | String | 排序字段(namespaceName：命名空间名称，createdTime：创建时间，modifiedTime：修改时间，默认值：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
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| namespaceId | String | 命名空间ID | f5b49578426e6da458fb9aba36d8cfdb | |
| namespaceName | String | 命名空间名称 | crs-ns1 | |
| createRepoAuto | Boolean | 是否允许直接通过推送镜像创建仓库 | false | |
| defaultRepoPublic | Boolean | 直接通过推送镜像创建的仓库类型 | false | |
| repositoryCount | Integer | 仓库数目 | 0 | |
| accelerate | Boolean | 是否开启镜像加速，仅对企业版实例生效 | false | |
| 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/listNamespace?instanceId=f04e47d9b48747958c9f4516cf1a8d82&pageNum=1&pageSize=10
请求头header
{
"Content-Type": "application/json",
"regionId": "bb9fdb42056f11eda1610242ac110002"
}
请求体body
无
响应示例
{
"statusCode": 800,
"message": "",
"returnObj": {
"records": [
{
"namespaceId": "f5b49578426e6da458fb9aba36d8cfdb",
"namespaceName": "crs-ns1",
"createRepoAuto": false,
"defaultRepoPublic": false,
"repositoryCount": 0,
"accelerate": true,
"state": "ACTIVE",
"createdTime": "2023-06-16 22:16:57",
"modifiedTime": "2023-06-16 22:16:57"
}
],
"total": 1,
"size": 10,
"current": 1,
"pages": 1
}
}
状态码
请参考 状态码
错误码
请参考 错误码
