更新时间:2025-08-04 GMT+08:00

批量添加标签

功能介绍

批量添加标签。

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

参数解释

标签列表。单个实例总标签数上限20个。

详情请参见表3

约束限制

不涉及。

表3 tags字段数据结构说明

名称

是否必选

参数类型

说明

key

String

参数解释

标签键。

约束限制

不涉及。

取值范围

长度为1-128个unicode字符。

可以包含任何语种字母、数字、空格和_.:=+-@,但首尾不能含有空格,不能以_sys_开头。

默认取值

不涉及。

value

String

参数解释

标签值。

约束限制

不涉及。

取值范围

最大长度255个unicode字符,可以为空字符串。

可以包含任何语种字母、数字、空格和_.:=+-@。

默认取值

不涉及。

请求示例

批量添加标签key1和key2。
POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/cee5265e1e5845649e354841234567dfin01/tags/action
{
	"action": "create",
	"tags": [{
		"key": "key1",
		"value": "value1"
	}, {
		"key": "key2",
		"value": "value2"
	}]
}

响应消息

状态码

错误码

请参见错误码