CreateInstances
API to make a purchase.Parameter | Required | Description |
Billing Mode | Yes | Currently, only pay-as-you-go is supported. |
Region | Yes | Select a region where your instance resides. You should select a region closest to you to reduce access latency. Note that the region cannot be changed after the instance is successfully created. We recommend that you select the same region as the CVM instance for private network communication. The private network between cloud products in different regions is not interconnected and cannot be changed after purchase, so choose carefully. For example, a cloud server in the Guangzhou region cannot access Redis in the Shanghai region via the private network. If cross-region private network communication is needed, see CCN (Cloud Connect Network, CCN). |
Instance Edition | Yes | Redis Edition: A high-performance edition based on the open-source Redis. Memcached Edition: A high-performance edition designed specifically for caching scenes based on the Memcached protocol version 1.6. |
Compatible Version | Yes | Redis Edition: Compatible with Redis 7.0, 6.2, 5.0, 4.0, and 2.8. Redis 2.8 is currently not available for purchase. It is recommend to choose version 4.0 or later. If you need version 2.8, submit a ticket to apply. Memcached Edition: Compatible with Memcached protocol version 1.6. |
Architecture | Yes | Choose the product deployment architecture. For more information, see Standard Architecture and Cluster Architecture. Redis Edition: Version 4.0 and later supports both standard and cluster architectures. Version 2.8 only supports standard architecture. Memcached Edition: Only supports cluster architecture. |
Memory | Yes | Configure the required memory size (0.25–64 GB) if you select Standard Architecture for Architecture. |
Replica Quantity | Yes | Select the number of database replicas. Multiple replicas provide master-replica high availability, enhancing the data security. Replicas can also be used to enhance the read-only performance. The replica quantity may vary by region or edition as configured in the console by default. |
Shard Quantity | Yes | Set the number of shards as needed if you select Cluster Architecture for Architecture. The more the shards, the larger the cluster storage capacity. |
Shard Capacity | Yes | Set the capacity of each shard if you select Cluster Architecture for Architecture. Note: For newly purchased instances, the maximum network throughput here already includes the default additional bandwidth. The additional bandwidth for one shard is consistent across both standard and cluster architectures. |
Specs Preview | - | Preview the selected specification and the supported maximum number of connections and maximum network throughput to verify whether they meet your expectations. |
Read-Only Replica | No | Select whether to enable the read-write separation feature. Only the Redis Memory Edition supports this feature, and the Memcached Edition does not. When read-write separation is enabled, write operations are routed to the primary node, while read operations are routed to replica nodes. Data read from the replica node may be delayed compared with the primary node. If not enabled during purchase, it can be enabled later based on actual business needs. For more information, see Read-Write Separation. |
Network Type | Yes | Currently, only VPC is supported. |
AZ | Yes | Choose whether to enable multi-AZ deployment. Both single-AZ deployment and multi-AZ deployment are supported. Multi-AZ deployed instances have higher availability and better disaster recovery capability than single-AZ deployed instances. For more information, see Multi-AZ Deployment. For single-AZ deployment, select the AZ of the master node in **Master Node Group (Master AZ)**. For multi-AZ deployment, select the master AZ from the drop-down list of **Master Node Group (Master AZ)**, and specify the AZs for replicas in the drop-down lists of replicas. |
IPv4 Network | Yes | Select the VPC and subnet. We recommend that you select the same VPC in the same region as the CVM instance to be connected to. VPCs are region-specific (e.g., Guangzhou), while subnets are AZ-specific (e.g., Guangzhou Zone 1). One VPC can be divided into one or multiple subnets, which are interconnected over the private network by default. Different VPCs are isolated over the private network by default, no matter whether they are in the same or different regions. You can switch the VPC after instance purchase as instructed in Configuring Network. You can also click Create VPCs and Create Subnets to create the desired network environment as instructed in Creating VPC. |
Port | Yes | Custom port. The default port is 6379. The value range is [1024,65535]. |
Parameter Template | Yes | Select the parameter template associated with the instance. You can apply a parameter template to configure parameters in batches for the instance. The system will automatically adapt the corresponding default template based on the selected compatible version and architecture. For more information, see the default template in Applying Parameter Templates. |
Project | Yes | Assign your instance to a project for easy management. |
Tag | No | Add tags to your instance for easy classification and management. Click Add to select tag keys and values. |
Security Group | Yes | Set security group rules to control the inbound traffic to your database. You can either select a security group from the Existing Security Groups drop-down list or click Custom Security Groups to create one and set inbound rules. For more information, see Configuring Security Group. After selecting the security group from the dropdown list, you can click Rule Preview to view the protocol rule policies of that security group. |
Alarm Policy | Yes | Select the alarm policy for the monitoring metric. If it is not selected, TencentDB for Redis® provides a default alarm policy. You can access the Tencent Cloud Observability Platform (TCOP) to view the default policy on the alarm management page. Select a custom alarm policy. First log in to the Tencent Cloud Observability Platform (TCOP) to configure the alarm policy on the Alarm Management page. For detailed directions, see Create Alarm Policy. |
Instance Name | Yes | Enter up to 60 letters, digits, hyphens, and underscores. |
Set Password | Yes | Choose the authentication method, supporting both Password Authentication and Password-Free Authentication. Password Authentication is the default option. Tencent Cloud Memcached Edition only supports password-free authentication, enabling Password-Free Access. |
Password | No | If you select Password Authentication for Set Password, you need to set an access password for the instance according to the following requirements: It can contain [8,64] characters. It must contain at least two of the following four types: lowercase letters, uppercase letters, digits, and symbols (()`~!@#$%^&*-+=_|{}[]:;<>,.?/). It cannot start with a slash (/). |
Confirm Password | No | Enter the access password for the instance again. |
Quantity | Yes | The maximum number of instances you can purchase at a time is 30, with a regional quota of 200 instances. |
Terms of Service | Yes | Read TencentDB Service Level Agreement and Service Level Agreement and select I have read and agreed to. |
API | Description |
Creates a TencentDB for Redis® instance |
Was this page helpful?