文档首页/ 容器镜像服务 SWR/ API参考 (巴黎区域) / API/ 镜像版本管理/ 查询镜像仓库tag列表
更新时间：2024-04-11 GMT+08:00
查看PDF
分享

查询镜像仓库tag列表

功能介绍

查询某一个镜像仓库的所有镜像版本。

URI

GET /v2/manage/namespaces/{namespace}/repos/{repository}/tags?filter=offset::{offset}|limit::{limit}|order_column::{order_column}|order_type::{order_type}|tag::{tag}

参数说明请参见表1。

表1 参数说明

参数名称

是否必选

参数类型

描述

namespace

是

String

组织名称

repository

是

String

镜像仓库名称
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

String

返回条数。注意：offset和limit参数需要配套使用。

offset

否

String

起始索引。注意：offset和limit参数需要配套使用。

order_column

否

String

按列排序，可设置为updated_at（按更新时间排序）。注意：order_column和order_type参数需要配套使用。

order_type

否

String

排序类型，可设置为desc（降序）、asc（升序）。注意：order_column和order_type参数需要配套使用。

tag

否

String

镜像版本名。

filter

否

String

应填写 offset::{offset}|limit::{limit}|order_column::{order_column}|order_type::{order_type}|tag::{tag} ,其中{limit}为返回条数,{offset}为起始索引,注意：offset和limit参数需要配套使用。 {order_column}为按列排序，可设置为updated_at（按更新时间排序）,{order_type}为排序类型，可设置为desc（降序）、asc（升序），{tag}为镜像版本名。

请求消息

  • 请求参数
    表3 请求Header参数

    参数

    是否必选

    参数类型

    描述

    Content-Type

    是

    String

    消息体的类型（格式），下方类型可任选其一使用： application/json;charset=utf-8 application/json

    缺省值：application/json

    X-Auth-Token

    是

    String

    用户Token。

    通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
  • 请求样例 
    GET https://{Endpoint}/v2/manage/namespaces/group/repos/busybox/tags

响应消息

  • 响应参数

    状态码： 200

    表4 响应Header参数

    参数

    参数类型

    描述

    Content-Range

    String

    offset(开始索引)-count(当前页记录条数)/total(总记录条数)
    表5 响应Body参数

    参数

    参数类型

    描述

    [数组元素]

    Array of ShowReposTagResp objects

    镜像tag列表
    表6 [数组元素]参数说明

    参数

    参数类型

    描述

    id

    Integer

    编号

    repo_id

    Integer

    仓库编号

    Tag

    String

    镜像版本名称

    image_id

    String

    镜像ID

    manifest

    String

    镜像manifest

    digest

    String

    镜像sha值

    schema

    Integer

    docker协议版本，值为1或2。

    path

    String

    镜像pull地址，格式为{Repository address}/{Namespace name}/{Repository name}:{Tag name}。

    internal_path

    String

    集群内镜像pull路径，格式为{Repository address}/{Namespace name}/{Repository name}:{Tag name}。

    size

    Integer

    镜像大小

    取值范围：0 ~ 9223372036854775807

    单位：字节

    is_trusted

    Boolean

    默认值为false

    created

    String

    镜像创建时间，UTC时间格式，时间为UTC标准时间。用户需要根据本地时间计算偏移量，如东8区需要+8:00。

    updated

    String

    镜像更新时间，UTC时间格式，时间为UTC标准时间。用户需要根据本地时间计算偏移量，如东8区需要+8:00。

    deleted

    String

    镜像删除时间

    domain_id

    String

    账号ID

    tag_type

    Integer

    0：manifest类型；1：manifest list类型
  • 响应样例 
    [
    {
        "id": 0,
        "repo_id": 0,
        "Tag": "latest",
        "image_id": "741f24a795d6d93d7c6edd11780d63c13e16c39615dd9d223378a57a836f2ee6",
        "manifest": "{\"schemaVersion\":2,\"mediaType\":\"application/vnd.docker.distribution.manifest.v2+json\",\"config\":{\"mediaType\":\"application/vnd.docker.container.image.v1+json\",\"size\":1862,\"digest\":\"sha256:741f24a795d6d93d7c6edd11780d63c13e16c39615dd9d223378a57a836f2ee6\"},\"layers\":[{\"mediaType\":\"application/vnd.docker.image.rootfs.diff.tar.gzip\",\"size\":1292800,\"digest\":\"sha256:8ac8bfaff55af948c796026ee867448c5b5b5d9dd3549f4006d9759b25d4a893\"},{\"mediaType\":\"application/vnd.docker.image.rootfs.diff.tar.gzip\",\"size\":10240,\"digest\":\"sha256:77ddbf3a9fe11e81761a0f9df43a28e3e6f29bbb53c0c8cf71cd7efa69729aed\"}]}",
        "digest": "sha256:57b605845a6367c34bfb6ea6477f16852f59aa1861a2b51d10ab77ae0a1dc9c3",
        "schema": 2,
        "path": "{Repository address}/group/busybox:latest",
        "internal_path": "10.125.0.198:20202/namespace/busybox:latest",
        "size": 1304902,
        "is_trusted": false,
        "created": "2018-07-06T06:18:55Z",
        "updated": "2018-07-06T06:18:55Z",
        "deleted": null,
        "domain_id": "0503dda878000fed0f75c0096d70a960",
        "tag_type": 0
    }
]

状态码

状态码

描述

200

成功查询镜像仓库的所有tag

400

错误请求，返回错误信息。

401

鉴权失败

404

repository不存在

500

服务器内部错误，返回错误信息。

错误码

请参见错误码。

父主题： 镜像版本管理