调用DescribeRegions接口查询您可以使用的阿里云地域。
更多信息,请参见地域和可用区。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeRegions |
要执行的操作,取值:DescribeRegions。 |
AcceptLanguage | String | 否 | 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)"
} ]
}
}
错误码
访问错误中心查看更多错误码。