全部产品
Search
文档中心

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

更新时间:Nov 01, 2024

根据计费方式、资源类型等参数查询地域信息列表。

调试

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

授权信息

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

请求参数

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

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

  • PrePaid:包年包月。此时,请确认自己的账号支持余额支付或者信用支付,否则将报错 InvalidPayMethod。
  • PostPaid:按量付费。
  • SpotWithPriceLimit:设置上限价格。
  • SpotAsPriceGo:系统自动出价,最高按量付费价格。

默认值:PostPaid。

PrePaid
ResourceTypestring

资源类型。取值范围:

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

默认值:instance。

instance
AcceptLanguagestring

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

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

默认值:zh-CN。

zh-CN

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
Regionsarray<object>

地域信息集合。

Regionobject
Statusstring

集群是否售罄。可能值:

  • available。
  • soldOut。
available
RegionEndpointstring

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

ecs.cn-qingdao.aliyuncs.com
LocalNamestring

地域名称。

华北1(青岛)
RegionIdstring

地域 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错误码错误信息描述
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.指定的资源类型不存在。

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

变更历史

变更时间变更内容概要操作
暂无变更历史