更新时间:2024-04-18 GMT+08:00

批量创建和删除子网资源标签

功能介绍

为指定的子网资源实例批量添加或删除标签。

此接口为幂等接口:

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

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

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

URI

POST /v2.0/{project_id}/subnets/{subnet_id}/tags/action

参数说明请参见表1

表1 参数说明

名称

是否必选

说明

project_id

项目ID,请参见获取项目ID

subnet_id

子网唯一标识

如果您使用管理控制台,此值即为子网详情中的“网络ID”参数值。

请求参数

表2 请求参数

参数名称

类型

是否必选

说明

tags

Array of tag objects

tag对象列表,请参见表3

action

String

操作标识:

  • create:创建
  • delete:删除
表3 tag对象

属性

类型

是否必选

说明

key

String

  • 标签名称。
  • 不能为空。
  • 长度不超过128个字符(当前控制台操作key长度不超过36个字符)。
  • 由英文字母、数字、下划线、中划线、中文字符组成。
  • 同一资源的key值不能重复。

value

String

  • 标签值。
  • 长度不超过255个字符(当前控制台操作value长度不超过43个字符)。
  • 由英文字母、数字、下划线、点、中划线、中文字符组成。

请求示例

  • 批量创建两条子网资源标签,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"
            }
        ]
    }

响应参数

响应示例

状态码

请参见状态码

错误码

请参考错误码