更新时间:2024-08-08 GMT+08:00
分享

添加监听器标签

功能介绍

给指定监听器添加标签。

接口约束

  • 一个资源上最多有20个标签。
  • 添加时注意以下两点:
    • 如果请求体中存在重复key,则报错。
    • 如果请求体中无重复key,但是数据库中存在请求体中的key,则将数据库中的key值覆盖。

URI

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

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

标签所在的项目ID。

获取方法详见获取项目ID

listener_id

String

要添加标签的监听器的ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户token

表3 请求参数

参数

是否必选

参数类型

描述

tag

Object

标签对象。详见表4

表4 tag 字段数据结构说明

参数

是否必选

参数类型

描述

key

String

标签名称。

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

value

String

标签值。

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

响应参数

请求示例

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

响应示例

  • 响应样例

返回码

请参见返回码

相关文档