接口功能
该接口DescribeRegions用于查询可以使用阿里云的地域信息。
需求背景
目前,接口DescribeRegions查询出来的地域信息中,地域名称仅支持中文显示,并且没有地域相关联的 Endpoint 信息。
请求与返回
接口DescribeRegions的请求入参中添加字段AcceptLanguage,用于丰富和区分支持的语言类型,具体的参数信息如下:
参数名称 | 类型 | 是否必需 | 描述 |
---|---|---|---|
AcceptLanguage | String | 否 | 参照国际标准 RFC7231,后端服务根据用户语言类型需要返回相应的结果
|
接口 DescribeRegions 返回参数如下:
名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 请求ID |
Regions | RegionType | 地域信息RegionType集合 |
RegionType 类型如下:
名称 | 类型 | 描述 |
---|---|---|
RegionId | String | Region Id |
LocalName | String | Region 名称(中文、英文、日文 ) |
RegionEndpoint | String | Region 服务的 Endpoint 地址 |
返回示例:
/*中文结果*/
{
"RequestId":"RequestId",
"Regions":{
"Region":[
{
"RegionId":"cn-qingdao",
"RegionEndpoint":"ecs.aliyuncs.com",
"LocalName":"华北1(青岛)"
},
{
"RegionId":"cn-beijing",
"RegionEndpoint":"ecs.aliyuncs.com",
"LocalName":"华北2(北京)"
},
{
"RegionId":"cn-zhangjiakou",
"RegionEndpoint":"ecs.cn-zhangjiakou.aliyuncs.com",
"LocalName":"华北3(张家口)"
}
]
}
}
/*英文结果*/
{
"RequestId":"RequestId",
"Regions":{
"Region":[
{
"RegionId":"cn-qingdao",
"RegionEndpoint":"ecs.aliyuncs.com",
"LocalName":"China (Qingdao)"
},
{
"RegionId":"cn-beijing",
"RegionEndpoint":"ecs.aliyuncs.com",
"LocalName":"China (Beijing)"
},
{
"RegionId":"cn-zhangjiakou",
"RegionEndpoint":"ecs.cn-zhangjiakou.aliyuncs.com",
"LocalName":"China (Zhangjiakou)"
}
]
}
}
/*日文结果*/
{
"RequestId":"RequestId",
"Regions":{
"Region":[
{
"RegionId":"cn-qingdao",
"RegionEndpoint":"ecs.aliyuncs.com",
"LocalName":"中国北部(青島)"
},
{
"RegionId":"cn-beijing",
"RegionEndpoint":"ecs.aliyuncs.com",
"LocalName":"中国北部(北京)"
},
{
"RegionId":"cn-zhangjiakou",
"RegionEndpoint":"ecs.cn-zhangjiakou.aliyuncs.com",
"LocalName":"中国北部(張家口)"
},
{
"RegionId":"cn-huhehaote",
"RegionEndpoint":"ecs.cn-huhehaote.aliyuncs.com",
"LocalName":"中国北部(フフホト)"
}
]
}
}