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

请求类型

同步请求。

调试

API Explorer

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

请求参数

参数	类型	是否必选	示例值	描述
NodeInfo	Array of NodeInfoObject	是	请参见请求示例。	实例的节点配置。
StorageType	String	是	LocalSSD	实例的存储类型。取值范围： LocalSSD：本地盘。 CloudESSD_FlexPL：FlexPL 云盘。 CloudESSD_PL0：PL0 云盘。 CloudESSD_HighPerf：高性能云盘。说明如需设定 StorageSpace 参数，StorageType 参数为必传。当 InstanceType 取值为 SingleNode 时，StorageType 取值只能为 CloudESSD_FlexPL、CloudESSD_PL0 或 CloudESSD_HighPerf。在不同接口中，该参数取值范围不同。具体规则如下：在以下接口中作为请求参数时，StorageType 的取值只能为 LocalSSD。 RestoreToCrossRegionInstance RestoreToNewInstanceFromUserTos 在部分接口中作为请求参数时，该参数的取值范围与原实例的存储类型有关，具体规则如下：原实例的存储类型为 LocalSSD时，不支持变更存储类型。原实例的存储类型为 CloudESSD_PL0 时，可取值为 CloudESSD_PL0、 CloudESSD_FlexPL 或 CloudESSD_HighPerf。涉及的接口是： RebuildDBInstance RestoreToNewInstance ModifyDBNodeSpec
StorageSpace	Integer	是	100	不同存储类型、不同规格对应的存储空间取值范围不同，关于存储空间取值范围的详细信息，请参见产品规格。单位为 GiB，步长 10GiB。
ChargeType	String	是	PostPaid	计费类型。取值： PostPaid：按量付费（后付费）。 PrePaid：包年包月（预付费）。
PeriodUnit	String	否	Month	预付费场景下的购买周期。说明 ChargeType 取值为 PostPaid时，不需要传入此参数。 Month：购买周期为月。默认。 Year：购买周期为年。
Period	Integer	否	2	预付费模式下的时长数量。当 PeriodUnit 取值为 Month 时，取值范围为 [1~9]，单位为月。当 PeriodUnit 取值为 Year 时，取值范围为 [1~3]，单位为年。
Number	Integer	否	1	实例个数。取值范围为 [1~50]。
ProxyNodeCustom	Object of ProxyNodeCustom	否	请参见请求示例。	实例的代理配置。

NodeInfoObject

参数	类型	是否必选	示例值	描述
NodeId	String	否	mysql-050b3e08****-r6e25	节点 ID。说明创建实例或新增节点时无需传入该参数，变更节点配置或删除节点时必传。
NodeType	String	是	Primary	节点类型，取值： Primary：主节点。 Secondary：备节点。 ReadOnly：只读节点。说明在查询实例价格详情接口（DescribeDBInstancePriceDetail）中，该字段为可选。在增加节点（CreateDBNodes）时，该字段取值只能为 ReadOnly（双节点实例）或 Secondary（多节点实例）。对于双节点实例，主节点和备节点有且只有 1 个，只读节点可选 0~10 个。对于多节点实例，主节点有且只有 1 个，最多可添加 8 个备节点，最少需有 1 个备节点。建议预留一个不承载业务的独立备节点，以便在必要时将其切换为主节点。若因未设置独立备节点致使所有备节点主备延迟过高，进而导致主节点切换失败，云数据库 MySQL 版不承担相关责任。
NodeSpec	String	是	rds.mysql.1c2g	节点规格。关于节点规格的详细信息，请参见产品规格。说明备节点的规格需与主节点的规格保持一致。只读节点规格可低于主节点的规格。但需注意，当只读节点规格低于主节点规格时，可能会因为主节点负载过高导致只读节点存在延迟甚至只读节点 OOM。建议为只读节点选择采与主节点相同或更高的规格。如 StorageType 取值为 CloudESSD_FlexPL 或 CloudESSD_PL0，NodeSpec 只能传入通用规格。
ZoneId	String	是	cn-beijing-a	节点所在可用区，可调用 DescribeAvailabilityZones 接口查询。在创建实例和新增节点时必传，变更节点配置或删除节点时可不传。说明一个实例的节点最多可分布在三个可用区。在一次变配中，最多可增删三个可用区下的节点。
NodeOperateType	String	否	Modify	操作类型。创建实例时无需传入该参数，修改节点配置时需要传入。取值范围： Create：增加节点。 Modify：修改节点配置。说明在增加节点（CreateDBNodes）时，该字段只能取值为 Create。在变更配置时，该字段只能取值为Modify。填写为 Delete时，该取值无实际意义。

ProxyNodeCustom

参数	类型	是否必选	示例值	描述
CpuNum	Integer	否	4	实例数据库代理服务的 CPU 核数。取值如下：取值范围：上限 1024。对于多节点实例：推荐代理核数为实例所有可服务节点总 CPU 数0.25，结果向上取整。代理核数的取值下限为 2 与主节点 CPU 核数0.125之间的较大值。对于双节点实例：推荐代理核数为实例所有可服务节点总CPU数 * 0.5，结果向上取整。代理核数的取值下限为 2 与主节点 CPU 核数*0.5之间的较大值。

返回参数

参数	类型	示例值	描述
DescribeDBInstancePriceDetailStr	Object of DescribeDBInstancePriceDetailStr	请参见返回示例。	指定配置的详细计费信息。
HidePriceInfo	Boolean	true	是否隐藏了价格信息。如果设置，将会以 *** 待替具体价格。取值： true：是。 false：否。

DescribeDBInstancePriceDetailStr

参数	类型	示例值	描述
BillingMethod	String	fixed_price	计费类型。取值为： configuration_hourly：后付费，即按量计费。 fixed_price：预付费，即包年包月。
ChargeItemPrices	Array of ChargeItemPriceObjectStr	请参见返回示例。	指定配置下的各项费用明细。
CouponAmount	String	0	使用优惠券抵扣的金额。
Currency	String	人民币	货币单位。默认值为人民币。
DiscountPrice	String	2160	指定配置下的折扣总价。
OriginalPrice	String	2880	指定配置下的总价（原）。
PayablePrice	String	2160	指定配置的应付价格。
Quantity	Integer	1	实例数量。
RefundAmount	String	0	应退款金额。

ChargeItemPriceObjectStr

参数	类型	示例值	描述
ChargeItemKey	String	rds.mysql.d1.1c2g_cn-guangzhou	计费项的 Key。
ChargeItemType	String	Proxy	计费项名称，取值： Primary：主节点。 Secondary：备节点。 ReadOnly：只读节点 Storage：物理存储空间。 Proxy：数据库代理。
ChargeItemValue	Long	6	如果 ChargeItemType 取值为 Primary、Secondary 或 ReadOnly，则该字段为节点个数。如果 ChargeItemType 取值为 Proxy，则该字段为数据代理服务的核数。如果 ChargeItemType 取值为 Storage，该参数返回单个节点存储空间大小。
DiscountPrice	String	0.3942	该计费项的折扣金额。
OriginalPrice	String	0.876	该计费项的原始价格。
PayablePrice	String	0.3942	该计费项的应付费用。

示例

请求示例 1

查询实例在后付费（按量计费）方式下的价格。

返回示例 1

请求示例 2

查询实例在预付费（包年包月）方式下的价格。

返回示例 2

错误码

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

云数据库 MySQL 版