ECS-DescribeRegions介面支援中、英及日文

心牧發表於2018-10-25

介面功能

該介面DescribeRegions用於查詢可以使用阿里雲的地域資訊。

需求背景

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

請求與返回

介面DescribeRegions的請求入參中新增欄位AcceptLanguage,用於豐富和區分支援的語言型別,具體的引數資訊如下:

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

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


相關文章