功能介绍
-
为指定实例批量添加或删除标签
-
标签管理服务需要使用该接口批量管理实例的标签。
-
一个资源上最多有10个标签。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v3/{project_id}/{resource_type}/{resource_id}/tags/action
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
租户项目ID |
resource_id |
是 |
String |
资源实例ID |
resource_type |
是 |
String |
枚举值:
|
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action |
是 |
String |
功能说明:操作标识。 取值范围: create(创建) delete(删除) 枚举值:
|
tags |
否 |
标签列表。 |
|
sys_tags |
否 |
标签列表。 |
响应参数
无
请求示例
-
批量添加资源标签。
POST https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/3320166e-b937-40cc-a35c-02cd3f2b3ee2/
tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] } -
批量删除资源标签。
POST https://{endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/dc-vgw/3320166e-b937-40cc-a35c-02cd3f2b3ee2/
tags/action { "action" : "delete", "tags" : [ { "key" : "key1" }, { "key" : "key2", "value" : "value3" } ] }
响应示例
无
状态码
状态码 |
描述 |
---|---|
204 |
批量添加或删除操作成功。 |
错误码
请参见错误码。