Help Center/ Elastic Load Balance/ API Reference/ APIs (V3)/ Tag Management/ Querying the Tags of All Load Balancers
Updated on 2026-01-20 GMT+08:00

Querying the Tags of All Load Balancers

Function

This API is used to query the tags of all the load balancers in a specified project.

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

GET /v3/{project_id}/loadbalancers/tags

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

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

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

tags

Array of ListTag objects

Definition: Specifies the tag list.

Table 4 ListTag

Parameter

Type

Description

key

String

Definition: Specifies the tag key.

Range: A tag key can contain a maximum of 36 Unicode characters.

values

Array of strings

Definition: Specifies the tag values.

Range: Each value can contain a maximum of 43 Unicode characters and can be an empty string.

Example Requests

GET https://{ELB_Endpoint}/v3/6a0de1c3-7d74-4f4a-b75e-e57135bd2b97/loadbalancers/tags

Example Responses

Status code: 200

Successful request.

{
  "tags" : [ {
    "values" : [ "value1", "value2" ],
    "key" : "key1"
  }, {
    "values" : [ "value1", "value2" ],
    "key" : "key2"
  } ]
}

Status Codes

Status Code

Description

200

Successful request.

Error Codes

See Error Codes.