赛尔校园公共服务平台 Logo
平台使用
阿里云
百度云
移动云
智算服务
教育生态
登录 →
赛尔校园公共服务平台 Logo
平台使用 阿里云 百度云 移动云 智算服务 教育生态
登录
  1. 首页
  2. 阿里云
  3. 云服务器 ECS
  4. 开发参考
  5. API参考(ECS)
  6. API目录
  7. 地域
  8. DescribeRegions - 查询地域列表

DescribeRegions - 查询地域列表

  • 地域
  • 发布于 2025-04-01
  • 0 次阅读
文档编辑
文档编辑

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

调试

您可以在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:简体中文。
  • zh-TW:繁体中文。
  • en-US:英文。
  • ja:日文。
  • fr:法语。
  • de:德语。
  • ko:韩语。

默认值: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.指定的资源类型不存在。

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

变更历史

变更时间变更内容概要操作
2025-02-28OpenAPI 描述信息更新、OpenAPI 错误码发生变更查看变更详情
相关文章

DescribeAccountAttributes - 查询资源配额 2025-04-01 11:58

查询您在一个阿里云地域下能创建的ECS资源配额。包括您能创建的安全组数量、弹性网卡数量、按量付费vCPU核数、抢占式实例vCPU核数、按量付费云盘总容量配额、专用宿主机数量、网络类型以及账号是否已完成实名认证。

DescribeAvailableResource - 查询可用区的资源库存 2025-04-01 11:58

查询可用区的资源库存状态。您可以在某一可用区创建实例(RunInstances)或者修改实例规格(ModifyInstanceSpec)时查询该可用区的资源库存状态。

DescribeRecommendInstanceType - 查找备选实例规格 2025-04-01 11:58

(Beta)调用DescribeRecommendInstanceType根据一个指定的实例规格,查找一个或多个备选的实例规格。针对已经或者即将停售的实例规格,DescribeRecommendInstanceType会罗列出作为替补的所有实例规格。

DescribeRegions - 查询地域列表 2025-04-01 11:58

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

DescribeResourcesModification - 变更实例规格或系统盘类型之前,查询某一可用区下实例规格或系统盘的库存情况 2025-04-01 11:58

变更实例规格或系统盘类型之前,查询某一可用区下实例规格或系统盘的库存情况。

DescribeZones - 查询可用区列表 2025-04-01 11:58

根据地域ID、计费方式等参数查询可用区信息列表。

目录
Copyright © 2025 your company All Rights Reserved. Powered by 赛尔网络.
京ICP备14022346号-15
gongan beian 京公网安备11010802041014号