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：中文。 en-US：英文。 ja：日文。默认值：zh-CN。	zh-CN

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Regions	array<object>	地域信息集合。
Region	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.	指定的参数 InstanceChargeType 无效。
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.	指定的资源类型不存在。

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

变更历史

变更时间	变更内容概要	操作

暂无变更历史