文档首页/ 弹性负载均衡 ELB/ API参考（安卡拉区域）/ API（OpenStack API）/ 标签管理/ 批量删除监听器标签
更新时间：2024-04-19 GMT+08:00
查看PDF
分享

批量删除监听器标签

功能介绍

批量删除监听器的标签。

接口约束

  • 最多支持添加10个标签。
  • 此接口为幂等接口。
  • 删除时注意以下三点：
    • 删除监听器标签时，如果删除的标签不存在，默认处理成功。
    • 删除时不对标签字符集范围做校验。
    • 删除时tags结构体不能缺失，key不能为空，或者空字符串。
    • action固定为delete。

URI

POST /v2.0/{project_id}/listeners/{listener_id}/tags/action

表1 参数说明

参数

是否必选

参数类型

描述

project_id

是

String

标签所在的项目ID。

listener_id

是

String

要删除标签的监听器的ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户token
表3 请求参数

参数

是否必选

参数类型

描述

tags

是

Array

标签列表。详见表4。

action

是

String

操作标识；

取值范围：

  • delete：删除标签。
表4 resource_tag 字段数据结构说明

参数

是否必选

参数类型

描述

key

是

String

标签名称。

  • 不能为空。
  • 长度不超过36个字符。
  • 同一资源的key值不能重复。

value

是

String

标签值。

  • 长度不超过43个字符。

响应参数

无

请求示例

  • 请求样例 
    POST https://{Endpoint}/v2.0/6a0de1c3-7d74-4f4a-b75e-e57135bd2b97/listeners/7add33ad-11dc-4ab9-a50f-419703f13163/tags/action

{
    "action": "delete", 
    "tags": [
        {
            "key": "key1", 
            "value": "value1"
        }, 
        {
            "key": "key2", 
            "value": "value2"
        }
    ]
}

响应示例

  • 响应样例

    无

返回码

请参见返回码。

父主题： 标签管理