Domain name for API request: postgres.tencentcloudapi.com.
This API is used to query the purchase price of an instance.
A maximum of 20 requests can be initiated per second for this API.
The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.
Parameter Name | Required | Type | Description |
---|---|---|---|
Action | Yes | String | Common Params. The value used for this API: InquiryPriceCreateDBInstances. |
Version | Yes | String | Common Params. The value used for this API: 2017-03-12. |
Region | No | String | Common Params. This parameter is not required for this API. |
Zone | Yes | String | AZ ID, which can be obtained through the Zone field in the returned value of the DescribeZones API. |
SpecCode | Yes | String | Specification ID, which can be obtained through the SpecCode field in the returned value of the DescribeClasses API. |
Storage | Yes | Integer | Storage capacity size in GB. |
InstanceCount | Yes | Integer | Number of instances. Maximum value: 100. If you need to create more instances at a time, please contact customer service. |
Period | Yes | Integer | Length of purchase in months. Currently, only 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, and 36 are supported. |
Pid | No | Integer | [Disused] Billing ID, which can be obtained through the Pid field in the returned value of the DescribeProductConfig API. |
InstanceChargeType | No | String | Instance billing type. Valid value: POSTPAID_BY_HOUR (pay-as-you-go) |
InstanceType | No | String | Instance type. Default value: primary . Valid values:primary (dual-server high-availability, one-primary-one-standby)readonly (read-only instance) |
DBEngine | No | String |
Parameter Name | Type | Description |
---|---|---|
OriginalPrice | Integer | Published price in US Cent |
Price | Integer | Discounted total amount in US Cent |
Currency | String | Currency, such as USD. |
RequestId | String | The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem. |
This example shows you how to query the purchase price of an instance.
POST / HTTP/1.1
Host: postgres.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: InquiryPriceCreateDBInstances
<Common request parameters>
{
"InstanceCount": "1",
"Zone": "ap-guangzhou-2",
"Storage": "100",
"Pid": "11004",
"Period": "1",
"SpecCode": "cdb.pg.z1.2g",
"InstanceChargeType": "PREPAID"
}
{
"Response": {
"RequestId": "8a61e500-aa33-454c-9ec2-da2a368c39ab",
"OriginalPrice": 27600,
"Price": 27600,
"Currency": "USD"
}
}
TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.
The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.
Error Code | Description |
---|---|
AuthFailure.UnauthorizedOperation | Authentication failed. |
FailedOperation.CamSigAndAuthError | Authentication failed. Please try again later. If the problem persists, please contact customer service. |
FailedOperation.DatabaseAccessError | Failed to access database management service. Please try again later. If the problem persists, please contact customer service. |
FailedOperation.DatabaseAffectedError | Data operation failed. Please contact customer service. |
FailedOperation.FailedOperationError | Operation failed. Please try again later. |
FailedOperation.QueryPriceFailed | Failed to query the price. |
FailedOperation.QuerySpecBySpecCodeError | Failed to query specifications. |
FailedOperation.TradeQueryPriceError | Failed to query pricing information. Please try again later. If the problem persists, please contact customer service. |
InternalError.DBError | Backend database execution error. |
InternalError.InternalHttpServerError | An exception occurred while executing the request. |
InternalError.SystemError | System error. When this error occurs, please contact customer service for assistance. |
InternalError.UnknownError | Unknown error. When this error occurs, please contact customer service for assistance. |
InvalidParameter | Parameter error. |
InvalidParameter.ParameterCheckError | Failed to check the parameter. |
InvalidParameterValue.BadSpec | The instance specification to upgrade to is not purchasable. |
InvalidParameterValue.IllegalInstanceChargeType | Incorrect billing mode. |
InvalidParameterValue.InvalidParameterValueError | Incorrect parameter value |
InvalidParameterValue.InvalidZoneIdError | Invalid availability zone. |
InvalidParameterValue.ParameterHandleError | Failed to process the parameter. Please check if the parameter value is valid. |
InvalidParameterValue.SpecNotRecognizedError | Failed to identify the specification ({{1}}). |
InvalidPid | Incorrect PID parameter. |
OperationDenied.CamDeniedError | This operation cannot be performed. |
OperationDenied.PayModeError | Unsupported billing mode |
Was this page helpful?