• Elastic Load Balancing

elb
  1. Help Center
  2. Elastic Load Balancing
  3. API Reference
  4. Enhanced Load Balancer APIs
  5. Tag
  6. Adding a Tag to a Load Balancer

Adding a Tag to a Load Balancer

Function

This API is used to add a tag to a specific load balancer. This API is used to add a tag to a specific load balancer for easier management.

URI

POST /v2.0/{project_id}/loadbalancers/{loadbalancer_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.

loadbalancer_id

Yes

Uuid

Specifies the ID of the load balancer to which a tag is to be added.

Constraints

A maximum of 10 tags can be added to a load balancer.

Pay attention to the following when adding 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.

Request

  • Request parameters
    Table 2 Parameter description

    Parameter

    Mandatory

    Type

    Description

    tag

    Yes

    Dict

    Specifies the tag. For details, see Table 3.

    Table 3 tags field description

    Parameter

    Mandatory

    Type

    Description

    key

    Yes

    String

    Specifies the tag key. The value can contain a maximum of 36 Unicode characters.

    It cannot be left blank or contain asterisks (*), angle brackets (< and >), backslashes (\), equal signs (=), commas (,), vertical bars (|), or slashes (/).

    value

    Yes

    String

    Specifies the tag value. Each tag value contains a maximum of 43 Unicode characters and can also be an empty string.

    It cannot contain asterisks (*), angle brackets (< and >), backslashes (\), equal signs (=), commas (,), vertical bars (|), or slashes (/).

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

Response

  • Response parameters

    None

  • Example response

    None

Response Codes

For details, see Response Codes.