通过键更新云硬盘标签（废弃）

功能介绍

通过键更新单个云硬盘的标签。

该接口已废弃，请使用性能更佳的接口，具体请参见为指定云硬盘批量添加标签。

接口约束

• 标签的键：如果要为云硬盘添加标签，则该项为必选参数。

  最大长度36个字符。 字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。

• 标签的值：如果要为云硬盘添加标签，则该项为可选参数。

  每个值最大长度43个字符，可以为空字符串。 字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。

• 单个云硬盘最多支持创建10个标签。

URI

• URI格式

  PUT /v2/{project_id}/os-vendor-tags/{resource_type}/{resource_id}/{key}

• 参数说明

  参数	是否必选	描述
  project_id	是	项目ID。 获取方法请参见获取项目ID。
  resource_type	是	资源类型可以是[volumes, snapshots, backups]中的某一种。
  resource_id	是	云硬盘ID号。
  key	是	标签的键。

请求消息

• 请求参数

  参数	参数类型	是否必选	描述
  tag	Object	是	标签的键值对。

• 请求Header参数说明

  参数	参数类型	是否必选	描述
  Content-Type	Object	是	格式可以是application/json。

• 请求样例

  {
      "tag": {
          "key_0": "value_0"
      }
  }

响应消息

• 响应参数

  参数	参数类型	描述
  tag	Object	标签的键值对。

• 响应样例

  {
      "tag": {
          "key_0": "value_0"
      }
  }

  或

  {
      "error": {
        ta  "message": "XXXX", 
          "code": "XXX"
      }
  }

  其中error是泛指的错误，有badRequest、itemNotFound等，如报错：

  {
      "badRequest": {
          "message": "Request body and URI mismatch", 
          "code": 400
      }
  }

状态码

• 正常

  200

错误码

请参考错误码。