Updated on 2025-07-25 GMT+08:00

Querying the IDC List

Function

This API is used to query the IDC list.

Calling Method

For details, see Calling APIs.

URI

GET https://www.example.com/v1/{project_id}/idcs

Table 1 URI parameter

Parameter

Mandatory

Type

Description

project_id

Yes

String

Definition

The project ID.

Constraints

N/A

Range

The project ID of the account

Default Value

N/A

Table 2 Query parameters

Parameter

Mandatory

Type

Description

region

Yes

String

Definition

Region information.

Constraints

N/A

Range

Regions

Default Value

N/A

limit

No

String

Definition

Number of records on each page for pagination query.

Constraints

N/A

Range

[1-2000]

Default Value

2000

order

No

String

Definition

Sorting order.

Constraints

N/A

Range

  • asc: The query results are displayed in ascending order.

  • desc: The query results are displayed in the descending order.

Default Value

N/A

marker

No

String

Definition

Query address of the next page.

Constraints

N/A

Range

N/A

Default Value

N/A

Request Parameters

Table 3 Request header parameter

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

Definition

Requests for calling an API can be authenticated using a token. If token-based authentication is used, this parameter is mandatory and must be set to a user token.

Constraints

N/A

Range

N/A

Default Value

N/A

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

idcs

Array of IDc objects

Definition

Equipment room set.

Constraints

N/A

page_info

PageInfo object

Definition

Pagination information.

Constraints

N/A

count

Integer

Definition

The total number of equipment rooms.

Constraints

N/A

Range

N/A

Default Value

N/A

Table 5 IDc

Parameter

Type

Description

name

String

Definition

Equipment room name.

Constraints

N/A

Range

Maximum length: 256 bytes

Default Value

N/A

irack_num

Integer

Definition

Number of racks contained.

Constraints

N/A

Range

Regions

Default Value

N/A

id

String

Definition

Equipment room ID.

Constraints

N/A

Range

Maximum length: 128 bytes

Default Value

N/A

region

String

Definition

Region information.

Constraints

N/A

Range

Regions

Default Value

N/A

description

String

Definition

Equipment room description.

Constraints

N/A

Range

Maximum length: 512 bytes

Default Value

N/A

Table 6 PageInfo

Parameter

Type

Description

next_marker

String

Definition

Query address of the next page.

Constraints

N/A

Range

N/A

Default Value

N/A

previous_marker

String

Definition

Query address of the previous page.

Constraints

N/A

Range

N/A

Default Value

N/A

current_count

Integer

Definition

The number of items returned on this page.

Constraints

N/A

Range

N/A

Default Value

N/A

Status code: 400

Table 7 Response body parameters

Parameter

Type

Description

error_msg

String

Definition

Error message.

Constraints

N/A

Range

N/A

Default Value

N/A

error_code

String

Definition

Error code.

Constraints

N/A

Range

N/A

Status code: 401

Table 8 Response body parameters

Parameter

Type

Description

error_msg

String

Definition

Error message.

Constraints

N/A

Range

N/A

Default Value

N/A

error_code

String

Definition

Error code.

Constraints

N/A

Range

N/A

Status code: 429

Table 9 Response body parameters

Parameter

Type

Description

error_msg

String

Definition

Error message.

Constraints

N/A

Range

N/A

Default Value

N/A

error_code

String

Definition

Error code.

Constraints

N/A

Range

N/A

Status code: 500

Table 10 Response body parameters

Parameter

Type

Description

error_msg

String

Definition

Error message.

Constraints

N/A

Range

N/A

Default Value

N/A

error_code

String

Definition

Error code.

Constraints

N/A

Range

N/A

Example Request

Request for querying the IDC list

GET https://{endpoint}/v1/{project_id}/idcs

Example Response

Status code: 200

The IDC list is returned.

{
  "idcs" : [ {
    "id" : "019674ed-07c1-7496-b6a8-96989d73efa9",
    "name" : "EquipmentRoom_001",
    "irack_num" : 1016,
    "description" : "Describe the test-hyphen_xaihauxia",
    "region" : "cn-southwest-242"
  } ],
  "page_info" : {
    "next_marker" : "01981c9a-bf80-7265-b3d3-6e2b34fcced5",
    "previous_marker" : "019674ed-07c1-7496-b6a8-96989d73efa9",
    "current_count" : 606
  },
  "count" : 606
}

Status Codes

Status Code

Description

200

The IDC list is returned.

400

Invalid request parameter.

401

Request error. User not authorized.

429

Request error due to too frequent requests.

500

Internal server error.

Error Codes

For details, see Error Codes.