华为云计算 云知识 批量创建子网资源标签BatchCreateSubnetTags
批量创建子网资源标签BatchCreateSubnetTags

 

功能介绍

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

此接口为幂等接口:

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

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

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

调试

您可以在API Explorer中调试该接口。

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

响应参数

响应示例

状态码

请参见状态码

错误码

请参考错误码

 

上一篇:删除策略DeletePolicy 下一篇: 源代码与二进制文件SCA检测原理

游戏批量开服数据库解决方案

游戏批量开服数据库解决方案