Call the DescribeDBInstancePriceDetail API to query instance price details.

Request type

Synchronous request.

Debug

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Request parameters

Parameter	Type	Required?	Example	Description
NodeInfo	Array of NodeInfoObject	Yes	Refer to the request example.	Instance specification configuration. There is exactly one primary node and one secondary node, with 0 to 10 optional read-only nodes.
StorageType	String	Yes	LocalSSD	Instance storage type. Fixed value LocalSSD (local SSD disk).
StorageSpace	Integer	Yes	100	Instance storage space tip Different specifications have different storage space value ranges. For detailed information on storage space value ranges, refer to Product specifications. Unit in GB, step size of 10 GB.
ChargeInfo	Object of ChargeInfoObject	Yes	{ "ChargeType": "PostPaid" }	Payment method.

NodeInfoObject

Parameter	Type	Is it required?	Example	Description
NodeId	String	No	postgres-ca7b7019****	Node ID. You can call the DescribeDBInstanceDetail API to query. tip Required when modifying node specification and deleting nodes (ModifyDBInstancesSpec).
ZoneId	String	Yes	cn-beijing-a	The availability zone where the node is located. You can call the DescribeAvailabilityZones API to query it. tip Required when creating an instance (CreateDBInstance), restoring to a new instance (RestoreToNewInstance), and adding or modifying nodes (ModifyDBInstancesSpec). Primary, secondary, and read-only nodes can be deployed in different availability zones within the same region.
NodeType	String	Yes	Primary	Node type, with values: Primary: Primary node. Secondary: indicates the secondary node. ReadOnly: Read-only node.
NodeSpec	String	Yes	rds.postgres.1c2g	Node specification. Query specifications available for sale via DescribeDBInstanceSpecs API.
NodeOperateType	String	No	Create	Operation type. Range: Create: add. Delete: delete. Modify: modify. tip In the CreateDBInstance and RestoreToNewInstance APIs, this field can only be set to Create. When modifying instance configuration, the specified NodeOperateType must be passed in for the involved nodes.

ChargeInfoObject

Parameter	Type	Required?	Example	Description
ChargeType	String	Yes	PostPaid	Payment type. Values: PostPaid: pay-as-you-go. PrePaid: subscription (default).
AutoRenew	Boolean	No	true	Is automatic renewal enabled for the prepaid scenario? yes: automatic renewal. false: no automatic renewal (default).
PeriodUnit	String	No	Month	Purchase period for prepaid scenarios. Month: monthly (default). Year: subscription.
Period	Integer	No	1	Subscription duration in a prepaid scenario. default value: 1.
Number	Integer	No	1	Instance purchase quantity. Acceptable integer values range from 1 to 20, with a default of 1. tip When ChargeInfoObject is referenced by the RestoreToNewInstance API, Number can only be set to 1.

Response parameters

Parameter	Type	Example	Description
ChargeItemPrices	Array of ChargeItemPriceObject	Refer to the sample response.	Cost details.
Currency	String	RMB	Currency unit.
DiscountPrice	Double	1.125	Instance discount price.
InstanceQuantity	Integer	3	Number of instances.
OriginalPrice	Double	1.125	Original instance price.
PayablePrice	Double	1.125	Instance payable price.

ChargeItemPriceObject

Parameter	Type	Example	Description
ChargeItemType	String	Primary	Billing item name, with values: Primary: Primary node. Secondary: indicates the secondary node. ReadOnly: Read-only node. Storage: physical storage space.
ChargeItemKey	String	rds.pg.d1.1c2g	If ChargeItemKey is set to Primary, Secondary, or ReadOnly, this parameter returns the instance specification, such as rds.pg.d1.1c2g. If ChargeItemKey is set to Storage, this parameter returns the storage key, such as rds.pg.d1.localssd.
ChargeItemValue	Integer	100	If ChargeItemKey is set to Primary, Secondary, or ReadOnly, this parameter returns the number of nodes, which is always 1. If ChargeItemKey is set to Storage, this parameter returns the storage capacity size in GB.
NodeNumPerInstance	Integer	3	Number of nodes per instance.
OriginalPrice	Double	300	Original price.
DiscountPrice	Double	200	Discount price.
PayablePrice	Double	100	Payable price.

Example

Sample request

Sample response