更新时间:2022-03-22 GMT+08:00
分享

增加或修改标签

功能介绍

该接口主要用于为某个镜像增加或修改一个自定义标签。通过自定义标签,用户可以将镜像进行分类。

调试

您可以在API Explorer中调试该接口。

URI

PUT /v1/cloudimages/tags

请求消息

  • 请求参数

    参数

    是否必选

    参数类型

    描述

    image_id

    String

    镜像ID。

    如何获取镜像ID,请参见查询镜像列表

    tag

    String

    标签数据。

    tag和image_tag只能使用一个。

    image_tag

    Object

    新规范的镜像标签列表。image_tag参数说明请参考镜像标签数据格式。默认为空。

    tag和image_tag只能使用一个。

    表1 image_tag数据结构说明

    参数

    是否必选

    参数类型

    描述

    key

    String

    标签的键。

    value

    String

    标签的值。

  • 请求样例
    • 使用tag请求样例
      PUT https://{Endpoint}/v1/cloudimages/tags
      1
      2
      3
      4
      {
        "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1",
        "tag": "aaaa.1111"
      }
      
    • 使用image_tag请求样例
      PUT https://{Endpoint}/v1/cloudimages/tags
      1
      2
      3
      4
      {
        "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1",
        "image_tag": {"key":"key1","value":"value1"}
      }
      

响应消息

  • 响应参数

  • 响应样例
    STATUS CODE 204

返回值

  • 正常

    204

  • 异常

    返回值

    说明

    400 Bad Request

    请求错误。

    401 Unauthorized

    鉴权失败。

    403 Forbidden

    没有操作权限。

    404 Not Found

    找不到资源。

    500 Internal Server Error

    服务内部错误。

    503 Service Unavailable

    服务不可用。

分享:

    相关文档

    相关产品

关闭导读