功能介绍
为指定的子网资源实例批量添加或删除标签。
此接口为幂等接口:
创建时如果请求体中存在重复key则报错。
创建时,不允许设置重复key数据,如果 数据库 已存在该key,就覆盖value的值。
删除时,如果删除的标签不存在,默认处理成功,删除时不对标签字符集范围做校验。删除时tags结构体不能缺失,key不能为空,或者空字符串。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2.0/{project_id}/subnets/{subnet_id}/tags/action
请求参数
参数名称 |
类型 |
是否必选 |
说明 |
---|---|---|---|
tags |
是 |
||
action |
String |
是 |
操作标识:
|
请求示例
- 批量创建两条子网资源标签,action为create。
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
- 批量删除两条子网资源标签,action为delete。
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags/action { "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
响应参数
无
响应示例
无
状态码
请参见状态码。
错误码
请参考错误码。