获取 tag 列表

最近更新时间:2018-04-03 15:51:53

1. 接口描述

本接口 ( GetTagList ) 获取镜像 tag 列表。
接口请求域名:ccr.api.qcloud.com

2. 输入参数

以下请求参数列表仅列出了接口请求参数,其它参数见 公共请求参数(Region 参数必填)。

参数名称 描述 类型 必选
reponame 镜像名字 String
offset 偏移量,默认为 0 Uint
limit 返回最大数量,默认 20, 最大值 100 Uint
tag 可用于搜索的 tag 名字 String

3. 输出参数

参数名称 描述 类型
code 公共错误码。0 表示成功,其他值表示失败 Int
codeDesc 业务侧错误码。成功时返回 Success,错误时返回具体业务错误原因 String
message 模块错误信息描述,与接口相关 String
reponame 仓库名字 String
server 镜像仓库域名 String
tagCount tag 数目 Int
tagInfo tag 列表,结果按 pushTime 降序排练 Object Array

tag 字段详细说明:

参数名称 描述 类型
repo_name tag 对应的仓库名字 String
tagName tag 名字 String
tagId tag 的 ID String
imageId 镜像的 ID String
size 镜像大小 String
creationTime 创建时间 String
updateTime 更新时间 String
author 镜像制作者 String
architecture CPU 架构 String
dockerVersion Docker 客户端版本 String
os 操作系统 String
pushTime push 时间 String
sizeByte 镜像大小,单位为字节 Int

4. 示例

输入

  https://domain/v2/index.php?Action=GetTagList
  &reponame=test/kubetest  
  &offset=0
  &limit=20
  &tag=nginx_v1
  &其它公共参数

输出

{
    "code": 0,
    "message": "", 
    "codeDesc": "Success"
    "data": {
        "reponame": "test/kubetest",
        "server": "ccr.ccs.tencentyun.com",
        "tagCount": 1,
        "tagInfo": [
          {
            "repo_name": "kubetest",
            "tagName": "nginx_v1",
            "tagId": "sha256:5fbb3629fba1c7c875015c9cb4c27f1d9e8e92d2f027f09b6eda35ff952323a1",
            "imageId": "sha256:146c8220814be5f07a03b0b0b1e352ce42278684266d95670bf3e11225441b70",
            "size": "59 MB",
            "creationTime": "2017-09-12 15:30:23 +0800 CST",
            "updateTime": "2017-10-25 16:33:51 +0800 CST",
            "author": "",
            "architecture": "amd64",
            "dockerVersion": "1.12.5",
            "os": "linux",
            "pushTime": "2017-09-12 15:33:39 +0800 CST",
            "sizeByte": 59229024
          }
        ]
    }
}