功能介绍
- 为指定实例批量添加或删除标签
- 标签管理服务需要使用该接口批量管理实例的标签。
- 一个资源上最多有10个标签。
- 当前API支持华北-北京四、西南-贵阳一、华南-广州、中国-香港、亚太-曼谷、非洲-约翰内斯堡、华北-乌兰察布一、亚太-新加坡、拉美-圣保罗一区域。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v3/{project_id}/{resource_type}/{resource_id}/tags/action
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
action |
是 |
String |
功能说明:操作标识。 取值范围: create(创建) delete(删除) |
tags |
否 |
标签列表。 |
响应参数
无
请求示例
- 批量添加资源标签。
POST https://{erouter-endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/instance/
3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key2", "value" : "value2" } ] } - 批量删除资源标签。
POST https://{erouter-endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/instance/
3320166e-b937-40cc-a35c-02cd3f2b3ee2/tags/action { "action" : "delete", "tags" : [ { "key" : "key1" }, { "key" : "key2", "value" : "value3" } ] }
响应示例
无
状态码
状态码 |
描述 |
---|---|
204 |
批量添加或删除操作成功。 |
错误码
请参见错误码。