本示例介绍如何使用Alibaba Cloud SDK for Java调用RDS的CreateDatabase接口在某个实例下创建数据库。

前提条件

  • 使用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>

示例代码

调用该接口时,实例必须满足以下条件,否则将操作失败:

  • 实例状态为运行中。
  • 实例中的数据库数量没有超出实例最大数据库数量,可以通过接口DescribeDBInstanceAttribute查询最大数据库数量。
  • 实例类型不能为只读实例。

说明 该接口暂不支持PostgreSQL、PPAS和SQL Server 2017集群版,您可以通过SQL做CREATE DATABASE操作。
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.rds.model.v20140815.CreateDatabaseRequest;
import com.aliyuncs.rds.model.v20140815.CreateDatabaseResponse;
import com.google.gson.Gson;

/**
 * 调用CreateDatabase接口在某个实例下创建数据库。
 */
public class CreateDatabase {
    public static void main(String[] args) {
        // 初始化请求参数
        DefaultProfile profile = DefaultProfile.getProfile(
                 "<your-region-id>",// 地域ID
                 "<your-access-key-id>",// 您的AccessKey ID
                 "<your-access-key-secret>");// 您的AccessKey Secret
        IAcsClient client = new DefaultAcsClient(profile);
        // 创建APi请求并获取参数
        CreateDatabaseRequest request = new CreateDatabaseRequest();
        // 实例ID
        request.setDBInstanceId("<your-DBInstanceId>");
        // 数据库名称
        request.setDBName("<your-DBName>");
        // 字符集
        request.setCharacterSetName("utf8");
        // 数据库描述
        request.setDBDescription("测试用数据库");

        try {
            CreateDatabaseResponse response = client.getAcsResponse(request);
            System.out.println(new Gson().toJson(response));
        } catch (ClientException e) {
            System.out.println("ErrCode:" + e.getErrCode());
            System.out.println("ErrMsg:" + e.getErrMsg());
            System.out.println("RequestId:" + e.getRequestId());
        }
    }
}
说明 更多接口信息,请参见API概览。