Queries the regions and zones in which AnalyticDB for MySQL is available.

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.

AcceptLanguage String No en-US

The language used for the region and zone names specified by the LocalName parameter. Valid values:

  • zh-CN: Chinese
  • en-US: English
  • ja: Japanese
Note If this parameter is left empty, Chinese is used.

Response parameters

Parameter Type Example Description
RequestId String C3A9594F-1D40-4472-A96C-8FB8AA******

The ID of the request.

Regions Array of Region

The list of regions.

Region
Zones Array of Zone

The list of zones.

Zone
LocalName String Hangzhou Zone H

The name of the zone.

ZoneId String cn-hangzhou-h

The ID of the zone.

VpcEnabled Boolean true

Indicates whether Virtual Private Cloud (VPC) is available in the zone that you want to select. Valid values:

  • true: VPC is available.
  • false: VPC is unavailable.
LocalName String China (Hangzhou)

The name of the region.

RegionEndpoint String adb.aliyuncs.com

The endpoint of the region.

RegionId String cn-hangzhou

The ID of the region.

Examples

Sample requests

http(s)://adb.aliyuncs.com/?Action=DescribeRegions
&<Common request parameters>

Sample success responses

XML format

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

<DescribeRegionsResponse>
    <RequestId>C3A9594F-1D40-4472-A96C-8FB8AA******</RequestId>
    <Regions>
        <Region>
            <RegionId>cn-hangzhou</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Hangzhou)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-hangzhou-h</ZoneId>
                    <LocalName>Hangzhou Zone H</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-hangzhou-g</ZoneId>
                    <LocalName>Hangzhou Zone G</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>cn-shanghai</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Shanghai)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-shanghai-e</ZoneId>
                    <LocalName>Shanghai Zone E</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-shanghai-g</ZoneId>
                    <LocalName>Shanghai Zone G</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-shanghai-f</ZoneId>
                    <LocalName>Shanghai Zone F</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>cn-qingdao</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Qingdao)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-qingdao-c</ZoneId>
                    <LocalName>Qingdao Zone C</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>cn-beijing</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Beijing)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-beijing-h</ZoneId>
                    <LocalName>Beijing Zone H</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-beijing-f</ZoneId>
                    <LocalName>Beijing Zone F</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-beijing-g</ZoneId>
                    <LocalName>Beijing Zone G</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>cn-zhangjiakou</RegionId>
            <RegionEndpoint>adb.cn-zhangjiakou.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Zhangjiakou)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-zhangjiakou-c</ZoneId>
                    <LocalName>Zhangjiakou Zone C</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-zhangjiakou-b</ZoneId>
                    <LocalName>Zhangjiakou Zone B</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-zhangjiakou-a</ZoneId>
                    <LocalName>Zhangjiakou Zone A</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>cn-shenzhen</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Shenzhen)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-shenzhen-d</ZoneId>
                    <LocalName>Shenzhen Zone D</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-shenzhen-e</ZoneId>
                    <LocalName>Shenzhen Zone E</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>cn-hongkong</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>China (Hong Kong)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-hongkong-a</ZoneId>
                    <LocalName>Hong Kong Zone A</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-hongkong-b</ZoneId>
                    <LocalName>Hong Kong Zone B</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>cn-hongkong-c</ZoneId>
                    <LocalName>Hong Kong Zone C</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>ap-southeast-1</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>Singapore</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>ap-southeast-1b</ZoneId>
                    <LocalName>Singapore Zone B</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>ap-southeast-2</RegionId>
            <RegionEndpoint>adb.ap-southeast-2.aliyuncs.com</RegionEndpoint>
            <LocalName>Australia (Sydney)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>ap-southeast-2a</ZoneId>
                    <LocalName>Sydney Zone A</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>ap-southeast-3</RegionId>
            <RegionEndpoint>adb.ap-southeast-3.aliyuncs.com</RegionEndpoint>
            <LocalName>Malaysia (Kuala Lumpur)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>ap-southeast-3b</ZoneId>
                    <LocalName>Kuala Lumpur Zone B</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>ap-southeast-3a</ZoneId>
                    <LocalName>Kuala Lumpur Zone A</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>ap-southeast-5</RegionId>
            <RegionEndpoint>adb.ap-southeast-5.aliyuncs.com</RegionEndpoint>
            <LocalName>Indonesia (Jakarta)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>ap-southeast-5a</ZoneId>
                    <LocalName>Jakarta Zone A</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>ap-northeast-1</RegionId>
            <RegionEndpoint>adb.ap-northeast-1.aliyuncs.com</RegionEndpoint>
            <LocalName>Japan (Tokyo)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>ap-northeast-1b</ZoneId>
                    <LocalName>Tokyo Zone B</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>ap-northeast-1a</ZoneId>
                    <LocalName>Tokyo Zone A</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>ap-south-1</RegionId>
            <RegionEndpoint>adb.ap-south-1.aliyuncs.com</RegionEndpoint>
            <LocalName>India (Mumbai)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>ap-south-1b</ZoneId>
                    <LocalName>Mumbai Zone B</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>eu-central-1</RegionId>
            <RegionEndpoint>adb.eu-central-1.aliyuncs.com</RegionEndpoint>
            <LocalName>Germany (Frankfurt)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>eu-central-1a</ZoneId>
                    <LocalName>Frankfurt Zone A</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>eu-west-1</RegionId>
            <RegionEndpoint>adb.eu-west-1.aliyuncs.com</RegionEndpoint>
            <LocalName>UK (London)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>eu-west-1a</ZoneId>
                    <LocalName>London Zone A</LocalName>
                </Zone>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>eu-west-1b</ZoneId>
                    <LocalName>London Zone B</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>us-west-1</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>US (Silicon Valley)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>us-west-1a</ZoneId>
                    <LocalName>Silicon Valley Zone A</LocalName>
                </Zone>
            </Zones>
        </Region>
        <Region>
            <RegionId>us-east-1</RegionId>
            <RegionEndpoint>adb.aliyuncs.com</RegionEndpoint>
            <LocalName>US (Virginia)</LocalName>
            <Zones>
                <Zone>
                    <VpcEnabled>true</VpcEnabled>
                    <ZoneId>us-east-1b</ZoneId>
                    <LocalName>Virginia Zone B</LocalName>
                </Zone>
            </Zones>
        </Region>
    </Regions>
</DescribeRegionsResponse>

JSON format

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

{
  "RequestId" : "C3A9594F-1D40-4472-A96C-8FB8AA******",
  "Regions" : {
    "Region" : [ {
      "RegionId" : "cn-hangzhou",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "China (Hangzhou)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-hangzhou-h",
          "LocalName" : "Hangzhou Zone H"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-hangzhou-g",
          "LocalName" : "Hangzhou Zone G"
        } ]
      }
    }, {
      "RegionId" : "cn-shanghai",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "China (Shanghai)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-shanghai-e",
          "LocalName" : "Shanghai Zone E"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-shanghai-g",
          "LocalName" : "Shanghai Zone G"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-shanghai-f",
          "LocalName" : "Shanghai Zone F"
        } ]
      }
    }, {
      "RegionId" : "cn-qingdao",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "China (Qingdao)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-qingdao-c",
          "LocalName" : "Qingdao Zone C"
        } ]
      }
    }, {
      "RegionId" : "cn-beijing",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "China (Beijing)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-beijing-h",
          "LocalName" : "Beijing Zone H"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-beijing-f",
          "LocalName" : "Beijing Zone F"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-beijing-g",
          "LocalName" : "Beijing Zone G"
        } ]
      }
    }, {
      "RegionId" : "cn-zhangjiakou",
      "RegionEndpoint" : "adb.cn-zhangjiakou.aliyuncs.com",
      "LocalName" : "China (Zhangjiakou)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-zhangjiakou-c",
          "LocalName" : "Zhangjiakou Zone C"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-zhangjiakou-b",
          "LocalName" : "Zhangjiakou Zone B"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-zhangjiakou-a",
          "LocalName" : "Zhangjiakou Zone A"
        } ]
      }
    }, {
      "RegionId" : "cn-shenzhen",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "China (Shenzhen)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-shenzhen-d",
          "LocalName" : "Shenzhen Zone D"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-shenzhen-e",
          "LocalName" : "Shenzhen Zone E"
        } ]
      }
    }, {
      "RegionId" : "cn-hongkong",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "China (Hong Kong)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "cn-hongkong-a",
          "LocalName" : "Hong Kong Zone A"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-hongkong-b",
          "LocalName" : "Hong Kong Zone B"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "cn-hongkong-c",
          "LocalName" : "Hong Kong Zone C"
        } ]
      }
    }, {
      "RegionId" : "ap-southeast-1",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "Singapore",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-1b",
          "LocalName" : "Singapore Zone B"
        } ]
      }
    }, {
      "RegionId" : "ap-southeast-2",
      "RegionEndpoint" : "adb.ap-southeast-2.aliyuncs.com",
      "LocalName" : "Australia (Sydney)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-2a",
          "LocalName" : "Sydney Zone A"
        } ]
      }
    }, {
      "RegionId" : "ap-southeast-3",
      "RegionEndpoint" : "adb.ap-southeast-3.aliyuncs.com",
      "LocalName" : "Malaysia (Kuala Lumpur)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-3b",
          "LocalName" : "Kuala Lumpur Zone B"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-3a",
          "LocalName" : "Kuala Lumpur Zone A"
        } ]
      }
    }, {
      "RegionId" : "ap-southeast-5",
      "RegionEndpoint" : "adb.ap-southeast-5.aliyuncs.com",
      "LocalName" : "Indonesia (Jakarta)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-southeast-5a",
          "LocalName" : "Jakarta Zone A"
        } ]
      }
    }, {
      "RegionId" : "ap-northeast-1",
      "RegionEndpoint" : "adb.ap-northeast-1.aliyuncs.com",
      "LocalName" : "Japan (Tokyo)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-northeast-1b",
          "LocalName" : "Tokyo Zone B"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "ap-northeast-1a",
          "LocalName" : "Tokyo Zone A"
        } ]
      }
    }, {
      "RegionId" : "ap-south-1",
      "RegionEndpoint" : "adb.ap-south-1.aliyuncs.com",
      "LocalName" : "India (Mumbai)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "ap-south-1b",
          "LocalName" : "Mumbai Zone B"
        } ]
      }
    }, {
      "RegionId" : "eu-central-1",
      "RegionEndpoint" : "adb.eu-central-1.aliyuncs.com",
      "LocalName" : "Germany (Frankfurt)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "eu-central-1a",
          "LocalName" : "Frankfurt Zone A"
        } ]
      }
    }, {
      "RegionId" : "eu-west-1",
      "RegionEndpoint" : "adb.eu-west-1.aliyuncs.com",
      "LocalName" : "UK (London)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "eu-west-1a",
          "LocalName" : "London Zone A"
        }, {
          "VpcEnabled" : true,
          "ZoneId" : "eu-west-1b",
          "LocalName" : "London Zone B"
        } ]
      }
    }, {
      "RegionId" : "us-west-1",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "US (Silicon Valley)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "us-west-1a",
          "LocalName" : "Silicon Valley Zone A"
        } ]
      }
    }, {
      "RegionId" : "us-east-1",
      "RegionEndpoint" : "adb.aliyuncs.com",
      "LocalName" : "US (Virginia)",
      "Zones" : {
        "Zone" : [ {
          "VpcEnabled" : true,
          "ZoneId" : "us-east-1b",
          "LocalName" : "Virginia Zone B"
        } ]
      }
    } ]
  }
}

Error codes

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