批量添加删除中转IP标签

功能介绍

• 为指定中转IP实例批量添加或删除标签

• 标签管理服务需要使用该接口批量管理中转IP实例的标签。

• 一个中转IP上最多有10个标签。

接口约束

此接口为幂等接口：

• 创建时如果请求体中存在重复key则报错。

• 创建时，不允许设置重复key数据,如果数据库已存在该key，就覆盖value的值。

• 删除时，如果删除的标签不存在，默认处理成功，删除时不对标签字符集范围做校验。

• 删除时tags结构体不能缺失，key不能为空，或者空字符串。

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/transit-ips/{resource_id}/tags/action

请求参数

响应参数

无

请求示例

• 批量添加中转IP标签，其中，操作标识为create，标签列表中包含两个标签，其中第一个标签键为“key1”，对应的值为“value1”，第二个标签键为“key2”，对应的值为“value2”。

  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"
    } ]
  }

• 批量删除中转IP标签，其中，操作标识为delete，标签列表中包含两个标签，其中第一个标签键为“key1”，对应的值为“value1”，第二个标签键为“key2”，对应的值为“value2”。

  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"
    } ]
  }

响应示例

无

状态码

错误码

请参见错误码。