DescribeAvailableResource
查询可用区的资源库存状态。您可以在某一可用区创建实例(RunInstances)或者修改实例规格(ModifyInstanceSpec)时查询该可用区的资源库存状态
服务地址:
华东1 金融云
输入参数
只看必填
RegionId目标地域ID
InstanceChargeType资源的计费方式
SpotStrategy按量付费实例的竞价策略
SpotDuration抢占式实例的保留时长
DestinationResource要查询的资源类型
ZoneId可用区ID
IoOptimized是否为I/O优化实例
DedicatedHostId专有宿主机ID
InstanceType实例规格
SystemDiskCategory系统盘类型
DataDiskCategory数据盘类型
NetworkCategory网络类型
Cores实例规格的vCPU内核数目
Memory实例规格的内存大小
ResourceType资源类型
Scope预留实例券的范围
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

参数DestinationResource的取值有不同的逻辑与要求。在下列的顺序列表中,顺序越低的取值需要设置更多的参数,不支持通过低顺序的取值筛选高顺序的资源类别。

  • 取值顺序:Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk

  • 取值示例:

    • 若参数DestinationResource取值为DataDisk

      • ResourceType取值为disk表示查询与 ECS 实例规格无关的数据盘类型,可以不传入参数InstanceType

      • ResourceType取值为instance表示查询待挂载至 ECS 实例的数据盘类型,由于实例规格对数据盘有限制,所以需要同时指定InstanceType与参数DataDiskCategory

    • 若参数DestinationResource取值为SystemDiskResourceType取值为instance,由于 ECS 实例规格对系统盘存在限制,则必须要传入参数InstanceType

    • 若参数DestinationResource取值为InstanceType,建议传入参数IoOptimizedInstanceType

    • 查询指定地域下所有可用区的 ecs.g5.large 库存供应情况:RegionId=cn-hangzhou &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.large

    • 查询指定地域下有 ecs.g5.large 库存供应的可用区列表:RegionId=cn-hangzhou &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.large

查询杭州地域供应实例规格为 ecs.g5.large 的可用区列表。
"RegionId": "cn-hangzhou",
"DestinationResource": "Zone",
"InstanceType": "ecs.g5.large"
查询杭州地域、所有可用区下的实例类型为 ecs.g5.large 的库存。
"RegionId": "cn-hangzhou",
"DestinationResource": "InstanceType",
"InstanceType": "ecs.g5.large"
【只购买数据盘】查询杭州地域、可用区 b 下的数据盘类型为 cloud_efficiency 的库存。
"RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-b",
"ResourceType": "disk",
"DestinationResource": "DataDisk"
【购买 ECS 实例和系统盘】查询杭州地域、可用区 b 下的实例类型为 ecs.g7.large、系统盘类型为 cloud_essd 的库存。
"RegionId": "cn-hangzhou",
"ZoneId": "cn-hangzhou-b",
"ResourceType": "instance",
"InstanceType": "ecs.g7.large",
"DestinationResource": "SystemDisk",
"SystemDiskCategory": "cloud_essd"

请求参数

字段名称字段详情
RegionIdstring

目标地域 ID。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
InstanceChargeTypestring

资源的计费方式。更多信息,请参见计费概述。取值范围: 展开详情

示例值:PrePaid参考取值来源:
    DescribeInstances
SpotStrategystring

按量付费实例的竞价策略。取值范围: 展开详情

示例值:NoSpot
SpotDurationinteger<int32>

抢占式实例的保留时长,单位为小时。 默认值:1。取值范围:展开详情

示例值:1取值 <= 6
DestinationResourcestring

要查询的资源类型。取值范围: 展开详情

示例值:InstanceType
ZoneIdstring

可用区 ID。展开详情

示例值:cn-hangzhou-e参考取值来源:
    DescribeZones
IoOptimizedstring

是否为 I/O 优化实例。取值范围: 展开详情

示例值:optimized
DedicatedHostIdstring

专有宿主机 ID。

示例值:dh-bp165p6xk2tlw61e****参考取值来源:
    DescribeDedicatedHosts
    AllocateDedicatedHosts
InstanceTypestring

实例规格。更多信息,请参见实例规格族,您也可以调用 DescribeInstanceTypes 接口获得最新的规格表。展开详情

示例值:ecs.g5.large参考取值来源:
    DescribeInstanceTypes
    CreateInstance
SystemDiskCategorystring

系统盘类型。取值范围: 展开详情

示例值:cloud_ssd
DataDiskCategorystring

数据盘类型。取值范围: 展开详情

示例值:cloud_ssd
NetworkCategorystring

网络类型。取值范围: 展开详情

示例值:vpc
Coresinteger<int32>

实例规格的 vCPU 内核数目。取值参见实例规格族展开详情

示例值:2
Memorynumber<float>

实例规格的内存大小,单位为 GiB。取值参见实例规格族展开详情

示例值:8.0
ResourceTypestring

资源类型。取值范围:展开详情

示例值:instance参考取值来源:
    TagResources
Scopestring

预留实例券的范围。取值范围:展开详情

示例值:Region

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:0041D94C-FB92-4C49-B115-259DA1C*****
AvailableZonesobject
变更历史
变更时间变更内容概要操作
2025-02-27
变更错误码403
变更错误码404
2024-03-25
变更请求参数SpotDuration