增加或修改标签

功能介绍

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

调试

您可以在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	标签的值。

请求示例

• 使用tags标签数据格式，增加或修改标签。

  1 2 3 4 5

  PUT https://{Endpoint}/v1/cloudimages/tags { "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1", "tag": "aaaa.1111" }

• 使用image_tag标签数据格式，增加或修改标签。

  1 2 3 4 5

  PUT https://{Endpoint}/v1/cloudimages/tags { "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	服务不可用。