Help Center/Cloud Connect/API Reference/API/Global Connection Bandwidth Tag Management/Querying All Global Connection Bandwidth Tags in an Account
Updated on 2025-09-12 GMT+08:00
View PDF

Querying All Global Connection Bandwidth Tags in an Account

Function

This API is used to query all global connection bandwidth tags in an account.

URI

GET /v3/gcb/tags

Request Parameters

Table 1 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

tags

Array of TmsTagValues objects

Tag list.

total_count

Integer

Total records.

request_id

String

Request ID.

Table 3 TmsTagValues

Parameter

Type

Description

key

String

Tag key.

values

Array of strings

List of tag values.

Example Requests

Querying all global connection bandwidth tags in an account

GET https://{cc_endpoint}/v3/gcb/tags

Example Responses

Status code: 200

All global connection bandwidth tags in an account have been queried.

{
  "tags" : [ {
    "key" : "key1",
    "values" : [ "value1", "value2" ]
  } ],
  "request_id" : "e3371202-7e85-4c16-bb4b-4e3c092734f7",
  "total_count" : 1
}

Status Codes

Status Code

Description

200

All global connection bandwidth tags in an account have been queried.

Error Codes

See Error Codes.

Parent Topic: Global Connection Bandwidth Tag Management