批量添加标签

功能介绍

批量添加标签。

• 调用接口前，您需要了解API 认证鉴权。
• 调用接口前，您需要提前获取到地区和终端节点，即下文中的Endpoint值。

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/tags/action

• URI样例

  https://{Endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/tags/action

• 参数说明

  表1 参数说明

  名称	是否必选	说明
  project_id	是	租户在某一region下的project ID。 获取方法请参见获取项目ID。
  instance_id	是	实例ID。

请求消息

• 参数说明

  表2 参数说明

  名称	是否必选	参数类型	说明
  action	是	String	操作标识（区分大小写）：创建时为“create”。
  tags	是	Array of objects	标签列表。单个实例总标签数上限10个。 详情请参见表3。

  表3 tags字段数据结构说明

  名称	是否必选	参数类型	说明
  key	是	String	标签键。最大长度36个unicode字符。 key不能为空，不能为空字符串，不能重复。字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。
  value	是	String	标签值。最大长度43个unicode字符。 可以为空字符串。 字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。

• 请求样例

  {
  	"action": "create",
  	"tags": [{
  		"key": "key1",
  		"value": "value1"
  	}, {
  		"key": "key2",
  		"value": "value2"
  	}]
  }

响应消息

• 正常响应

  无

• 异常响应

  请参见异常请求结果。

状态码

请参见状态码。

错误码

请参见错误码。