All Products
Search
Document Center

Serverless App Engine:DescribeRegions

Last Updated:Dec 17, 2025

Queries available regions.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

GET /pop/v1/paas/regionConfig HTTP/1.1

Request parameters

ParameterTypeRequiredDescriptionExample
The current API does not require request parameters

Response parameters

ParameterTypeDescriptionExample
object

The returned data.

Messagestring

The returned message.

success
RequestIdstring

The request ID.

DDE85827-B0B3-4E56-86E8-17C42009****
Regionsarray<object>

The regions.

Regionobject
LocalNamestring

The region name. Valid values:

  • China (Hangzhou)
  • China (Shanghai)
  • China (Beijing)
  • China (Zhangjiakou)
  • China (Shenzhen)
  • China (Guangzhou)
  • China (Hong Kong)
  • Singapore
  • US (Silicon Valley)
RegionEndpointstring

The endpoint for the region. Valid values:

  • sae.cn-hangzhou.aliyuncs.com
  • sae.cn-shanghai.aliyuncs.com
  • sae.cn-beijing.aliyuncs.com
  • sae.cn-zhangjiakou.aliyuncs.com
  • sae.cn-shenzhen.aliyuncs.com
  • sae.cn-guangzhou.aliyuncs.com
  • sae.cn-hongkong.aliyuncs.com
  • sae.ap-southeast-1.aliyuncs.com
  • sae.us-west-1.aliyuncs.com
sae.cn-shanghai.aliyuncs.com
RegionIdstring

The region ID. Valid values:

  • cn-hangzhou: the ID of the China (Hangzhou) region
  • cn-shanghai: the ID of the China (Shanghai) region
  • cn-beijing: the ID of the China (Beijing) region
  • cn-zhangjiakou: the ID of the China (Zhangjiakou) region
  • cn-shenzhen: the ID of the China (Shenzhen) region
  • cn-guangzhou: the ID of the China (Guangzhou) region
  • cn-hongkong: the ID of the China (Hong Kong) region
  • ap-southeast-1: the ID of the Singapore region
  • us-west-1: the ID of the US (Silicon Valley) region
cn-shanghai
RecommendZonesarray

The recommended zones.

RecommendZonestring

The recommended zones. Recommended zones have relatively sufficient resources in each region. Format:

  • If a region contains recommended zones, this parameter is returned in the "RecommendZone": ["cn-hongkong-b", "cn-hongkong-d", "cn-hongkong-c"] format.
  • If a region does not contain recommended zones, this parameter is returned in the "RecommendZone": [] format.
cn-hongkong-b
Codeinteger

The HTTP status code. Valid values:

  • 2xx: The call was successful.
  • 3xx: The call was redirected.
  • 4xx: The call failed.
  • 5xx: A server error occurred.
200

Examples

Sample success responses

JSONformat

{
  "Message": "success",
  "RequestId": "DDE85827-B0B3-4E56-86E8-17C42009****",
  "Regions": {
    "Region": [
      {
        "LocalName": "",
        "RegionEndpoint": "sae.cn-shanghai.aliyuncs.com",
        "RegionId": "cn-shanghai",
        "RecommendZones": {
          "RecommendZone": [
            "cn-hongkong-b"
          ]
        }
      }
    ]
  },
  "Code": 200
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2021-11-25The response structure of the API has changedView Change Details