Queries the regions and zones where AnalyticDB for PostgreSQL is available.

Description

Before you create an AnalyticDB for PostgreSQL instance, you must call this operation to query available regions and zones.

Limit

You can call this operation up to 1,000 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered and may affect your business. We recommend that you take note of the limit when you call this operation.

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 parameters

Parameter Type Required Example Description
Action String Yes DescribeRegions

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

Region String No cn-hangzhou

The ID of the region.

Note You can call the DescribeRegions operation to query the most recent region list.

Response parameters

Parameter Type Example Description
RequestId String FF8EB261-5447-4B1B-9F14-294CEA008A9F

The ID of the request.

Regions Array of Region

Details of the regions.

Region
Zones Array of Zone

Details of the zones.

Zone
ZoneId String cn-hangzhou-c

The ID of the zone.

VpcEnabled Boolean true

Indicates whether Virtual Private Cloud (VPC) is available.

  • true: VPC is available.
  • false: VPC is unavailable.
RegionId String cn-hangzhou

The ID of the region.

Examples

Sample requests

https://gpdb.aliyuncs.com/?Action=DescribeRegions
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<RequestId>FF8EB261-5447-4B1B-9F14-294CEA008A9F</RequestId>
<Regions>
    <Region>
        <RegionId>cn-beijing</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-beijing-c</ZoneId>
            </Zone>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-beijing-g</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>cn-zhangjiakou</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-zhangjiakou-b</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>cn-hangzhou</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-hangzhou-b</ZoneId>
            </Zone>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-hangzhou-e</ZoneId>
            </Zone>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-hangzhou-f</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>cn-shanghai</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-shanghai-b</ZoneId>
            </Zone>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-shanghai-d</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>cn-shenzhen</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-shenzhen-a</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>ap-southeast-1</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>ap-southeast-1b</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>ap-southeast-2</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>ap-southeast-2a</ZoneId>
            </Zone>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>ap-southeast-2b</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>us-east-1</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>us-east-1b</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>us-west-1</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>us-west-1a</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>cn-chengdu</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-chengdu-a</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>ap-southeast-3</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>ap-southeast-3a</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>cn-huhehaote</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>cn-huhehaote-a</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>ap-south-1</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>ap-south-1a</ZoneId>
            </Zone>
        </Zones>
    </Region>
    <Region>
        <RegionId>ap-southeast-5</RegionId>
        <Zones>
            <Zone>
                <VpcEnabled>true</VpcEnabled>
                <ZoneId>ap-southeast-5a</ZoneId>
            </Zone>
        </Zones>
    </Region>
</Regions>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "FF8EB261-5447-4B1B-9F14-294CEA008A9F",
  "Regions" : {
    "Region" : [ {
      "RegionId" : "cn-beijing",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-beijing-c"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-beijing-g"
        } ]
      }
    }, {
      "RegionId" : "cn-zhangjiakou",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-zhangjiakou-b"
        } ]
      }
    }, {
      "RegionId" : "cn-hangzhou",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-hangzhou-b"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-hangzhou-e"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-hangzhou-f"
        } ]
      }
    }, {
      "RegionId" : "cn-shanghai",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-shanghai-b"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-shanghai-d"
        } ]
      }
    }, {
      "RegionId" : "cn-shenzhen",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-shenzhen-a"
        } ]
      }
    }, {
      "RegionId" : "ap-southeast-1",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-1b"
        } ]
      }
    }, {
      "RegionId" : "ap-southeast-2",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-2a"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-2b"
        } ]
      }
    }, {
      "RegionId" : "us-east-1",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "us-east-1b"
        } ]
      }
    }, {
      "RegionId" : "us-west-1",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "us-west-1a"
        } ]
      }
    }, {
      "RegionId" : "cn-chengdu",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-chengdu-a"
        } ]
      }
    }, {
      "RegionId" : "ap-southeast-3",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-3a"
        } ]
      }
    }, {
      "RegionId" : "cn-huhehaote",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-huhehaote-a"
        } ]
      }
    }, {
      "RegionId" : "ap-south-1",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-south-1a"
        } ]
      }
    }, {
      "RegionId" : "ap-southeast-5",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-5a"
        } ]
      }
    } ]
  }
}

Error codes

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