ECS-DescribeRegions接口支持中、英及日文-阿里云开发者社区

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

2018-10-25 885

简介： ECS中该接口DescribeRegions用于查询可以使用阿里云的地域信息。目前，接口DescribeRegions查询出来的地域信息中，地域名称仅支持中文显示，并且没有地域相关联的 Endpoint 信息。

+关注继续查看

接口功能

该接口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":"中国北部（フフホト）"
            }
        ]
    }
}