获取镜像仓库版本列表-GetImageRepositoryVersionsList

功能介绍

获取镜像仓库版本列表

URI

GET /v1.0/{project_id}/common/image-registry/image-repos/{id}/versions

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目id，获取方法请参见获取项目ID
id	是	Long	镜像仓库id

表2 Query参数
参数	是否必选	参数类型	描述
status	否	String	按照状态筛选
limit	否	Integer	返回个数上限
offset	否	Integer	查询偏移量

请求参数

表3 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

响应参数

状态码：200

表4 响应Body参数
参数	参数类型	描述
payload	VersionListPayload object	实际返回信息
meta_info	MetaInfo object	元数据

表5 VersionListPayload
参数	参数类型	描述
list	Array of RepoVersion objects	镜像版本列表
page_info	PageInfo object	分页信息

表6 RepoVersion
参数	参数类型	描述
id	Long	版本id
repo_id	Long	所属仓库id
create_at	Long	创建时间，UTC标准时间毫秒时间戳
update_at	Long	最近更新时间，UTC标准时间毫秒时间戳
project_id	String	项目id
user_id	String	创建用户id
status	String	状态
version	Integer	版本号
description	String	描述。若镜像没有描述则不返回该字段
visibility	String	使用范围

表7 PageInfo
参数	参数类型	描述
total	Integer	资源总数
offset	Integer	查询偏移量
limit	Integer	返回个数上限

表8 MetaInfo
参数	参数类型	描述
current_time	String	请求时间，UTC时间格式，时间为UTC标准时间

请求示例

查询仓库10001下的版本列表

GET https://{endpoint}/v1.0/{project_id}/common/image-registry/image-repos/10001/versions

响应示例

状态码：200

查询成功

{
  "meta_info" : {
    "current_time" : "2022-01-01T08:08:29Z"
  },
  "payload" : {
    "list" : [ {
      "id" : 10002,
      "repo_id" : 10001,
      "create_at" : 1698405950407,
      "update_at" : 1701399655749,
      "project_id" : "087679f0aa80d32a2f4ec0172f5e902b",
      "user_id" : "087679f0aa80d32a2f4ec0172f5e902b",
      "status" : "PUSHED",
      "version" : 1,
      "visibility" : "TEAM",
      "description" : "test"
    } ],
    "page_info" : {
      "total" : 1,
      "offset" : 0,
      "limit" : 10
    }
  }
}