华为云计算 云知识 批量创建VPC资源标签BatchCreateVpcTags
批量创建VPC资源标签BatchCreateVpcTags

 

功能介绍

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

此接口为幂等接口:

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

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

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

调试

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

URI

POST /v2.0/{project_id}/vpcs/{vpc_id}/tags/action

参数说明请参见表1。

表1 参数说明

名称

是否必选

说明

project_id

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

vpc_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个字符)。
  • 由英文字母、数字、下划线、点、中划线、中文字符组成。

请求示例

  • 批量创建两条VPC资源标签,action为create。
    POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags/action
    
    {
        "action": "create",
        "tags": [
            {
                "key": "key1",
                "value": "value1"
            },
            {
                "key": "key2",
                "value": "value3"
            }
        ]
    }
  • 批量删除两条VPC资源标签,action为delete。
    POST https://{Endpoint}/v2.0/{project_id}/vpcs/{vpc_id}/tags/action
    
    {
        "action": "delete",
        "tags": [
            {
                "key": "key1",
                "value": "value1"
            },
            {
                "key": "key2",
                "value": "value3"
            }
        ]
    }

响应参数

响应示例

状态码

请参见状态码

错误码

请参考错误码

 

上一篇:设置桶的消息通知配置SetBucketNotification 下一篇:云数据库 GaussDB NoSQL多模接口

虚拟私有云 VPC

虚拟私有云(Virtual Private Cloud)是用户在华为云上申请的隔离的、私密的虚拟网络环境。用户可以自由配置VPC内的IP地址段、子网、安全组等子服务,也可以申请弹性带宽和弹性IP搭建业务系统