批量添加标签

功能介绍

批量添加标签。

调用接口前，您需要了解API 认证鉴权。
调用接口前，您需要了解请求Header参数说明。

URI

URI格式
 POST /v3/{project_id}/instances/{instance_id}/tags/action

参数说明

表1 参数说明
名称	是否必选	说明
project_id	是	参数解释：租户在某一Region下的项目ID。获取方法请参见获取项目ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。
instance_id	是	参数解释：实例ID。约束限制：不涉及。取值范围：不涉及。默认取值：不涉及。

请求消息

表2 参数说明
名称	是否必选	参数类型	说明
action	是	String	参数解释：操作标识。约束限制：不涉及。取值范围：区分大小写，创建时为“create”。默认取值：不涉及。
tags	是	Array of objects	参数解释：标签列表。单个实例总标签数上限10个。详情请参见表3。约束限制：不涉及。

表3 tags字段数据结构说明
名称	是否必选	参数类型	说明
key	是	String	参数解释：标签键。约束限制：不涉及。取值范围：长度为1-128个unicode字符。可以包含任何语种字母、数字、空格和_.:=+-@，但首尾不能含有空格，不能以_sys_开头。字符集：A-Z，a-z ， 0-9，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。默认取值：不涉及。
value	是	String	参数解释：标签值。约束限制：不涉及。取值范围：最大长度255个unicode字符，可以为空字符串。可以包含任何语种字母、数字、空格和_.:=+-@。字符集：A-Z，a-z ， 0-9，‘.’，‘-’，‘_’，UNICODE字符（\u4E00-\u9FFF）。默认取值：不涉及。

请求示例

批量添加标签key1和key2。

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/tags/action
{
	"action": "create",
	"tags": [{
		"key": "key1",
		"value": "value1"
	}, {
		"key": "key2",
		"value": "value2"
	}]
}