查询镜像仓库列表（V3）
功能介绍
查询镜像仓库列表详情。
调用方法
请参见如何调用API。
URI
GET /v3/manage/repos
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
namespace |
否 |
String |
组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。 |
|
name |
否 |
String |
镜像仓库名称。小写字母或数字开头，后面跟小写字母、数字、小数点、斜杠、下划线或中划线（其中下划线最多允许连续两个，小数点、斜杠、下划线、中划线不能直接相连），小写字母或数字结尾，1-128个字符。如果您的镜像名称repository参数中有斜杠，请先替换成$再进行请求。 |
|
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接口获取（响应消息头中X-Subject-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 |
鉴权失败 |
|
500 |
服务内部错误 |
错误码
请参见错误码。
