创建云硬盘询价

最近更新时间: 2026-11-06 00:09:12

1. 接口描述

接口请求域名： cbs.api3.fincloud.tencent.cn。

本接口（InquiryPriceCreateDisks）用于创建云硬盘询价。

支持查询创建多块云硬盘的价格，此时返回结果为总价格。

默认接口请求频率限制：20次/秒。

接口更新时间：2025-02-28 18:42:22。

接口只验签名不鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：InquiryPriceCreateDisks
Version	是	否	String	公共参数，本接口取值：2017-03-12
Region	是	否	String	公共参数，地域信息可通过DescribeRegions接口查看产品支持的地域列表
DiskType	是	否	String	云硬盘类型。取值范围：普通云硬盘：CLOUD_BASIC 高性能云硬盘：CLOUD_PREMIUM SSD云硬盘：CLOUD_SSD。示例值： CLOUD_TSSD
DiskSize	是	否	Uint64	云盘大小，取值范围：普通云硬盘:10GB ~~4000G；高性能云硬盘:50GB~~ 4000GB；SSD云硬盘:100GB ~ 4000GB，步长均为10GB。示例值： 500
DiskChargeType	是	否	String	付费模式，目前只有预付费，即只能取值为PREPAID。示例值： PREPAID
DiskChargePrepaid	否	否	DiskChargePrepaid	预付费相关参数设置，通过该参数可以指定包年包月云盘的购买时长，预付费云盘该参数必传。示例值：查看
DiskCount	否	否	Uint64	购买云盘的数量。不填则默认为1。示例值： 1
ProjectId	否	否	Uint64	云盘所属项目ID。示例值： 0
ThroughputPerformance	否	否	Uint64	额外购买的性能大小。示例值： 100
Zone	否	否	String	可用区示例值： mock-zone
DiskBackupQuota	否	否	Uint64	云盘备份点配额示例值： 0

3. 输出参数

参数名称	类型	描述
DiskPrice	Price	描述了新购云盘的价格。示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
InvalidParameterValue	无效参数值。参数值格式错误或者参数值不被支持等。
MissingParameter	参数缺失。请求没有带必选参数。

5. 示例

示例1 查询购买按小时后付费云盘价格

查询购买一块大小100GB，云盘类型为高性能云硬盘，计费类型为按小时后付费的价格。

输入示例

https://cbs.api3.fincloud.tencent.cn/?Action=InquiryPriceCreateDisks
&DiskType=CLOUD_PREMIUM
&DiskSize=100
&DiskCount=1
&DiskChargeType=POSTPAID_BY_HOUR
&<Common Parameters>

输出示例

{
  "Response": {
    "RequestId": "55e84d71-26f1-4b7c-8dc4-6bc26d0a2411",
    "DiskPrice": {
      "DiscountPrice": null,
      "UnitPrice": 0.04,
      "UnitPriceHigh": "0.042",
      "OriginalPriceHigh": null,
      "OriginalPrice": null,
      "UnitPriceDiscount": 0.04,
      "UnitPriceDiscountHigh": "0.042",
      "DiscountPriceHigh": null,
      "ChargeUnit": "HOUR"
    }
  }
}

示例2 查询购买1个月500G TSSD 带100M额外性能询价

输入示例

https://cbs.api3.fincloud.tencent.cn/?Action=InquiryPriceCreateDisks
&DiskType=CLOUD_TSSD
&DiskCount=1
&DiskSize=500
&DiskChargeType=PREPAID
&DiskChargePrepaid.Period=1
&ThroughputPerformance=100
&<Common Parameters>

输出示例

{
  "Response": {
    "RequestId": "55e84d71-26f1-4b7c-8dc4-6bc2611d0a2411",
    "DiskPrice": {
      "DiscountPrice": 800.0,
      "UnitPriceHigh": null,
      "OriginalPriceHigh": "800",
      "OriginalPrice": 800.0,
      "UnitPriceDiscount": null,
      "UnitPriceDiscountHigh": null,
      "DiscountPriceHigh": "800",
      "UnitPrice": null,
      "ChargeUnit": null
    }
  }
}