查询镜像仓库概要信息 - ShowRepository

功能介绍

查询镜像仓库概要信息

接口约束

无

调用方法

请参见如何调用API。

授权信息

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

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

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

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}

表1 路径参数
参数	是否必选	参数类型	描述
namespace	是	String	组织名称。小写字母开头，后面跟小写字母、数字、小数点、下划线或中划线（其中下划线最多允许连续两个，小数点、下划线、中划线不能直接相连），小写字母或数字结尾，1-64个字符。
repository	是	String	镜像仓库名称。小写字母或数字开头，后面跟小写字母、数字、小数点、斜杠、下划线或中划线（其中下划线最多允许连续两个，小数点、斜杠、下划线、中划线不能直接相连），小写字母或数字结尾，1-128个字符。如果您的镜像名称repository参数中有斜杠，请先替换成$再进行请求。

请求参数

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

响应参数

状态码： 200

表3 响应Body参数
参数	参数类型	描述
id	Long	仓库编号
ns_id	Long	组织编号
name	String	仓库名称
category	String	仓库类型
description	String	仓库描述信息
creator_id	String	仓库创建者id
creator_name	String	仓库创建者
size	Long	仓库大小
is_public	Boolean	仓库是否为公共仓库，值为true或false
num_images	Long	仓库中镜像个数，0 ~ 9223372036854775807
num_download	Long	仓库下载次数
url	String	仓库logo图片的URL，URL格式。（暂时未用）
path	String	镜像pull路径，格式为 swr.{region}.myhuaweicloud.com/namespace/repository
internal_path	String	镜像pull路径，格式为 10.125.0.198:20202/namespace/repository
created	String	仓库创建时间，UTC日期格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00
updated	String	仓库更新时间，UTC日期格式，时间为UTC标准时间，用户需要根据本地时间计算偏移量；如东8区需要+8:00
domain_id	String	账号ID
priority	Integer	镜像排序优先级

请求示例

GET https://{endpoint}/v2/manage/namespaces/{namespace}/repos/{repository}

响应示例

状态码： 200

请求成功

{
  "id" : 0,
  "ns_id" : 0,
  "name" : "busybox",
  "category" : "other",
  "description" : "containerops",
  "creator_id" : "1",
  "creator_name" : "admin",
  "size" : 2099575,
  "is_public" : false,
  "num_images" : 0,
  "num_download" : 0,
  "url" : "",
  "path" : "swr.***.myhuaweicloud.com/namespace/repository",
  "internal_path" : "10.125.0.198:20202/namespace/repository",
  "created" : "2017-08-17T12:00:03.915153267Z",
  "updated" : "2017-08-17T12:00:03.915153267Z",
  "domain_id" : "da44776c316c4a99b3683bb174f8821b",
  "priority" : 0
}