DescribeRegions - 查询地域列表 - 云服务器 ECS

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
InstanceChargeType	string	否	实例的计费方式，更多信息，请参见计费概述。取值范围： PrePaid：包年包月。此时，请确认自己的账号支持余额支付或者信用支付，否则将报错 InvalidPayMethod。 PostPaid：按量付费。 SpotWithPriceLimit：设置上限价格。 SpotAsPriceGo：系统自动出价，最高按量付费价格。默认值：PostPaid。	PrePaid
ResourceType	string	否	资源类型。取值范围： instance：ECS 实例。 disk：磁盘。 reservedinstance：预留实例券。 scu：存储容量单位包。默认值：instance。	instance
AcceptLanguage	string	否	根据汉语、英语和日语筛选返回结果。更多详情，请参见RFC 7231。取值范围： zh-CN：简体中文。 zh-TW：繁体中文。 en-US：英文。 ja：日文。 fr：法语。 de：德语。 ko：韩语。默认值：zh-CN。枚举值： de : 德语 en-US : 英文 ko : 韩语 zh-TW : 繁体中文 ja : 日文 fr : 法语 zh-CN : 简体中文	zh-CN

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Regions	object
Region	array<object>	地域信息集合。
	object
Status	string	集群是否售罄。可能值： available。 soldOut。	available
RegionEndpoint	string	地域对应的接入地址（Endpoint）。	ecs.cn-qingdao.aliyuncs.com
LocalName	string	地域名称。	华北1（青岛）
RegionId	string	地域 ID。	cn-qingdao

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Regions": {
    "Region": [
      {
        "Status": "available",
        "RegionEndpoint": "ecs.cn-qingdao.aliyuncs.com",
        "LocalName": "华北1（青岛）",
        "RegionId": "cn-qingdao"
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
403	Unauthorized.EmptyRegion	The specified account has no access authority to any region.
403	Invalid.InstanceChargeType	The specified instanceChargeType is not valid.
404	InvalidAcceptLanguage.NotFound	Only Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.	您选择的语言类型无效，现在只支持中文、英语和日语。
404	InvalidResourceType.NotFound	The ResourceType provided does not exist in our records.	指定的资源类型不存在。

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。