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.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

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"
}