查询镜像仓库列表（V3） - ListReposDetailsV3

功能介绍

查询镜像仓库列表详情。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
swr:repo:listRepos
List
repo *
-
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
swr:repo:listRepos	List	repo *	-	-	-

URI

GET /v3/manage/repos

表1 Query参数
参数	是否必选	参数类型	描述
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为私有

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
nextMarker	Integer	下一次分页查询的起始ID。如果未返回该值，则表示数据已查询完毕
repos	Array of ShowRepoRespV3 objects	-

表4 ShowRepoRespV3
参数	参数类型	描述
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	他人共享的镜像是否过期取值范围： false：未过期 true：已过期

请求示例

无

响应示例

状态码：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
}