更新时间:2025-05-14 GMT+08:00
分享

获取镜像仓库版本列表

功能介绍

获取镜像仓库版本列表

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
    }
  }
}

状态码

状态码

描述

200

查询成功

400

参数校验失败

401

身份认证失败

403

权限校验失败

404

镜像仓库不存在

500

系统内部错误

错误码

请参见错误码

相关文档