更新时间:2022-03-31 GMT+08:00
分享

批量添加删除负载均衡标签

功能介绍

批量添加删除负载均衡的标签。

接口约束

最多支持添加10个标签。

此接口为幂等接口。

  • 添加时注意以下两点:
    • 如果请求体中存在重复key,则报错。
    • 如果请求体中无重复key,但是数据库中存在请求体中的key,则将数据库中的key值覆盖。
  • 删除时注意以下三点:
    • 删除负载均衡标签时,如果删除的标签不存在,默认处理成功。
    • 删除时不对标签字符集范围做校验。
    • 删除时tags结构体不能缺失,key不能为空,或者空字符串。

URI

POST /v2.0/{project_id}/loadbalancers/{loadbalancer_id}/tags/action

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

标签所在的项目ID。

获取方法详见获取项目ID

loadbalancer_id

String

要添加或删除标签的负载均衡器的ID。

请求消息

表2 请求参数

参数

是否必选

参数类型

描述

tags

Array

标签对象列表。标签对象详见表3

action

String

操作类型;

取值范围:

  • create:创建标签。
  • delete:删除标签。
表3 tags 字段数据结构说明

参数

是否必选

参数类型

描述

key

String

标签名称。

  • 不能为空。
  • 长度不超过36个字符。
  • 由英文字母、数字、下划线、中划线、中文字符组成。
  • 同一资源的key值不能重复。

value

String

标签值。

  • 长度不超过43个字符。
  • 由英文字母、数字、下划线、点、中划线、中文字符组成。

响应消息

请求示例

  • 请求样例1
    POST https://{Endpoint}/v2.0/6a0de1c3-7d74-4f4a-b75e-e57135bd2b97/loadbalancers/7add33ad-11dc-4ab9-a50f-419703f13163/tags/action
    
    {
        "action": "create", 
        "tags": [
            {
                "key": "key1", 
                "value": "value1"
            }, 
            {
                "key": "key2", 
                "value": "value2"
            }
        ]
    }
  • 请求样例2
    POST https://{Endpoint}/v2.0/6a0de1c3-7d74-4f4a-b75e-e57135bd2b97/loadbalancers/7add33ad-11dc-4ab9-a50f-419703f13163/tags/action
    
    {
        "action": "delete", 
        "tags": [
            {
                "key": "key1", 
                "value": "value1"
            }, 
            {
                "key": "key2", 
                "value": "value2"
            }
        ]
    }

响应示例

  • 响应样例1

  • 响应样例2

返回码

请参见返回码

分享:

    相关文档

    相关产品

关闭导读