天天看點

ECS-DescribeRegions接口支援中、英及日文

接口功能

該接口DescribeRegions用于查詢可以使用阿裡雲的地域資訊。

需求背景

目前,接口DescribeRegions查詢出來的地域資訊中,地域名稱僅支援中文顯示,并且沒有地域相關聯的 Endpoint 資訊。

請求與傳回

接口DescribeRegions的請求入參中添加字段AcceptLanguage,用于豐富和區分支援的語言類型,具體的參數資訊如下:

參數名稱 類型 是否必需 描述
AcceptLanguage String 參照國際标準 RFC7231,後端服務根據使用者語言類型需要傳回相應的結果
  • 預設值:無(傳回中文形式)
  • 中文:zh-CN
  • 英文:en-US
  • 日文:ja

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