Batch Adding or Deleting Load Balancer Tags

Function

This API is used to batch add tags to or delete tags from a load balancer.

Calling Method

For details, see Calling APIs.

URI

POST /v3/{project_id}/loadbalancers/{loadbalancer_id}/tags/action

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Definition: Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. Constraints: N/A Range: The value can contain a maximum of 32 characters, including digits and lowercase letters. Default value: N/A
loadbalancer_id	Yes	String	Definition: Specifies the load balancer ID. Constraints: N/A Range: N/A Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition: Specifies the token used for IAM authentication. Constraints: N/A Range: N/A Default value: N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
action	Yes	String	Definition: Specifies the operation type. Constraints: N/A Range: create: adds a tag. delete: deletes a tag.
tags	Yes	Array of ChangeResourceTagOption objects	Definition: Specifies the tags to be operated. Constraints: N/A

**Table 4** ChangeResourceTagOption
Parameter	Mandatory	Type	Description
key	Yes	String	Definition: Specifies the tag key. Constraints: The key cannot be left blank. Range: A key can contain a maximum of 36 Unicode characters. It cannot contain asterisks (), angle brackets (< and >), backslashes (), equal signs (=), commas (,), vertical bars (\|), or slashes (/). Default value*: N/A
value	Yes	String	Definition: Specifies the tag value. Constraints: The value must be specified when you delete a tag. Range: A value can contain a maximum of 255 Unicode characters. It cannot contain asterisks (), angle brackets (< and >), backslashes (), equal signs (=), commas (,), vertical bars (\|), or slashes (/). Default value*: N/A

Response Parameters

Status code: 204

Successful request.

None

Example Requests

POST https://{ELB_Endpoint}/v3/6a0de1c3-7d74-4f4a-b75e-e57135bd2b97/loadbalancers/7add33ad-11dc-4ab9-a50f-419703f13163/tags/action

{
  "tags" : [ {
    "key" : "key13",
    "value" : "value12"
  } ],
  "action" : "create"
}