本示例介绍如何使用Alibaba Cloud SDK for Java调用RDS的CreateDBInstance接口创建一个RDS实例。

阿里云关系型数据库(Relational Database Service,简称RDS)是一种稳定可靠、可弹性伸缩的在线数据库服务。基于阿里云分布式文件系统和高性能存储,RDS 支持MySQL、SQL Server、PostgreSQL和PPAS(Postgre Plus Advanced Server,一种高度兼容 Oracle 的数据库)引擎,并且提供了容灾、备份、恢复、监控和迁移等方面的全套解决方案,彻底解决数据库运维的烦恼。

前提条件

  • 使用Alibaba Cloud SDK for Java,您需要一个阿里云账号和访问密钥(AccessKey)。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey。
  • 确保您已经安装了Alibaba Cloud SDK for Java,准确的SDK版本号,请参见 阿里云开发工具包(SDK)
    <dependencies>
        <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-core -->
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>4.4.3</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-rds -->
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-rds</artifactId>
            <version>2.3.9</version>
        </dependency>
    </dependencies>

示例代码

注意 运行该示例代码将创建RDS实例,并产生实际费用。
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.rds.model.v20140815.CreateDBInstanceRequest;
import com.aliyuncs.rds.model.v20140815.CreateDBInstanceResponse;
import com.google.gson.Gson;
import java.util.UUID;

public class CreateRDS {
    public static void main(String[] args) {

        // 创建DefaultAcsClient实例并初始化
        DefaultProfile profile = DefaultProfile.getProfile(
                 "<your-region-id>",  // 地域ID,可以通过接口 DescribeRegions 查看可用的地域ID。
                 "<your-access-key-id>",             // 您的AccessKey ID
                 "<your-access-key-secret>");        // 您的AccessKey Secret
        // 创建API请求并设置参数
        IAcsClient client = new DefaultAcsClient(profile);
        CreateDBInstanceRequest request = new CreateDBInstanceRequest();
        // 数据库类型取值:MySQL;SQLServer;PostgreSQL;PPAS;MariaDB。
        request.setEngine("MySQL");
        // 数据库版本,取值:
        // MySQL:5.5/5.6/5.7/8.0;
        // SQL Server:2008r2/2012/2012_ent_ha/2012_std_ha/2012_web/2016_ent_ha/2016_std_ha/2016_web/2017_ent;
        // PostgreSQL:9.4/10.0;
        // PPAS:9.3/10.0;
        // MariaDB:10.3。
        request.setEngineVersion("5.7");
        // 实例规格,详见实例规格表。
        request.setDBInstanceClass("mysql.n4.xlarge.1");
        // 实例存储空间,单位:GB。每5GB进行递增,详见实例规格表。
        request.setDBInstanceStorage(20);
        // 实例的网络连接类型,取值:
        // Internet:公网连接;
        // Intranet:内网连接。
        request.setDBInstanceNetType("Internet");
        // 实例的付费类型,取值:
        // Postpaid:后付费(按量付费);
        // Prepaid:预付费(包年包月)。
        request.setPayType("Postpaid");
        // 该实例的IP白名单,多个IP地址请以英文逗号(,)隔开,不可重复,最多1000个。支持如下两种格式:
        // IP地址形式,例如:10.23.12.24;
        // CIDR形式,例如:10.23.12.24/24(无类域间路由,24表示了地址中前缀的长度,范围为1~32)。
        request.setSecurityIPList("30.40.53.25");
        // 字符集,取值:
        // MySQL/MariaDB实例:utf8、gbk、latin1、utf8mb4;
        // SQL Server实例:Chinese_PRC_CI_AS、Chinese_PRC_CS_AS、SQL_Latin1_General_CP1_CI_AS、SQL_Latin1_General_CP1_CS_AS、Chinese_PRC_BIN。
        request.setSystemDBCharset("utf8");
        // 实例名称,长度为2~256个字符。以中文、英文字母开头,可以包含数字、中文、英文、下划线(_)、短横线(-)。
        request.setDBInstanceDescription("测试数据库");
        // 用于保证请求的幂等性,防止重复提交请求。
        // 由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。
        request.setClientToken(UUID.randomUUID().toString());
        // 可用区ID。多可用区用英文冒号(:)分隔。
        // 指定了VPC和交换机时,为匹配交换机对应的可用区,该参数必填。
        //request.setZoneId("cn-hangzhou-b:cn-hangzhou-a:cn-hangzhou-h");
        request.setZoneId("cn-hangzhou-b");
        // 实例的网络类型,取值:
        // VPC:VPC网络;
        // Classic:经典网络。
        request.setInstanceNetworkType("Classic");
        // 实例的访问模式,取值:
        // Standard:标准访问模式;
        // Safe:数据库代理模式。
        request.setConnectionMode("Standard");
        // 实例存储类型,取值:
        // local_ssd/ephemeral_ssd:本地SSD盘(推荐);
        // cloud_ssd:SSD云盘;
        // cloud_essd:ESSD云盘。
        request.setDBInstanceStorageType("cloud_ssd");

        try {
            // 发起请求并获取返回值
            CreateDBInstanceResponse response = client.getAcsResponse(request);
            //  处理业务逻辑
            System.out.println(new Gson().toJson(response));
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }
    }
}
说明 更多参数信息,请参见API参考