文档中心

云数据库 PostgreSQL 版

实例管理

DescribeDBInstancePriceDetail

DescribeDBInstancePriceDetail

调用 DescribeDBInstancePriceDetail 接口查询实例价格详情。

请求类型

同步请求。

调试

API Explorer

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

请求参数

参数	类型	是否必选	示例值	描述
NodeInfo	Array of NodeInfoObject	是	请参见请求示例。	实例规格配置。Primary 节点有且只有 1 个，Secondary 节点有且只有 1 个，Read-Only 节点可选 0~10 个。
StorageType	String	是	LocalSSD	实例存储类型。取固定值 LocalSSD（本地 SSD 盘）。
StorageSpace	Integer	是	100	实例的存储空间。说明不同规格对应的存储空间取值范围不同。关于存储空间取值范围的详细信息，请参见产品规格。单位为 GB，步长为 10 GB。
ChargeInfo	Object of ChargeInfoObject	是	{ "ChargeType": "PostPaid" }	付费方式。

NodeInfoObject

参数	类型	是否必选	示例值	描述
NodeId	String	否	postgres-ca7b7019****	节点 ID。可调用 DescribeDBInstanceDetail 接口查询。说明在变更节点规格和删除节点（ModifyDBInstancesSpec）时必传。
ZoneId	String	是	cn-beijing-a	节点所在可用区，可调用 DescribeAvailabilityZones 查询。说明在创建实例（CreateDBInstance）、恢复到新实例（RestoreToNewInstance）、新增节点和修改节点（ModifyDBInstancesSpec）时必传。主节点、备节点和只读节点可部署在同一地域下的不同可用区。
NodeType	String	是	Primary	节点类型，取值为： Primary：主节点。 Secondary：备节点。 ReadOnly：只读节点。
NodeSpec	String	是	rds.postgres.1c2g	节点规格。可通过 DescribeDBInstanceSpecs 接口查询可售卖的规格。
NodeOperateType	String	否	Create	操作类型。取值范围： Create：增加。 Delete：删除。 Modify：修改。说明在创建实例（CreateDBInstance）和恢复到新实例（RestoreToNewInstance）接口中，该字段取值只能为 Create。修改实例配置时，需为涉及的节点传入指定 NodeOperateType。

ChargeInfoObject

参数	类型	是否必选	示例值	描述
ChargeType	String	是	PostPaid	付费类型。取值： PostPaid：按量付费。 PrePaid：包年包月（默认）。
AutoRenew	Boolean	否	true	预付费场景下是否自动续费。 true：自动续费。 false：不自动续费（默认）。
PeriodUnit	String	否	Month	预付费场景下的购买周期。 Month：包月（默认）。 Year：包年。
Period	Integer	否	1	预付费场景下的购买时长。默认值：1。
Number	Integer	否	1	实例购买数量。可取 1~20 之间的整数值，默认值为 1。说明当 ChargeInfoObject 被 RestoreToNewInstance 接口引用时，Number 只允许设置为 1。

返回参数

参数	类型	示例值	描述
ChargeItemPrices	Array of ChargeItemPriceObject	请参见返回示例。	费用明细。
Currency	String	人民币	货币单位。
DiscountPrice	Double	1.125	实例折扣价。
InstanceQuantity	Integer	3	实例数量。
OriginalPrice	Double	1.125	实例原价。
PayablePrice	Double	1.125	实例应付价格。

ChargeItemPriceObject

参数	类型	示例值	描述
ChargeItemType	String	Primary	付费项名称，取值： Primary：主节点。 Secondary：备节点。 ReadOnly：只读节点。 Storage：物理存储空间。
ChargeItemKey	String	rds.pg.d1.1c2g	如果 ChargeItemKey 取值为 Primary、Secondary 或 ReadOnly，该参数返回实例的规格，如 rds.pg.d1.1c2g。如果 ChargeItemKey 取值为 Storage，该参数返回存储的 Key，如 rds.pg.d1.localssd。
ChargeItemValue	Integer	100	如果 ChargeItemKey 取值为 Primary、Secondary 或 ReadOnly，该参数返回节点个数，取值均为 1。如果 ChargeItemKey 取值为 Storage，该参数返回存储的容量大小，单位为 GB。
NodeNumPerInstance	Integer	3	每个实例的节点数量。
OriginalPrice	Double	300	原价。
DiscountPrice	Double	200	折扣价。
PayablePrice	Double	100	应付价格。

示例

请求示例

返回示例

最近更新时间：2026.03.31 10:39:11

这个页面对您有帮助吗？

有用

有用

无用

无用