更新时间:2022-01-25 GMT+08:00
批量创建和删除子网资源标签
功能介绍
为指定的子网资源实例批量添加或删除标签。
此接口为幂等接口:
创建时如果请求体中存在重复key则报错。
创建时,不允许设置重复key数据,如果数据库已存在该key,就覆盖value的值。
删除时,如果删除的标签不存在,默认处理成功,删除时不对标签字符集范围做校验。删除时tags结构体不能缺失,key不能为空,或者空字符串。
请求消息
请求参数
参数名称 |
类型 |
是否必选 |
说明 |
---|---|---|---|
tags |
Array of tag objects |
是 |
tag对象列表,请参见表3。 |
action |
String |
是 |
操作标识:
|
属性 |
类型 |
是否必选 |
说明 |
---|---|---|---|
key |
String |
是 |
|
value |
String |
是 |
|
请求样例1:批量创建标签
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags/action { "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
请求样例2:批量删除标签
POST https://{Endpoint}/v2.0/{project_id}/subnets/{subnet_id}/tags/action { "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value3" } ] }
响应消息
响应参数
无
响应样例
无
状态码
请参见状态码。
错误码
请参考错误码。
父主题: 子网资源标签管理