查询镜像仓库列表详情（v3） - ListReposDetailsV3
功能介绍
查询镜像仓库列表详情
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
swr:repo:listRepos
List
repo *
-
-
-
URI
GET /v3/manage/repos
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| namespace | 否 | String | 组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 |
| name | 否 | String | 镜像仓库名称。支持模糊匹配 |
| category | 否 | String | 镜像仓库分类，可设置为app_server, linux, framework_app, database, lang, other, windows, arm。 |
| limit | 否 | Integer | 查询返回镜像仓库列表当前页面的数量。 每页默认值是100，最多返回1000条镜像仓库的信息 |
| marker | 否 | Integer | 分页查询时的起始标记，接口的返回值nextMarker为下一次查询的起始标记。 |
| is_public | 否 | Boolean | 是否为公开仓，true为公开，false为私有 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json |
| X-Auth-Token | 是 | String | 用户Token, 通过调用IAM服务获取用户Token接口获取 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| nextMarker | Integer | 下一次分页查询的起始ID。如果未返回该值，则表示数据已查询完毕 |
| repos | Array of ShowRepoRespV3 objects |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | Long | 仓库编号 |
| name | String | 仓库名称 |
| category | String | 仓库类型 |
| description | String | 仓库描述信息 |
| size | Long | 仓库大小 |
| is_public | Boolean | 是否为公开仓库 |
| num_images | Long | 仓库中镜像个数，0 ~ 9223372036854775807 |
| num_download | Long | 仓库下载次数 |
| created_at | String | 仓库创建时间，UTC日期格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00 |
| updated_at | String | 仓库更新时间，UTC日期格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00 |
| domain_name | String | 仓库所属租户名 |
| namespace_name | String | 仓库所属的组织名称 |
| status | Boolean | 他人共享的镜像是否已过期，获取自身仓库信息的场景不返回该字段 |
请求示例
无
响应示例
状态码：200
{
"repos" : [ {
"id" : 1,
"name" : "nginx",
"category" : "linux",
"size" : 200977474,
"is_public" : false,
"num_images" : 2,
"num_download" : 0,
"created_at" : "2017-01-01T00:00:00Z",
"updated_at" : "2017-09-11T03:00:02.542841141Z",
"domain_name" : "root",
"namespace_name" : "root"
} ],
"nextMarker" : 1
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询仓库详情列表成功 |
| 400 | 错误的请求 |
| 401 | 鉴权失败 |
| 403 | 禁止访问 |
| 404 | 未找到资源 |
| 500 | 内部错误 |
错误码
请参见错误码。
