文档首页/ 镜像服务 IMS/ API参考/ API/ 镜像标签/ 查询租户所有镜像标签
更新时间:2024-06-24 GMT+08:00

查询租户所有镜像标签

功能介绍

该接口用于查询租户的所有镜像上的标签。

URI

GET /v2/{project_id}/images/tags

参数说明请参见表1
表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

项目ID

请求消息

请求参数

请求示例

查询租户所有镜像标签。

GET https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/tags

响应消息

  • 响应参数

    参数

    参数类型

    描述

    tags

    Array of objects

    标签列表。详情请参见表2

    表2 tags数据结构说明

    参数

    参数类型

    描述

    key

    String

    标签的键。

    values

    Array of strings

    标签的值列表。如果标签只有key,则在值列表中以空白字符串""的形式出现。

  • 响应样例
    STATUS CODE 200
     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    {
       "tags": [{
          "values": ["value9"],
          "key": "key9"
       },
       {
          "values": [""],
          "key": "key8"
       },
       {
          "values": 
            ["valueXX",
            "value3"],
          "key": "key3"
       }]
    }
    

返回值

  • 正常

    200

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。