DescribePrice - 查询价格

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

目标资源的类型。取值范围：

• instance：查询 ECS 实例的最新价格列表。当取值为instance时，必须同时指定参数InstanceType。

• disk：查询云盘的最新价格列表。当取值为disk时，必须同时指定参数DataDisk.1.Category和DataDisk.1.Size。

• diskperformance：查询 ESSD AutoPL 云盘预配置性能的最新价格列表。必须同时指定参数DataDisk.1.Category和DataDisk.1.ProvisionedIops。

• bandwidth：查询带宽的最新价格列表。

• ddh：查询专有宿主机的最新价格列表。

• ElasticityAssurance：查询弹性保障服务的价格信息。当取值为ElasticityAssurance时，必须同时指定参数InstanceType。

• CapacityReservation：查询容量预定服务的价格信息。当取值为CapacityReservation时，必须同时指定参数InstanceType。

默认值：instance。

仅当参数 ResourceType 的值为 instance 时，该参数生效。

镜像 ID，表示启动实例时希望装载的运行环境。您可以调用 DescribeImages 查询您可用的镜像资源。如果不指定，默认查询 Linux 系统镜像的价格。

实例的资源规格。参数ResourceType的值为instance时，您必须同时指定该参数。更多详情，请参见实例规格族，也可以调用 DescribeInstanceTypes 接口获得最新的规格表。

专有宿主机的规格。您可以调用 DescribeDedicatedHostTypes 接口获得最新的专有宿主机规格表。

查询的实例是否为 I/O 优化实例。取值范围：

• none：非 I/O 优化。

• optimized：I/O 优化。

当 InstanceType 为系列 I的规格时，默认值为 none。

当 InstanceType 为非系列 I的规格时，默认值为 optimized。

实例的网络类型。取值范围：

• classic：实例的网络类型为经典网络（Classic）。

• vpc：实例的网络类型为专有网络（VPC）。

默认值：vpc。

网络带宽计费方式。取值范围：

• PayByBandwidth：按固定带宽计费。

• PayByTraffic：按带宽流量计费。

默认值：PayByTraffic。

公网出带宽最大值，单位为 Mbit/s（Megabit per second）。取值范围：0~100。

默认值：0。

系统盘的云盘种类。查询系统盘价格时，必须同时指定ImageId。取值范围：

• cloud：普通云盘。

• cloud_efficiency：高效云盘。

• cloud_ssd：SSD 云盘。

• ephemeral_ssd：本地 SSD 盘。

• cloud_essd：ESSD 云盘。

• cloud_auto：ESSD AutoPL 云盘。

• cloud_essd_entry：ESSD Entry 云盘。

参数默认值说明：

• 当 InstanceType 为已停售的实例规格，且参数IoOptimized取值为none时，该参数默认值为cloud。

• 其它情况下，该参数默认值为cloud_efficiency。2026 年 1 月 30 日后，对于仅支持 cloud_essd 的实例规格，默认值由 cloud_efficiency 调整为 cloud_essd PL0，详情参见变更公告。

系统盘大小，单位为 GiB。取值范围：

• 普通云盘：20~500。

• ESSD 云盘：

  • PL0：1~2048。

  • PL1：20~2048。

  • PL2：461~2048。

  • PL3：1261~2048。

• ESSD AutoPL 云盘：1~2048。

• 其他云盘类型：20~2048。

默认值：max{20, 参数 ImageId 对应的镜像大小}。

系统盘类型为 ESSD 云盘时，区分性能等级。仅当SystemDiskCategory=cloud_essd 时该参数有效。取值范围：

PL0。 PL1（默认）。 PL2。 PL3。

数据盘容量。

为提高扩展性，建议您使用DataDisk.N.Size参数。

磁盘类型。

为提高扩展性，建议您使用DataDisk.N.Category参数。

数据盘的性能等级。

为提高扩展性，建议您使用DataDisk.N.PerformanceLevel参数。

数据盘容量。

为提高扩展性，建议您使用DataDisk.N.Size参数。

磁盘类型。

为提高扩展性，建议您使用DataDisk.N.Category参数。

数据盘的性能等级

为提高扩展性，建议您使用DataDisk.N.PerformanceLevel参数。

数据盘容量。

为提高扩展性，建议您使用DataDisk.N.Size参数。

磁盘类型。

为提高扩展性，建议您使用DataDisk.N.Category参数。

数据盘的性能等级。

为提高扩展性，建议您使用DataDisk.N.PerformanceLevel参数。

数据盘容量。

为提高扩展性，建议您使用DataDisk.N.Size参数。

磁盘类型。

为提高扩展性，建议您使用DataDisk.N.Category参数。

数据盘的性能等级。

为提高扩展性，建议您使用DataDisk.N.PerformanceLevel参数。

云服务器 ECS 的计费时长。取值范围：

• 当参数 PriceUnit 取值为 Month 时：1~9。

• 当参数 PriceUnit 取值为 Year 时：1~5。

• 当参数 PriceUnit 取值为 Hour 时：1。

• 当参数 PriceUnit 取值为 Week 时：1~4。

默认值：1。

查询云服务器 ECS 不同计费周期的价格。取值范围：

• Month：按月计费的价格单位。

• Year：按年计费的价格单位。

• Hour（默认）：按小时计费的价格单位。

• Week：按周计费的价格单位。

查询批量购买某种配置的云服务器 ECS 的价格。取值范围：1~1000。

默认值：1。

预留实例券的付款类型。取值范围：

• No Upfront：零预付。

• Partial Upfront：部分预付。

• All Upfront：全预付。

在一个实例规格内，需要预留的实例的总数量。

取值范围：1~1000。

预留实例券的范围。取值范围：

• Region：地域级别。

• Zone：可用区级别。

默认值：Region。

实例使用的镜像的操作系统类型。取值范围：

• Windows：Windows Server 类型的操作系统。

• Linux：Linux 及类 Unix 类型的操作系统。

容量大小，单位为 GiB。

弹性保障的总次数。取值：Unlimited，目前仅支持在服务生效期内的无限次模式。

默认值：Unlimited。

弹性保障内支持实例的 vCPU 总数量。调用 API 时系统会根据用户指定的 InstanceType 换算出需要弹性保证内支持实例的数量（向上取整）。

互联网服务运营商，取值范围：

• cmcc：移动。

• telecom：电信。

• unicom：联通。

• multiCarrier：多线。

按量付费实例的抢占策略。取值范围：

• NoSpot：正常按量付费实例。

• SpotWithPriceLimit：设置上限价格的抢占式实例。

• SpotAsPriceGo：系统自动出价，最高按量付费价格。

默认值：NoSpot。

抢占式实例的保留时长，单位为小时。 默认值：1。取值范围：

• 1：创建后阿里云会保证实例运行 1 小时不会被自动释放；超过 1 小时后，系统会自动比较出价与市场价格、检查资源库存，来决定实例的持有和回收。

• 0：创建后，阿里云不保证实例运行 1 小时，系统会自动比较出价与市场价格、检查资源库存，来决定实例的持有和回收。

实例回收前 5 分钟阿里云会通过 ECS 系统事件向您发送通知。抢占式实例按秒计费，建议您结合具体任务执行耗时来选择合适的保留时长。

可用区 ID。

仅当参数 ResourceType 的值为 instance 时，该参数生效。

专有宿主机 ID。您可以通过DescribeDedicatedHosts 查询专有宿主机 ID 列表。

分时弹性保障服务生效时间。时间格式以 ISO 8601 为标准，需要使用 UTC +0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。更多信息，请参见ISO 8601。

部署集策略。取值范围：

• Availability：高可用策略。

• AvailabilityGroup：部署集组高可用策略。

• LowLatency：网络低时延策略。

• ProximityLooseDispersion：邻近松散部署集策略。