Queries the Alibaba Cloud regions where Simple Application Server is available.


The query results include all the Alibaba Cloud regions where Simple Application Server is available on the International site (alibabacloud.com) and the China site (aliyun.com).

QPS limits

The queries per second (QPS) limit for a single user for the API operation is 10 calls per minute. If the number of calls to the API operation per minute exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limit.

Request parameters

Parameter Type Required Example Description
Action String Yes ListRegions

The operation that you want to perform. Set the value to ListRegions.

Response parameters

Parameter Type Example Description
RequestId String 20758A-585D-4A41-A9B2-28DA8F4F534F

The ID of the request.

Regions Array of Region

Details about the regions.

LocalName String China (Hangzhou)

The name of the region.

RegionEndpoint String swas.cn-hangzhou.aliyuncs.com

The endpoint of the region.

RegionId String cn-hangzhou

The ID of the region.


Sample requests

&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK

        <LocalName>China (Qingdao)</LocalName>
        <LocalName>China (Beijing)</LocalName>
        <LocalName>China (Zhangjiakou)</LocalName>
        <LocalName>China (Hohhot)</LocalName>
        <LocalName>China (Hangzhou)</LocalName>
        <LocalName>China (Shanghai)</LocalName>
        <LocalName>China (Shenzhen)</LocalName>
        <LocalName>China (Hong Kong)</LocalName>
        <LocalName>Singapore (Singapore)</LocalName>

JSON format

HTTP/1.1 200 OK

  "RequestId" : "20758A-585D-4A41-A9B2-28DA8F4F534F",
  "Regions" : [ {
    "RegionId" : "cn-qingdao",
    "RegionEndpoint" : "swas.cn-qingdao.aliyuncs.com",
    "LocalName": "China (Qingdao)"
  }, {
    "RegionId" : "cn-beijing",
    "RegionEndpoint" : "swas.cn-beijing.aliyuncs.com",
    "localName": "China (Beijing)",
  }, {
    "RegionId" : "cn-zhangjiakou",
    "RegionEndpoint" : "swas.cn-zhangjiakou.aliyuncs.com",
    "localName": "China (Zhangjiakou)",
  }, {
    "RegionId" : "cn-huhehaote",
    "RegionEndpoint" : "swas.cn-huhehaote.aliyuncs.com",
    "localName": "China (Hohhot)",
  }, {
    "RegionId" : "cn-hangzhou",
    "RegionEndpoint" : "swas.cn-hangzhou.aliyuncs.com",
    "LocalName":"China (Hangzhou)"
  }, {
    "RegionId" : "cn-shanghai",
    "RegionEndpoint" : "swas.cn-shanghai.aliyuncs.com",
    "localName": "China (Shanghai)",
  }, {
    "RegionId" : "cn-shenzhen",
    "RegionEndpoint" : "swas.cn-shenzhen.aliyuncs.com",
    "localName": "China (Shenzhen)",
  }, {
    "RegionId" : "cn-hongkong",
    "RegionEndpoint" : "swas.cn-hongkong.aliyuncs.com",
    "LocalName": "China (Hong Kong)"
  }, {
    "RegionId" : "ap-southeast-1",
    "RegionEndpoint" : "swas.ap-southeast-1.aliyuncs.com",
    "LocalName": "Singapore (Singapore)"
  } ]

Error codes

HTTP status code Error code Error message Description
500 InternalError An error occurred while processing your request. The error message returned because an internal error has occurred. Try again later. If the problem persists, submit a ticket.

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