You can call this operation to query Alibaba Cloud regions.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request headers

This operation only uses common request headers. For more information, see the Common request parameters topic.

Request syntax

POST /pop/v5/resource/region_list HTTPS|HTTP

Request parameters

Response parameters

Parameter Type Example Description
Code Integer 200

The returned code.

Message String success

The returned message.

RequestId String b197-40ab-9155-7ca7
RegionEntityList Array

The list of regions returned.

Id String cn-hangzhou

The ID of the region returned.

Name String China East 1 (Hangzhou)

The name of the region returned.

Examples

Sample requests

POST /pop/v5/resource/region_list HTTP/1.1
Common request headers

Sample success responses

JSON format

{
    "Message": "success",
    "RegionEntityList": {
        "RegionEntity": [
            {
                "Name": "China East 1 (Hangzhou)",
                "Id": "cn-hangzhou"
            },
            {
                "Name": "China North 1 (Qingdao)",
                "Id": "cn-qingdao"
            },
            {
                "Name": "China North 2 (Beijing)",
                "Id": "cn-beijing"
            },
            {
                "Name": "China South 1 (Shenzhen)",
                "Id": "cn-shenzhen"
            },
            {
                "Name": "China East 2 (Shanghai)",
                "Id": "cn-shanghai"
            },
            {
                "Name": "Asia Pacific SE 1 (Singapore)",
                "Id": "ap-southeast-1"
            },
            {
                "Name": "Hong Kong (China)",
                "Id": "cn-hongkong"
            },
            {
                "Name": "Australia(Sydney)",
                "Id": "ap-southeast-2"
            },
            {
                "Name": "America(Virginia)",
                "Id": "us-east-1"
            },
            {
                "Name": "China North 3",
                "Id": "cn-zhangjiakou"
            },
            {
                "Name": "Germany (Frankfurt)",
                "Id": "eu-central-1"
            },
            {
                "Name": "public",
                "Id": "public"
            }
        ]
    },
    "Code": 200
}

XML format

<Message>success</Message>
<RegionEntityList>
    <RegionEntity>
        <Name>China East 1 (Hangzhou)</Name>
        <Id>cn-hangzhou</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>China North 1 (Qingdao)</Name>
        <Id>cn-qingdao</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>China North 2 (Beijing)</Name>
        <Id>cn-beijing</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>China South 1 (Shenzhen)</Name>
        <Id>cn-shenzhen</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>China East 2 (Shanghai)</Name>
        <Id>cn-shanghai</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>Asia Pacific SE 1 (Singapore)</Name>
        <Id>ap-southeast-1</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>Hong Kong (China)</Name>
        <Id>cn-hongkong</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>Australia(Sydney)</Name>
        <Id>ap-southeast-2</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>America(Virginia)</Name>
        <Id>us-east-1</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>China North 3</Name>
        <Id>cn-zhangjiakou</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>Germany (Frankfurt)</Name>
        <Id>eu-central-1</Id>
    </RegionEntity>
    <RegionEntity>
        <Name>public</Name>
        <Id>public</Id>
    </RegionEntity>
</RegionEntityList>
<Code>200</Code>

Error codes

For a list of error codes, visit the API Error Center.