Domain name for API request: postgres.intl.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 | Yes | String | Common Params. For more information, please see the list of regions supported by the product. This API only supports: ap-bangkok, ap-beijing, ap-chengdu, ap-chongqing, ap-guangzhou, ap-hongkong, ap-jakarta, ap-nanjing, ap-seoul, ap-shanghai, ap-shanghai-fsi, ap-shenzhen-fsi, ap-singapore, ap-tokyo, eu-frankfurt, na-ashburn, na-siliconvalley, sa-saopaulo. |
| Zone | Yes | String | Availability zone name. The value of this parameter can be obtained from the returned Zone field of the DescribeZones API. |
| SpecCode | Yes | String | Specification ID. The value of this parameter can be obtained from the returned SpecCode field of the DescribeClasses API. |
| Storage | Yes | Integer | Storage capacity, in GB. The value for this parameter must be set in increments of 10. |
| InstanceCount | Yes | Integer | Instance quantity. The maximum allowed quantity is no more than 100. If you need to create more instances at a time, please contact customer service. |
| Period | Yes | Integer | Purchased duration, in months. Only 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 24, and 36 are supported. |
| Pid | No | Integer | [Deprecated and no longer effective] Billing ID. The value of this parameter can be obtained from the returned Pid field of the DescribeProductConfig API. |
| InstanceChargeType | No | String | Instance billing type. Valid values: PREPAID (prepaid, also known as yearly/monthly subscription) and POSTPAID (pay-as-you-go). |
| InstanceType | No | String | Instance type. The default value is primary. Valid values: |
| DBEngine | No | String | Database engine. The default value is postgresql. Valid values: |
| StorageType | No | String | Instance storage type. Valid values: PHYSICAL_LOCAL_SSD: local SSD of physical machine. CLOUD_PREMIUM: Premium Disk. CLOUD_SSD: Cloud SSD. CLOUD_HSSD: Enhanced SSD. |
| Parameter Name | Type | Description |
|---|---|---|
| OriginalPrice | Integer | List price, in cents. |
| Price | Integer | Actual payment amount after discount, in cents. |
| 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 instance selling price.
POST / HTTP/1.1
Host: postgres.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: InquiryPriceCreateDBInstances
<Common request parameters>
{
"InstanceCount": 1,
"Zone": "ap-guangzhou-2",
"Storage": 100,
"Period": 1,
"SpecCode": "cdb.pg.z1.2g",
"InstanceChargeType": "PREPAID"
}
{
"Response": {
"RequestId": "8a61e500-aa33-454c-9ec2-da2a368c39ab",
"OriginalPrice": 27600,
"Price": 27600,
"Currency": "CNY"
}
}
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 |
Esta página foi útil?
Você também pode entrar em contato com a Equipe de vendas ou Enviar um tíquete em caso de ajuda.
comentários