接口功能
該接口DescribeRegions用于查詢可以使用阿裡雲的地域資訊。
需求背景
目前,接口DescribeRegions查詢出來的地域資訊中,地域名稱僅支援中文顯示,并且沒有地域相關聯的 Endpoint 資訊。
請求與傳回
接口DescribeRegions的請求入參中添加字段AcceptLanguage,用于豐富和區分支援的語言類型,具體的參數資訊如下:
參數名稱 | 類型 | 是否必需 | 描述 |
---|---|---|---|
AcceptLanguage | String | 否 | 參照國際标準 RFC7231,後端服務根據使用者語言類型需要傳回相應的結果
|
接口 DescribeRegions 傳回參數如下:
名稱 | ||
---|---|---|
RequestId | 請求ID | |
Regions | RegionType | 地域資訊RegionType集合 |
RegionType 類型如下:
RegionId | Region Id | |
LocalName | Region 名稱(中文、英文、日文 ) | |
RegionEndpoint | 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":"中國北部(フフホト)"
}
]
}
}