文档首页 > > API参考> API> 查询镜像tag列表

查询镜像tag列表

分享
更新时间: 2019/09/04 GMT+08:00

功能介绍

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

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

镜像仓库名称

offset

Integer

起始索引

limit

Integer

返回的条数

order_column

String

按列排序,可设置为updated_at(按更新时间排序)。

order_type

String

排序类型,可设置为desc(降序)、asc(升序)。

tag

String

镜像版本名

请求消息

N/A

响应消息

响应参数

表2 Response Body参数说明

参数

参数类型

描述

id

Integer

编号

repo_id

Integer

仓库编号

Tag

String

Tag版本名称

image_id

String

镜像id

manifest

String

镜像manifest

digest

String

镜像sha值

schema

Integer

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

path

String

镜像pull地址,格式为

swr.cn-north-1.myhuaweicloud.com/namespace/repository:tag。

internal_path

String

cce集群内镜像pull路径,格式为 10.125.0.198:20202/namespace/repository:tag

size

Integer

镜像大小,0 ~ 9223372036854775807。

is_trusted

Boolean

默认值为false

created

String

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

updated

String

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

deleted

String

镜像删除时间

响应示例

[
    {
        "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": "swr.cn-north-1.myhuaweicloud.com/namespace/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
    }
]

状态码

状态码如表3所示。

表3 状态码

状态码

描述

200

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

400

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

404

repository不存在。

500

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

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区