Function

This API is used to add a tag to a specific listener.

You can also use this API for dedicated load balancers.

Constraints

A maximum of 20 tags can be added to a listener.
Note the following when you add tags:
- If there are duplicate keys in the request body, an error is reported.
- If there are no duplicate keys in the request body but the key in the request body exists in the database, the key in the database is overwritten.

URI

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

**Table 1** Parameter description
Parameter	Mandatory	Type	Description
project_id	Yes	String	Specifies the ID of the project where the tag is used.
listener_id	Yes	String	Specifies the ID of the listener to which a tag is to be added.

Request

**Table 2** Parameter description
Parameter	Mandatory	Type	Description
tag	Yes	Object	Specifies the tag. For details, see Table 3.

**Table 3** **tag** parameter description
Parameter	Mandatory	Type	Description
key	Yes	String	Specifies the tag key. Cannot be left blank. Can contain a maximum of 36 characters. Can contain only the following character types: Uppercase letters Lowercase letters Digits Special characters, including hyphens (-) and underscores (_) The tag key of a listener must be unique.
value	Yes	String	Specifies the tag value. Can contain a maximum of 43 characters. Can contain only the following character types: Uppercase letters Lowercase letters Digits Special characters, including hyphens (-) and underscores (_)

Response

None

Example Request

Example request

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

{
    "tag": {
        "key": "key1", 
        "value": "value1"
    }
}

Example Response

Example response
None

Status Code

For details, see Status Codes.

Adding a Tag to a Listener