InquiryPriceCreateInstance

最后更新时间：2025-10-28 22:21:55

InquiryPriceCreateInstance

最后更新时间： 2025-10-28 22:21:55

1. API Description

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

This API is used to query the price of new instances.

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: InquiryPriceCreateInstance.
Version	Yes	String	Common Params. The value used for this API: 2018-04-12.
Region	Yes	String	Common Params. For more information, please see the list of regions supported by the product.
TypeId	Yes	Integer	Instance type. - 2: Redis 2.8 memory edition (standard architecture). - 6: Redis 4.0 memory edition (standard architecture). - 7: Redis 4.0 memory edition (cluster architecture). - 8: Redis 5.0 memory edition (standard architecture). - 9: Redis 5.0 memory edition (cluster architecture). - 15: Redis 6.2 memory edition (standard architecture). - 16: Redis 6.2 memory edition (cluster architecture). - 17: Redis 7.0 memory edition (standard architecture). - 18: Redis 7.0 memory edition (cluster architecture). - 200: Memcached 1.6 memory edition (cluster architecture).
MemSize	Yes	Integer	Memory capacity in MB, which must be a multiple of 1,024. It is subject to the purchasable specifications returned by the DescribeProductInfo API. If `TypeId` indicates the standard architecture, `MemSize` indicates the total memory capacity of an instance; if `TypeId` indicates the cluster architecture, `MemSize` indicates the memory capacity per shard.
GoodsNum	Yes	Integer	Number of instances. The actual quantity purchasable at a time is subject to the specifications returned by the DescribeProductInfo API.
Period	Yes	Integer	Length of purchase in months, which is required when creating a monthly-subscribed instance. Value range: [1,2,3,4,5,6,7,8,9,10,11,12,24,36]. For pay-as-you-go instances, set the parameter to `1`.
BillingMode	Yes	Integer	Billing mode. - 0: pay-as-you-go. - 1: monthly subscription.
ZoneId	No	Integer	ID of the AZ to which the instance belongs. See Regions and AZs. Note: Specify at least one parameter from ZoneId and ZoneName.
RedisShardNum	No	Integer	Number of instance shards. - The number of shards is required to be set to 1 for the standard architecture. - The number of shards can be set to 1, 3, 5, 8, 12, 16, 24, 32, 40, 48, 64, 80, 96, or 128 for the cluster architecture.
RedisReplicasNum	No	Integer	Number of instance replicas. Valid values: 1, 2, 3, 4, and 5.
ReplicasReadonly	No	Boolean	Whether replica read-only is supported. For the standard architecture of Redis 2.8 and CKV, this parameter does not need to be configured. - true: Replica read-only is not required. - false: Replica read-only is required.
ZoneName	No	String	Name of the AZ to which the instance belongs. See Regions and AZs. Note: Specify at least one parameter from ZoneId and ZoneName.
ProductVersion	No	String	Deployment mode. - local: local disk. This is the default value. - cloud: cloud disk. - cdc: CDC.

3. Output Parameters

Parameter Name	Type	Description
Price	Float	Price.
HighPrecisionPrice	Float	High precision price.
Currency	String	Currency.
AmountUnit	String	Price unit. - pent: cent. - microPent: microcent.
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 Example

Input Example

https://redis.intl.tencentcloudapi.com/?Action=InquiryPriceCreateInstance
&ZoneId=100002
&TypeId=6
&MemSize=4096
&GoodsNum=1
&Period=1
&BillingMode=1
&<Common request parameters>

Output Example

{
    "Response": {
        "Price": 30400,
        "HighPrecisionPrice": 30400.123,
        "Currency": "CNY",
        "AmountUnit": "pent",
        "RequestId": "0115d979-2c38-4ad2-b282-bec09d5b4c0b"
    }
}

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
FailedOperation.SystemError	Internal system error, which is irrelevant to the business.
InternalError.InternalError	Internal error.
InvalidParameter.PermissionDenied	The API has no CAM permissions.
InvalidParameterValue.SpecNotExist	The instance specification doesn’t exist.
UnauthorizedOperation.NoCAMAuthed	No CAM permissions.
UnauthorizedOperation.UserNotInWhiteList	The user is not in the allowlist.

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

是

否

文档反馈

tencent cloud