文档中心

云数据库 veDB MySQL 版

实例管理

DescribeDBInstancePriceDetail - 获取实例价格

调用 DescribeDBInstancePriceDetail 接口查询指定配置实例的价格详情。

请求类型

同步请求。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

参数	类型	是否必选	示例值	描述
NodeSpec	String	是	vedb.mysql.x4.medium	实例的节点规格代码。关于实例节点规格的详细信息，请参见产品规格。
NodeNumber	Integer	是	2	实例节点数量。取值范围为 2~16 个。
ChargeType	String	否	PostPaid	计算计费类型。取值： PostPaid：按量计费（后付费）。 PrePaid：包年包月（预付费）。
StorageChargeType	String	否	PostPaid	存储计费类型。不传入该参数时，存储计费类型默认与计算计费类型取值一致，取值如下： PostPaid：按量计费（后付费）。 PrePaid：包年包月（预付费）。说明当计算计费类型取值为 PostPaid 时，存储计费类型也只能取值为 PostPaid。当计算计费类型取值为 PrePaid 时，存储计费类型可取值为 PrePaid 或 PostPaid。
PeriodUnit	String	否	Month	预付费场景下的购买周期。 Month：包月。 Year：包年。说明当 ChargeType（计算计费类型）取值为 PrePaid（包年包月）时，该参数必填。
Period	Integer	否	1	预付费场景下的购买时长。说明当 ChargeType（计算计费类型）取值为 PrePaid（包年包月）时，该参数必填。
PrePaidStorageInGB	Integer	否	50	预付费场景下的存储空间大小。说明当 StorageChargeType（存储计费类型）取值为 PrePaid（包年包月）时，该参数必填。
Number	Integer	否	1	创建的实例数量，取值范围 1~50，默认值为 1。
StorageType	String	否	IOOptimizedStorage	存储类型。取值范围： IOOptimizedStorage：IO 性能型。 SmartCompressedStorage：智能压缩型。

返回参数

参数	类型	示例值	描述
OriginalPrice	Double	1.18	指定配置下的原始总价。
DiscountPrice	Double	0.2478	指定配置下的折扣总价。
PayablePrice	Double	0.2478	指定配置下的应付总价。
ChargeType	String	configuration_hourly	计费类型。取值为： configuration_hourly：后付费，即按量计费。 fixed_price：预付费，即包年包月。
Currency	String	人民币	货币单位。默认值为人民币。
ChargeItemPrices	Array of ChargeItemPriceObject	请参见返回示例。	指定配置下的各项费用明细。
ConfigItemPrices	Array of ConfigItemPriceObject	请参见返回示例。	指定配置的详细计费信息。

ChargeItemPriceObject

参数	类型	示例值	描述
ChargeItemCode	String	vedb.mysql.x4.medium_cn-beijing	计费项代码。
OriginalPrice	Double	1.18	指定配置下的原始总价。
DiscountPrice	Double	0.2478	指定配置下的折扣总价。
PayablePrice	Double	0.2478	指定配置下的应付总价。
UnitPrice	Double	0.59	计费项的单价。

ConfigItemPriceObject

参数	类型	示例值	描述
InstanceID	String	vedbm-6subnyth****	实例 ID。
ConfigurationCode	String	-	配置代码。
DiscountPrice	Double	0.2478	指定配置下的折扣总价。
PayablePrice	Double	0.2478	指定配置下的应付总价。
OriginalPrice	Double	1.18	指定配置下的原始总价。
RefundAmount	Double	0	应退款金额。
CouponAmount	Double	0	使用优惠券抵扣的金额。
Quantity	Long	1	实例数量。
ChargeItemPrices	Array of ChargeItemPriceObject	请参见返回示例。	指定配置下的各项费用明细。

示例

请求示例

POST /?Action=DescribeDBInstancePriceDetail&Version=2022-01-01 HTTP/1.1​
Content-Type: application/json​
Host:vedbm.cn-beijing.volcengineapi.com​
X-Date: 20220101T101010Z​
Authorization: HMAC-SHA256 Credential=AKLTN2I0MmFiNzMxNWE5NDgzMzk4MmVjMTVkODlkZTZ****/20220101/cn-beijing/vedbm/request,SignedHeaders=x-date, Signature=71d31fc7bcf990142851c9833c5656391486cda0ae2e0b8ada733b7c645****​
{​
    "NodeSpec": "vedb.mysql.x4.medium",​
    "NodeNumber": 2,​
    "ChargeType": "PostPaid",​
    "Number": 1,​
    "StorageChargeType": "PostPaid"​
}​

返回示例

{​
    "ResponseMetadata": {​
        "RequestId": "202507301447432ECEF150A8236495A353-020ce9",​
        "Action": "DescribeDBInstancePriceDetail",​
        "Version": "2022-01-01",​
        "Service": "vedbm",​
        "Region": "cn-beijing"​
    },​
    "Result": {​
        "ChargeItemPrices": [​
            {​
                "ChargeItemCode": "vedb.mysql.x4.medium_cn-beijing",​
                "DiscountPrice": 0.2478,​
                "OriginalPrice": 1.18,​
                "PayablePrice": 0.2478,​
                "UnitPrice": 0.59​
            },​
            {​
                "ChargeItemCode": "vedb.mysql.volume.clusterpool_cn-beijing",​
                "DiscountPrice": 0,​
                "OriginalPrice": 0,​
                "PayablePrice": 0,​
                "UnitPrice": 0.00486​
            }​
        ],​
        "ChargeType": "configuration_hourly",​
        "Currency": "人民币",​
        "DiscountPrice": 0.2478,​
        "OriginalPrice": 1.18,​
        "PayablePrice": 0.2478​
    }​
}​

错误码

更多详情，请参见错误码。

最近更新时间：2026.06.30 11:37:35

这个页面对您有帮助吗？

有用

无用