You can call this operation to retrieve the Alibaba Cloud regions available for you.

For more information, see Regions and zones.

Request parameters

Name Type Required Example Description
Action String Yes DescribeRegions The operation that you want to perform. Set the value to DescribeRegions.
RegionId String Yes cn-hangzhou The ID of the region where the instance is located.

Response parameters

Name Type Example Description
RegionId String cn-shanghai The ID of the region.
RequestId String 145318BE-DEE1-4C57-AA7C-5BE7D34A6AE0 The ID of the request.

Examples

Sample requests

https://ecs.cn-hangzhou.aliyuncs.com/?
Action=DescribeRegions
&RegionId=cn-hangzhou
&<Common request parameters>
Sample responses

XML format

<DescribeRegionsResponse>
    <RequestId>38EC7366-F5A9-46B1-BDB1-0FDC2E296397</RequestId>
    <Regions>
        <Region>
            <RegionId>cn-shanghai</RegionId>
        </Region>
        <Region>
            <RegionId>cn-qingdao</RegionId>
        </Region>
    </Regions>
</DescribeRegionsResponse>

JSON format

{
    "RequestId":"38EC7366-F5A9-46B1-BDB1-0FDC2E296397",
    "Regions":{
        "Region":[
            {
                "RegionId":"cn-shanghai",
            },
            {
                "RegionId":"cn-qingdao",
            }
        ]
    }
}

Error codes

None.