全部产品
Search
文档中心

云服务器 ECS:DescribeRegions - 查询可以使用的阿里云地域

更新时间:Mar 19, 2024

调用DescribeRegions查询您可以使用的阿里云地域。

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
InstanceChargeTypestring

实例的计费方式,更多详情,请参见计费概述。取值范围:

  • PrePaid:包年包月。此时,您必须确认自己的账号支持余额支付或者信用支付,否则将报错 InvalidPayMethod。
  • PostPaid:按量付费。

默认值为 PostPaid。

PrePaid
ResourceTypestring

资源类型。取值范围:

  • instance:ECS 实例
  • disk:磁盘
  • reservedinstance:预留实例券
  • scu:存储容量单位包

默认值:instance

instance
AcceptLanguagestring

根据汉语、英语和日语筛选返回结果。更多详情,请参见 RFC7231 。取值范围:

  • zh-CN:中文。
  • en-US:英文。
  • ja:日文。

默认值为 zh-CN。

zh-CN

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Regionsobject []

地域信息集合。

Statusstring

集群是否售罄。可能值:

  • available
  • soldOut
available
RegionEndpointstring

地域对应的接入地址(Endpoint)。

ecs.aliyuncs.com
LocalNamestring

地域名称。

China (Qingdao)
RegionIdstring

地域 ID。

cn-qingdao-et2-bo1

示例

正常返回示例

JSON格式

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "Regions": {
    "Region": [
      {
        "Status": "available",
        "RegionEndpoint": "ecs.aliyuncs.com",
        "LocalName": "China (Qingdao)",
        "RegionId": "cn-qingdao-et2-bo1"
      }
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
403Unauthorized.EmptyRegionThe specified account has no access authority to any region.当前账号未被授权访问任何地域,请您授权后再重试。
403Invalid.InstanceChargeTypeThe specified instanceChargeType is not valid.指定的参数 InstanceChargeType 无效。
404InvalidAcceptLanguage.NotFoundOnly Chinese (zh-CN), English (en-US), and Japanese (ja) are allowed.您选择的语言类型无效,现在只支持中文、英语和日语。
404InvalidResourceType.NotFoundThe ResourceType provided does not exist in our records.指定的资源类型不存在。

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