批量添加删除中转IP标签BatchCreateDeleteTransitIpTags
.jpg)
.jpg)
.jpg)
.jpg)
接口说明
- 为指定中转IP实例批量添加或删除标签
- 标签管理服务需要使用该接口批量管理中转IP实例的标签。
- 一个中转IP上最多有10个标签。
约束说明
此接口为幂等接口:
- 创建时如果请求体中存在重复key则报错。
- 创建时,不允许设置重复key数据,如果 数据库 已存在该key,就覆盖value的值。
- 删除时,如果删除的标签不存在,默认处理成功,删除时不对标签字符集范围做校验。
- 删除时tags结构体不能缺失,key不能为空,或者空字符串。
URL
POST https://nat.cn-north-4.myhuaweicloud.com/v3/{project_id}/transit-ips/{resource_id}/tags/action
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 用户Token也就是调用获取用户Token获取请求认证接口的响应值,该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 |
|
project_id
|
string | path | 是 |
项目的ID。 |
|
resource_id
|
string | path | 是 |
中转IP的ID。 |
Body参数
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
action
|
string | 是 |
功能说明:操作标识。 取值范围: create(创建) delete(删除) |
|
tags
|
Array of Tag objects | 是 |
标签列表。 |
返回参数
返回码: 204
批量添加或删除操作成功。
请求示例
示例 1
批量添加中转IP标签。
"POST https://{Endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/transit-ips/56121618-fb0a-4a51-aff0-e2eb9cba4c73/tags/action"
{ "action": "create", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
示例 2
批量删除中转IP标签。
"POST https://{Endpoint}/v3/cfa563efb77d4b6d9960781d82530fd8/transit-ips/56121618-fb0a-4a51-aff0-e2eb9cba4c73/tags/action"
{ "action": "delete", "tags": [ { "key": "key1", "value": "value1" }, { "key": "key2", "value": "value2" } ] }
SDK
点击 NAT网关 (NAT) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明。
猜你喜欢
