Help Center/ GeminiDB/ GeminiDB Redis API/ Getting Started with GeminiDB Redis API/ Buying and Connecting to a Cluster Instance
Updated on 2025-09-04 GMT+08:00
View PDF
Share

Buying and Connecting to a Cluster Instance

This section describes how to buy and connect to a proxy cluster or Redis Cluster GeminiDB Redis instance on the GeminiDB console.

  • In a sharded cluster, a proxy cluster GeminiDB Redis instance is connected through proxies to a standalone Redis instance, Redis Sentinel, and Redis Cluster. The proxy cluster instance has strong horizontal scaling capabilities and can handle millions of QPS and dozens of terabytes of data.
  • With the native Redis Cluster architecture, a Redis Cluster GeminiDB Redis instance is directly connected to Redis Cluster. It can greatly reduce latency while improving performance.

Each tenant can create a maximum of 50 GeminiDB Redis instances by default. To request a higher quota, choose Service Tickets > Create Service Ticket in the upper right corner of the console and contact the customer service.

Video Tutorial

This video shows you how to buy and log in to a GeminiDB Redis instance.

Step 1: Buying an Instance

  1. Log in to the Huawei Cloud console.
  2. In the service list, choose Databases > GeminiDB.
  3. On the Instances page, click Buy DB Instance.
  4. On the displayed page, select a billing mode, configure instance specifications, and click Next.
The following parameters are for reference only. Select proper specifications as needed. Table 1 lists details about the parameters.
Figure 1 Billing mode and basic information (proxy cluster)
Figure 2 Billing mode and basic information (Redis Cluster)

Parameter

Example Value

Description

Billing mode description

Pay-per-use

Billing mode of an instance

  • Yearly/Monthly: A prepaid billing mode in which you pay for resources before using it. Bills are settled based on the subscription period. The longer the subscription term, the bigger the discount. This mode is a good option for long-term stable services.
  • Pay-per-use is a postpaid mode. You are billed based on how long you have actually used GeminiDB. Pricing is listed on a per-hour basis, and bills are calculated down to the second. This mode allows you to adjust resource usage easily. You neither need to prepare for resources in advance, nor end up with excessive or insufficient preset resources.

Region

Select CN-Hong Kong.

Region where a tenant is located

NOTE:

To reduce network latency, select a region nearest from which you will access the instance. Instances deployed in different regions cannot communicate with each other over a private network. After you buy an instance, you cannot change its region.

DB Instance Name

User-defined

The instance name:

  • Can be the same as an existing instance name.
  • Can contain 4 to 64 characters and must start with a letter. It is case-sensitive and allows only letters, digits, hyphens (-), and underscores (_).

Compatible API

Redis

GeminiDB is compatible with mainstream NoSQL databases, including Redis, DynamoDB, Cassandra, HBase, MongoDB, and InfluxDB. You can select GeminiDB APIs by following How Do I Select an API?

Storage Type

Classic
  • Classic: classic architecture with decoupled storage and compute
  • Cloud native: more flexible, new-gen version with support for more AZs

Product Type

Standard
  • Standard: Stable and low-latency performance is provided for common scenarios such as advertising and recommendation, gaming, e-commerce, and Internet of Vehicles (IoV).
  • Capacity-oriented: Large-capacity key-value storage is suitable for average performance requirements and expectations of low costs.
NOTE:

Standard is unavailable for instances with cloud native storage.

DB Instance Type

Proxy cluster
  • Proxy cluster:

In a sharded cluster, a proxy cluster GeminiDB Redis instance is connected through proxies to a standalone Redis instance, Redis Sentinel, and Redis Cluster. The proxy cluster instance has strong horizontal scaling capabilities and can handle millions of QPS and dozens of terabytes of data.

  • RedisCluster

With the native Redis Cluster architecture, a Redis Cluster GeminiDB Redis instance is directly connected to Redis Cluster. It can greatly reduce latency while improving performance.

Compatible Version

7.0

7.0, 6.2 (including 6.2.X), 5.0, and earlier versions

CPU Type

x86

x86 CPUs use the Complex Instruction Set Computing (CISC) instruction set. Each instruction can be used to execute low-level hardware operations. Executing these instructions is complex and time-consuming.

AZ

AZ 1, AZ 2, and AZ 3

Availability zone where the instance is created. An AZ is a part of a region with its own independent power supplies and networks. AZs are physically isolated but can communicate with each other over a private network.
Figure 3 Specifications and storage

Parameter

Example Value

Description

Instance Creation Method

Fast configure

Two options are available:

  • Fast configure

    Provides you with recommended specifications. You can select one of them based on service requirements, without the need to specify the specifications, node quantity, and storage space.

  • Standard configure

    Provides a standard process to configure instance specifications, including specifying the specifications, node quantity, and storage space.

    Currently, a maximum of 36 nodes are supported. To add more, choose Service Tickets > Create Service Ticket in the upper right corner of the console and contact the customer service.

Instance Specifications

2U8GB

Higher CPU specifications provide better performance. Select specifications as needed.

For details, see Instance Specifications.
Figure 4 Network and database configurations

Parameter

Example Value

Description

VPC

default_vpc

Virtual private network where your instances are located. A VPC isolates networks for different services. You can select an existing VPC or create a VPC.

NOTE:
  • After a GeminiDB Redis instance is created, its VPC cannot be changed.
  • If you want to connect to a GeminiDB Redis instance through an ECS over an internal network, the GeminiDB Redis instance and the ECS must be in the same VPC. If they are not in the same VPC, you can create a VPC peering connection to enable access.

Subnet

default_subnet

A subnet provides dedicated network resources that are logically isolated from other networks for security purposes.

Database Port

6379

Port number for accessing a database. If you do not specify a port number, default port 6379 is used. You can specify a port number based on your requirements. The port number ranges from 1024 to 65535 except 2180, 2887, 3887, 6377, 6378, 6380, 8018, 8079, 8091, 8479, 8484, 8999, 12017, 12333, and 50069.

Access Control

Skip
  • Skip: Access is restricted based on the VPC access policy by default.
  • Configure:

Specify how access is controlled. Three options are available:

All IP addresses: All IP addresses can access the instance.

Whitelist: Only IP addresses in a group can access the instance.

Blacklist: IP addresses in a group cannot access the instance.

NOTE:

Redis Cluster GeminiDB Redis instances do not support access control.

Password

Skip
  • Skip: You can set the database password after creating an instance.
  • Configure: You can set the database password when creating an instance.
NOTE:

You cannot set a password after creating a Redis Cluster GeminiDB Redis instance.

Password

Configured based on the password policy

If Password is set to Configure, you need to set the database password.

  • Must be 8 to 32 characters long.
  • Can contain at least two types of the following characters: uppercase letters, lowercase letters, digits, and special characters ~!@#%^*-_=+?
  • For security reasons, set a strong password. The system will verify the password strength.

Keep your password secure. The system cannot retrieve it if it is lost.

Password-Free Access

Skip

If you configure password-free access for a CIDR Block of an instance, you do not need to enter a password when connecting to the instance.

For details, see Table 5.

NOTE:

Redis Cluster GeminiDB Redis instances do not support password-free access.

Enterprise Project

default

This parameter is provided for enterprise users.

An enterprise project groups cloud resources, so you can manage resources and members by project. The default project is default.

Select an enterprise project from the drop-down list. For more information about enterprise projects, see Enterprise Management User Guide.

Retain the default values for other parameters.

5. On the order confirmation page, check the instance information. If you need to modify the information, click Previous. If no modification is required, read and agree to the service agreement and click Submit.

6. Click Back to Instance Management to go to the instance list.

7. On the Instances page, view and manage the created instance.
  • Creating an instance takes about 5 to 9 minutes. During the process, the instance status becomes Creating.
  • After the instance is created, its status becomes Available.
Figure 5 Available instance

Step 2: Connecting to an Instance Through DAS

DAS enables you to manage DB instances from a web-based console, simplifying database management and improving efficiency. You can connect and manage instances through DAS. By default, you have the permission of remote login. DAS is secure and convenient for connecting to DB instances.

  1. Log in to the Huawei Cloud console.
  2. In the service list, choose Databases > GeminiDB.
  3. In the instance list, locate the target instance and click Log In in the Operation column.
    Figure 6 Connecting to a GeminiDB Redis instance

    Alternatively, click the instance name to go to the Basic Information page. Click Log In in the upper right corner of the page.

    Figure 7 Connecting to a GeminiDB Redis instance
  4. Enter a password for logging in to the instance.
    Figure 8 Logging in to the GeminiDB Redis instance

    If you need to log in again after the password is reset, click Re-login in the upper right corner and use the new password.

    Figure 9 Re-login
  5. Manage relevant databases.
    Figure 10 Instance homepage
    • Save commands to the execution record.

      This function is enabled by default to save the recently executed commands for your later query.

      Then you can click the Executed Commands tab on the lower page to view historical commands.

      Figure 11 Viewing executed commands

      If this function is disabled, the commands executed subsequently are not displayed. You can click next to Save Executed SQL Statements in the upper right corner to disable this function.

    • Execute a command.

      Enter a command in the command window and click Execute or F8.

      • Do not use transactions, Lua scripts, Pub/Sub commands, or other commands that have blocking semantics.
      • For an instance that supports multiple databases, you can change the current database on the console but cannot change it using a SELECT statement.
      Figure 12 Executing a command

      After a command is executed, you can view the execution result on the Results page.

    • Save a command.

      You can save a command to all instances, the current instance, or the current database. Then you can view details in My Commands.

      Figure 13 Saving a command
    • View my commands.

      Common commands are displayed the My Commands page.

      You can set a filter to narrow the scope of commands. If you select All, all commands saved in the current account are displayed.

      Figure 14 Filtering commands

      Alternatively, you can enter a command title or statement in the search box to search for the corresponding command.

      Figure 15 Searching for a command

      On the My Commands page, you can also create, edit, and delete a command or copy it to the command window.

      Figure 16 Managing a command

    • Clear a command.

      You can also press F10 to clear the command in the command window.

      Figure 17 Clearing a command

FAQs

Question: What should I do if the DAS console cannot be redirected after I click Log In in the Operation column in the instance list or click Log In on the Basic Information page?

Solution: Set your browser to allow pop-ups and try again.

Parent Topic: Getting Started with GeminiDB Redis API