Help Center/ CloudPond/ API Reference/ API/ Regions/ Listing Regions Where CloudPond Is Available
Updated on 2025-12-08 GMT+08:00
View PDF
Share

Listing Regions Where CloudPond Is Available

Function

This API is used to list the regions where CloudPond is supported.

  • This API supports fine-grained permissions for enterprise projects. For details, see ies:region:list.

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, the following identity policy-based permissions are required.

    Action

    Access Level

    Resource Type (*: required)

    Condition Key

    Alias

    Dependencies

    ies::listRegions

    List

    -

    -
    • ies:region:list

    -

URI

GET /v1/{domain_id}/regions

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

domain_id

Yes

String

Account ID in the path.
Table 2 Query Parameters

Parameter

Mandatory

Type

Description

limit

No

Integer

Page size.

marker

No

String

Pagination identifier.

sort_key

No

Array of strings

Sorting field.

sort_dir

No

Array of strings

Sorting order. The options are as follows:

  • desc: descending order

  • asc: ascending order

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

X-Auth-Token

Yes

String

User token.

X-Language

No

String

Language of the information returned by the API. The default value is zh-cn.

Response Parameters

Status code: 200

Table 4 Response body parameters

Parameter

Type

Description

regions

Array of RegionDetail objects

Region list.

page_info

PageInfo object

Pagination information.
Table 5 RegionDetail

Parameter

Type

Description

region_id

String

Region ID.

display_name

String

Region name.
Table 6 PageInfo

Parameter

Type

Description

next_marker

String

Next page marker.

current_count

Integer

Number of records on the current page.

Example Requests

Listing regions where CloudPond is available

GET https://{ies_endpoint}/v1/{domain_id}/regions

Example Responses

Status code: 200

successful operation

{
  "regions" : [ {
    "region_id" : "cn-south-1",
    "display_name" : "CN South-Guangzhou"
  } ],
  "page_info" : {
    "current_count" : 1
  }
}

Status Codes

Status Code

Description

200

successful operation

Error Codes

See Error Codes.

Parent topic: Regions