Release Notes and Announcements

Release Notes

Product Announcements

Product Introduction

Overview

Features

Strengths

Scenarios

Information Security

Regions and AZs

Product Feature List

Large version lifecycle description

MSSQL Compatible Version

Billing

Billing Overview

Instance Type and Specification

Purchase Methods

Refund

Overdue Payments

Backup Space Billing

Database Audit Billing Overview

Getting Started

Creating TencentDB for PostgreSQL Instance

Connecting to TencentDB for PostgreSQL Instance

Managing TencentDB for PostgreSQL Instance

Importing Data

Migrating Data with DTS

Kernel Version Introduction

Kernel Version Overview

Kernel Version Release Notes

Viewing Kernel Version

Proprietary Kernel Features

Database Audit

Audit Service Description

Activating Audit Service

View Audit Logs

Modify audit services

Audit Performance Description

User Guide

Instance Management

Upgrading Instance

CPU Elastic Scaling

Read-Only Instance

Account Management

Database Management

Parameter Management

Log Management and Analysis

Backup and Restoration

Data Migration

Extension Management

Network Management

Access Management

Data Security

Tenant and Resource Isolation

Security Groups

Monitoring and Alarms

Tag

AI Practice

Using the Tencentdb_ai Plug-In to Call Large Models

Building Ai Applications with the Tencentdb Ai Plug-In

Combining Supabase to Quickly Build Backend Service Based on TencentDB for PostgreSQL

Use Cases

postgres_fdw Extension for Cross-database Access

Automatically Creating Partition in PostgreSQL

Searching in High Numbers of Tags Based on pg_roaringbitmap

Querying People Nearby with One SQL Statement

Configuring TencentDB for PostgreSQL as GitLab's External Data Source

Supporting Tiered Storage Based on cos_fdw Extension

Implement Read/Write Separation via pgpool

Implementing Slow SQL Analysis Using the Auto_explain Plugin

Using pglogical for Logical Replication

Using Debezium to Collect PostgreSQL Data

Set Up a Remote Disaster Recovery Environment for PostgreSQL Locally on CVM

Read-Only Instance and Read-Only Group Practical Tutorial

How to Use SCF for Scheduled Database Operations

Fix Table Bloat

Performance White Paper

Test Methods

Test Results

API Documentation

History

Introduction

API Category

Making API Requests

Instance APIs

Read-Only Instance APIs

Backup and Recovery APIs

Parameter Management APIs

Security Group APIs

Performance Optimization APIs

Account APIs

Specification APIs

Network APIs

Data Types

Error Codes

FAQs

Service Agreement

Service Level Agreement

Glossary

InquiryPriceCreateDBInstances

PDF

Focus Mode

Font Size

Last updated: 2026-03-26 22:28:00

1. API Description

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.

We recommend you to use API Explorer

Try it

API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

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	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	DB engine, default is postgresql, supports the following: postgresql (TencentDB for PostgreSQL) mssql_compatible (MSSQL-compatible - TencentDB for PostgreSQL)

3. Output Parameters

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.

4. Example

Example1 Querying the purchase price of an instance

This example shows you how to query the purchase price of an instance.

Input Example

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-7",
    "Storage": "100",
    "Pid": "11004",
    "Period": "1",
    "SpecCode": "cdb.pg.z1.2g",
    "InstanceChargeType": "PREPAID"
}

Output Example

{
    "Response": {
        "RequestId": "8a61e500-aa33-454c-9ec2-da2a368c39ab",
        "OriginalPrice": 27600,
        "Price": 27600,
        "Currency": "USD"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

Tencent Cloud CLI 3.0

6. Error Code

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

Help and Support

Was this page helpful?

You can also Contact sales or Submit a Ticket for help.

Help us improve! Rate your documentation experience in 5 mins.

Feedback

tencent cloud

TencentDB for PostgreSQL