更新时间:2022-01-25 GMT+08:00

批量添加/删除NAT网关资源标签

功能介绍

为指定NAT网关实例批量添加或删除标签。

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

一个资源上最多有10个标签。

此接口为幂等接口:

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

创建时,不允许重复key,如果数据库存在就覆盖。

删除时,如果删除的标签不存在,默认处理成功,删除时不对标签字符集范围做校验。Key长度127个unicode字符,value为255个unicode字符。删除时tags结构体不能缺失,key不能为空,或者空字符串。

URI

  • URI格式

POST /v2.0/{project_id}/nat_gateways/{nat_gateway_id}/tags/action

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

项目的ID。

nat_gateway_id

String

NAT网关ID。

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

tags

Array

标签列表。请参考表3

action

String

操作标识:仅限于create(创建)、delete(删除)

表3 tags字段数据结构说明

参数

是否必选

参数类型

描述

key

String

键。最大长度36个unicode字符。 key不能为空。不能包含非打印字符ASCII(0-31),“=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”

value

String

值。每个值最大长度43个unicode字符,删除时如果value有值按照key/value删除,如果value没值,则按照key删除,可以为空字符串。,不能包含非打印字符ASCII(0-31), “=”,“*”,“<”,“>”,“\”,“,”,“|”,“/”

响应消息

示例

  • 请求样例
    POST  https://{VPC_endpoint}/v2.0/9ad601814ac94c80bf7bb9073ded66fc/nat_gateways/fe1a4cf0-27fe-4b97-a9b1-2c67c127f0e0/tags/action
    {
        "action": "create",
        "tags": [
            {
                "key": "key1",
                "value": "value1"
            },
            {
                "key": "key2",
                "value": "value2"
            }
        ]
    }
    或
    {
        "action": "delete",
        "tags": [
            {
                "key": "key1",
                "value": "value1             
             },
            {
                "key": "key2",
                "value": "value2"
            }
        ]
    }

响应样例

状态码

请参考状态码