调用DescribeRegions接口查询您可以使用的阿里云地域。

更多信息,请参见地域和可用区

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeRegions

要执行的操作,取值:DescribeRegions。

AcceptLanguage String en-US

地域名称支持的语言,取值:

  • zh-CN:中文。
  • en-US(默认值):英文。

关于公共请求参数的详情,请参见公共参数

返回数据

名称 类型 示例值 描述
RequestId String ACA7C814-12BC-4D81-A0D2-72071C9D6D2C

请求ID。

Regions Array of Region

地域列表。

Region
RegionId String cn-hangzhou

地域ID。

RegionEndpoint String actiontrail.cn-hangzhou.aliyuncs.com

接入地址。

LocalName String China (Hangzhou)

地域名称。

说明 当AcceptLanguage取值为zh-CN时,返回中文。当AcceptLanguage取值为zh-US或不指定时,返回英文。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeRegions
&AcceptLanguage=en-US
&公共请求参数

正常返回示例

JSON格式

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

{
  "RequestId" : "ACA7C814-12BC-4D81-A0D2-72071C9D6D2C",
  "Regions" : {
    "Region" : [ {
      "RegionId" : "cn-hangzhou",
      "RegionEndpoint" : "actiontrail.cn-hangzhou.aliyuncs.com",
      "LocalName" : "China (Hangzhou)"
    }, {
      "RegionId" : "cn-shanghai",
      "RegionEndpoint" : "actiontrail.cn-shanghai.aliyuncs.com",
      "LocalName" : "China (Shanghai)"
    }, {
      "RegionId" : "cn-qingdao",
      "RegionEndpoint" : "actiontrail.cn-qingdao.aliyuncs.com",
      "LocalName" : "China (Qingdao)"
    }, {
      "RegionId" : "cn-beijing",
      "RegionEndpoint" : "actiontrail.cn-beijing.aliyuncs.com",
      "LocalName" : "China (Beijing)"
    }, {
      "RegionId" : "cn-zhangjiakou",
      "RegionEndpoint" : "actiontrail.cn-zhangjiakou.aliyuncs.com",
      "LocalName" : "China (Zhangjiakou)"
    }, {
      "RegionId" : "cn-huhehaote",
      "RegionEndpoint" : "actiontrail.cn-huhehaote.aliyuncs.com",
      "LocalName" : "China (Hohhot)"
    }, {
      "RegionId" : "cn-shenzhen",
      "RegionEndpoint" : "actiontrail.cn-shenzhen.aliyuncs.com",
      "LocalName" : "China (Shenzhen)"
    }, {
      "RegionId" : "cn-heyuan",
      "RegionEndpoint" : "actiontrail.cn-heyuan.aliyuncs.com",
      "LocalName" : "China (Heyuan)"
    }, {
      "RegionId" : "cn-guangzhou",
      "RegionEndpoint" : "actiontrail.cn-guangzhou.aliyuncs.com",
      "LocalName" : "China (Guangzhou)"
    }, {
      "RegionId" : "cn-chengdu",
      "RegionEndpoint" : "actiontrail.cn-chengdu.aliyuncs.com",
      "LocalName" : "China (Chengdu)"
    }, {
      "RegionId" : "cn-hongkong",
      "RegionEndpoint" : "actiontrail.cn-hongkong.aliyuncs.com",
      "LocalName" : "China (Hong Kong)"
    }, {
      "RegionId" : "ap-southeast-1",
      "RegionEndpoint" : "actiontrail.ap-southeast-1.aliyuncs.com",
      "LocalName" : "Singapore"
    }, {
      "RegionId" : "ap-southeast-2",
      "RegionEndpoint" : "actiontrail.ap-southeast-2.aliyuncs.com",
      "LocalName" : "Australia (Sydney)"
    }, {
      "RegionId" : "ap-southeast-3",
      "RegionEndpoint" : "actiontrail.ap-southeast-3.aliyuncs.com",
      "LocalName" : "Malaysia (Kuala Lumpur)"
    }, {
      "RegionId" : "ap-southeast-5",
      "RegionEndpoint" : "actiontrail.ap-southeast-5.aliyuncs.com",
      "LocalName" : "Indonesia (Jakarta)"
    }, {
      "RegionId" : "ap-northeast-1",
      "RegionEndpoint" : "actiontrail.ap-northeast-1.aliyuncs.com",
      "LocalName" : "Japan (Tokyo)"
    }, {
      "RegionId" : "ap-south-1",
      "RegionEndpoint" : "actiontrail.ap-south-1.aliyuncs.com",
      "LocalName" : "India (Mumbai)"
    }, {
      "RegionId" : "eu-central-1",
      "RegionEndpoint" : "actiontrail.eu-central-1.aliyuncs.com",
      "LocalName" : "Germany (Frankfurt)"
    }, {
      "RegionId" : "eu-west-1",
      "RegionEndpoint" : "actiontrail.eu-west-1.aliyuncs.com",
      "LocalName" : "UK (London)"
    }, {
      "RegionId" : "us-west-1",
      "RegionEndpoint" : "actiontrail.us-west-1.aliyuncs.com",
      "LocalName" : "US (Silicon Valley)"
    }, {
      "RegionId" : "us-east-1",
      "RegionEndpoint" : "actiontrail.us-east-1.aliyuncs.com",
      "LocalName" : "US (Virginia)"
    }, {
      "RegionId" : "me-east-1",
      "RegionEndpoint" : "actiontrail.me-east-1.aliyuncs.com",
      "LocalName" : "UAE (Dubai)"
    } ]
  }
}

错误码

访问错误中心查看更多错误码。