Connecting to a GeminiDB (DynamoDB API Compatible) Instance

Prerequisites

• A GeminiDB (DynamoDB API compatible) instance has been created.
• For details about how to create an ECS, see Purchasing an ECS in Getting Started with Elastic Cloud Server.
• JDK has been installed on the ECS.

Obtaining the IP Address of a GeminiDB (DynamoDB API compatible) Instance

1. Log in to the Huawei Cloud console.
2. In the service list, choose Databases > GeminiDB Cassandra API.
3. On the Instances page, click the name of the target instance.

   The GeminiDB (DynamoDB API compatible) instance uses port 8000.

   Method 1

   In the Node Information area on the Basic Information page, obtain the private IP address or EIP of each node.

   Figure 1 Obtaining IP addresses
   

   Method 2

   In the navigation pane, choose Connections to obtain the private IP address and EIP of the instance.

   Figure 2 Obtaining IP addresses
   

Using a Load Balancing Plug-in to Connect to a GeminiDB (DynamoDB API Compatible) Instance

1. To obtain the JAR package and plug-in code, choose Service Tickets > Create Service Ticket in the upper right corner of the console and contact customer service.
2. Replace the IP address in the following code example with the IP address queried in 3.

   The following is a Java code example:

   package com.huawei.dbs.test;  
   
   import com.huawei.dbs.RequestHandler;  
   
   import com.amazonaws.SDKGlobalConfiguration;  
   import com.amazonaws.auth.AWSCredentialsProvider;  
   import com.amazonaws.auth.AWSStaticCredentialsProvider;  
   import com.amazonaws.auth.BasicAWSCredentials;  
   import com.amazonaws.services.dynamodbv2.AmazonDynamoDB;  
   import com.amazonaws.services.dynamodbv2.AmazonDynamoDBClientBuilder;  
   import com.amazonaws.services.dynamodbv2.document.DynamoDB;  
   import com.amazonaws.services.dynamodbv2.document.TableCollection;  
   
   import java.net.URI;  
     
   
   public class V1Demo {  
       public static AWSCredentialsProvider myCredentials = new AWSStaticCredentialsProvider(  
           new BasicAWSCredentials("your_ak", "your_sk"));  
       public static String ip = "***.***.***.***";  
       public static void main(String[] args) {  
           disableCertificateChecks();  
           AmazonDynamoDB client = AmazonDynamoDBClientBuilder.standard()  
               .withRegion("region-a")  
               .withRequestHandlers(new RequestHandler(URI.create("http://" + ip + "8000")))  
               .withCredentials(myCredentials)  
               .build();  
           DynamoDB dynamoDB = new DynamoDB(client);  
           TableCollection res = dynamoDB.listTables();  
           System.out.println(res);  
       }  
     
   }

   The following is a Python code example:

   #!/usr/bin/python  
   import boto3  
   import boto3_lb  
   
   ip = '***.***.***.***'  
   url = boto3_lb.setup([ip], 'http', 8000, 'fake.url.com')  
   dynamodb = boto3.resource('dynamodb',  
                             endpoint_url=url,  
                             aws_access_key_id='ak',  
                             aws_secret_access_key='sk',  
                             region_name="region-a")  
   
   url = boto3_lb.setup_single_connection([ip], 'http', 8000, 'fake.url.com')  
   
   dynamodb = boto3.resource('dynamodb',  
                             endpoint_url=url,  
                             aws_access_key_id='ak',  
                             aws_secret_access_key='sk',  
                             region_name="region-a")  

Connecting to an Instance over HTTPS

Prerequisites:

• The instances must be in the same VPC and subnet as the ECS.
• The ECS must be accessible to the security group to which the target instance belongs. For details, see Setting Security Group Rules for a GeminiDB Cassandra Instance.
• Enable SSL for the GeminiDB instance by following Encrypting Data over SSL for a GeminiDB Cassandra Instance and download a certificate by following Downloading the SSL Certificate. Take a Java application as an example. The command for importing the certificate is as follows:

  keytool -importcert -alias hw -file ca.cert -keystore truststore.jks -storepass password