接口功能
該接口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":"中國北部(フフホト)"
}
]
}
}