调用DescribeRegions查询可用地域。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeRegions |
要执行的操作。 取值:DescribeRegions。 |
AcceptLanguage | String | 否 | zh-CN |
支持的语言。包括以下取值:
|
RegionId | String | 是 | cn-hangzhou |
地域ID。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Regions | Array of Region |
地域列表。 |
|
Region | |||
RegionId | String | cn-beijing |
地域ID。 |
LocalName | String | 华北2(北京) |
地域名称。 |
RegionEndpoint | String | slb.aliyuncs.com |
地域服务的终端节点地址。 |
RequestId | String | 1651FBB6-4FBF-49FF-A9F5-DF5D696C7EC6 |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=DescribeRegions
&<公共请求参数>
正常返回示例
XML
格式
<DescribeRegionsResponse>
<RequestId>3F4E9DDA-CE30-5A46-AAC0-794CE4527E76</RequestId>
<Regions>
<Region>
<RegionId>cn-hangzhou</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>华东1(杭州)</LocalName>
</Region>
<Region>
<RegionId>cn-shanghai</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>华东2(上海)</LocalName>
</Region>
<Region>
<RegionId>cn-qingdao</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>华北1(青岛)</LocalName>
</Region>
<Region>
<RegionId>cn-beijing</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>华北2(北京)</LocalName>
</Region>
<Region>
<RegionId>cn-zhangjiakou</RegionId>
<RegionEndpoint>slb.cn-zhangjiakou.aliyuncs.com</RegionEndpoint>
<LocalName>华北3(张家口)</LocalName>
</Region>
<Region>
<RegionId>cn-huhehaote</RegionId>
<RegionEndpoint>slb.cn-huhehaote.aliyuncs.com</RegionEndpoint>
<LocalName>华北5(呼和浩特)</LocalName>
</Region>
<Region>
<RegionId>cn-wulanchabu</RegionId>
<RegionEndpoint>slb.cn-wulanchabu.aliyuncs.com</RegionEndpoint>
<LocalName>华北6(乌兰察布)</LocalName>
</Region>
<Region>
<RegionId>cn-shenzhen</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>华南1(深圳)</LocalName>
</Region>
<Region>
<RegionId>cn-heyuan</RegionId>
<RegionEndpoint>slb.cn-heyuan.aliyuncs.com</RegionEndpoint>
<LocalName>华南2(河源)</LocalName>
</Region>
<Region>
<RegionId>cn-guangzhou</RegionId>
<RegionEndpoint>slb.cn-guangzhou.aliyuncs.com</RegionEndpoint>
<LocalName>华南3(广州)</LocalName>
</Region>
<Region>
<RegionId>cn-chengdu</RegionId>
<RegionEndpoint>slb.cn-chengdu.aliyuncs.com</RegionEndpoint>
<LocalName>西南1(成都)</LocalName>
</Region>
<Region>
<RegionId>cn-hongkong</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>中国(香港)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-1</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>新加坡</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-2</RegionId>
<RegionEndpoint>slb.ap-southeast-2.aliyuncs.com</RegionEndpoint>
<LocalName>澳大利亚(悉尼)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-3</RegionId>
<RegionEndpoint>slb.ap-southeast-3.aliyuncs.com</RegionEndpoint>
<LocalName>马来西亚(吉隆坡)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-5</RegionId>
<RegionEndpoint>slb.ap-southeast-5.aliyuncs.com</RegionEndpoint>
<LocalName>印度尼西亚(雅加达)</LocalName>
</Region>
<Region>
<RegionId>ap-northeast-1</RegionId>
<RegionEndpoint>slb.ap-northeast-1.aliyuncs.com</RegionEndpoint>
<LocalName>日本(东京)</LocalName>
</Region>
<Region>
<RegionId>ap-south-1</RegionId>
<RegionEndpoint>slb.ap-south-1.aliyuncs.com</RegionEndpoint>
<LocalName>印度(孟买)</LocalName>
</Region>
<Region>
<RegionId>eu-central-1</RegionId>
<RegionEndpoint>slb.eu-central-1.aliyuncs.com</RegionEndpoint>
<LocalName>德国(法兰克福)</LocalName>
</Region>
<Region>
<RegionId>eu-west-1</RegionId>
<RegionEndpoint>slb.eu-west-1.aliyuncs.com</RegionEndpoint>
<LocalName>英国(伦敦)</LocalName>
</Region>
<Region>
<RegionId>us-west-1</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>美国(硅谷)</LocalName>
</Region>
<Region>
<RegionId>us-east-1</RegionId>
<RegionEndpoint>slb.aliyuncs.com</RegionEndpoint>
<LocalName>美国(弗吉尼亚)</LocalName>
</Region>
<Region>
<RegionId>me-east-1</RegionId>
<RegionEndpoint>slb.me-east-1.aliyuncs.com</RegionEndpoint>
<LocalName>阿联酋(迪拜)</LocalName>
</Region>
<Region>
<RegionId>ap-southeast-6</RegionId>
<RegionEndpoint>slb.ap-southeast-6.aliyuncs.com</RegionEndpoint>
<LocalName>菲律宾(马尼拉)</LocalName>
</Region>
</Regions>
</DescribeRegionsResponse>
JSON
格式
{
"RequestId": "3F4E9DDA-CE30-5A46-AAC0-794CE4527E76",
"Regions": {
"Region": [
{
"RegionId": "cn-hangzhou",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "华东1(杭州)"
},
{
"RegionId": "cn-shanghai",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "华东2(上海)"
},
{
"RegionId": "cn-qingdao",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "华北1(青岛)"
},
{
"RegionId": "cn-beijing",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "华北2(北京)"
},
{
"RegionId": "cn-zhangjiakou",
"RegionEndpoint": "slb.cn-zhangjiakou.aliyuncs.com",
"LocalName": "华北3(张家口)"
},
{
"RegionId": "cn-huhehaote",
"RegionEndpoint": "slb.cn-huhehaote.aliyuncs.com",
"LocalName": "华北5(呼和浩特)"
},
{
"RegionId": "cn-wulanchabu",
"RegionEndpoint": "slb.cn-wulanchabu.aliyuncs.com",
"LocalName": "华北6(乌兰察布)"
},
{
"RegionId": "cn-shenzhen",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "华南1(深圳)"
},
{
"RegionId": "cn-heyuan",
"RegionEndpoint": "slb.cn-heyuan.aliyuncs.com",
"LocalName": "华南2(河源)"
},
{
"RegionId": "cn-guangzhou",
"RegionEndpoint": "slb.cn-guangzhou.aliyuncs.com",
"LocalName": "华南3(广州)"
},
{
"RegionId": "cn-chengdu",
"RegionEndpoint": "slb.cn-chengdu.aliyuncs.com",
"LocalName": "西南1(成都)"
},
{
"RegionId": "cn-hongkong",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "中国(香港)"
},
{
"RegionId": "ap-southeast-1",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "新加坡"
},
{
"RegionId": "ap-southeast-2",
"RegionEndpoint": "slb.ap-southeast-2.aliyuncs.com",
"LocalName": "澳大利亚(悉尼)"
},
{
"RegionId": "ap-southeast-3",
"RegionEndpoint": "slb.ap-southeast-3.aliyuncs.com",
"LocalName": "马来西亚(吉隆坡)"
},
{
"RegionId": "ap-southeast-5",
"RegionEndpoint": "slb.ap-southeast-5.aliyuncs.com",
"LocalName": "印度尼西亚(雅加达)"
},
{
"RegionId": "ap-northeast-1",
"RegionEndpoint": "slb.ap-northeast-1.aliyuncs.com",
"LocalName": "日本(东京)"
},
{
"RegionId": "ap-south-1",
"RegionEndpoint": "slb.ap-south-1.aliyuncs.com",
"LocalName": "印度(孟买)"
},
{
"RegionId": "eu-central-1",
"RegionEndpoint": "slb.eu-central-1.aliyuncs.com",
"LocalName": "德国(法兰克福)"
},
{
"RegionId": "eu-west-1",
"RegionEndpoint": "slb.eu-west-1.aliyuncs.com",
"LocalName": "英国(伦敦)"
},
{
"RegionId": "us-west-1",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "美国(硅谷)"
},
{
"RegionId": "us-east-1",
"RegionEndpoint": "slb.aliyuncs.com",
"LocalName": "美国(弗吉尼亚)"
},
{
"RegionId": "me-east-1",
"RegionEndpoint": "slb.me-east-1.aliyuncs.com",
"LocalName": "阿联酋(迪拜)"
},
{
"RegionId": "ap-southeast-6",
"RegionEndpoint": "slb.ap-southeast-6.aliyuncs.com",
"LocalName": "菲律宾(马尼拉)"
}
]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidParameter | InvalidParameter | 参数无效。请检查参数约束,并在修改后重试。 |
400 | InvalidParameter | Illegal parameter, query.namespace is not auth. | query.namespace未授权,请您先授权再操作。 |
访问错误中心查看更多错误码。