InquirePriceModifyDBInstanceSpec

Last updated: 2025-12-03 10:42:01

InquirePriceModifyDBInstanceSpec

Last updated: 2025-12-03 10:42:01

1. API Description

Domain name for API request: mongodb.intl.tencentcloudapi.com.

This API is used to query the price of instance specification adjustment.

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: InquirePriceModifyDBInstanceSpec.
Version	Yes	String	Common Params. The value used for this API: 2019-07-25.
Region	Yes	String	Common Params. For more information, please see the list of regions supported by the product.
InstanceId	Yes	String	Instance ID. For example, cmgo-p8vn****. Log in to the TencentDB for MongoDB console, and copy the instance ID from the instance list.
Memory	Yes	Integer	Instance memory size after configuration changes, in GB. The DescribeSpecInfo API can be called to obtain the specific sales specifications for memory.
Volume	Yes	Integer	Instance disk size after configuration changes, in GB. The DescribeSpecInfo API can be called to obtain the maximum and minimum disk sizes corresponding to each CPU specification.
NodeNum	No	Integer	Number of instance nodes. The DescribeSpecInfo API can be called to obtain the number of instance nodes. - Replica set instance, which refers to the number of primary and secondary nodes for the instance after configuration changes. - Sharded cluster instance, which refers to the number of primary and secondary nodes per shard for the instance after configuration changes. Note: Do not initiate tasks of adjusting the number of nodes and shards and the node specifications simultaneously.
ReplicateSetNum	No	Integer	Sharded cluster instance, which refers to the number of shards for the instance after configuration changes. Value range: [2, 36]. Note: The number of shards after changes cannot be less than the current number. Do not initiate tasks of adjusting the number of nodes and shards and the node specifications simultaneously.

3. Output Parameters

Parameter Name	Type	Description
Price	DBInstancePrice	Price.
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 price of a specified instance after adjustment

This example shows you how to query the price of a specified instance after adjustment.

Input Example

https://mongodb.intl.tencentcloudapi.com/?Action=InquirePriceModifyDBInstanceSpec
&InstanceId=cmgo-8oij5631
&Memory=8
&Volume=200
&<Common request parameters>

Output Example

{
    "Response": {
        "Price": {
            "DiscountPrice": 449.36,
            "OriginalPrice": 660.82,
            "UnitPrice": 0
        },
        "RequestId": "ac618a97-5a29-4003-8489-fd8a1e1cc8e9"
    }
}

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
InternalError.FindInstanceFailed	Failed to query the instance.
InvalidParameter.PermissionDenied	The current sub-account has no permission to perform this operation.
InvalidParameterValue.ZoneClosed	Instances are not purchasable in this AZ.

Was this page helpful?

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

Yes

Feedback

tencent cloud