本示例介绍如何使用Alibaba Cloud SDK for Java调用RDS的CreateAccount接口创建管理数据库的账号。

前提条件

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

示例代码

调用该接口时,实例必须满足以下条件,否则将操作失败:
  • 实例状态为运行中。
  • 数据库状态为运行中。
  • 没有超出单个实例内的最大账号数量。
示例代码如下:
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.rds.model.v20140815.CreateAccountRequest;
import com.aliyuncs.rds.model.v20140815.CreateAccountResponse;
import com.google.gson.Gson;

/**
 * 调用CreateAccount接口创建管理数据库的账号。
 */
public class CreateAccount {
    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请求并获取参数
        CreateAccountRequest request = new CreateAccountRequest();
        // 实例ID
        request.setDBInstanceId("<your-DBInstanceId>");
        // 数据库账号名称
        request.setAccountName("<your-AccountName>");
        // 数据库账号的密码
        request.setAccountPassword("<your-AccountPassword>");
        // 账号描述
        request.setAccountDescription("测试账号A");
        // 账号类型
        // Normal:普通账号;Super:高权限账号。默认值:Normal。
        request.setAccountType("Normal");

        try {
            // 发请求获取返回结果
            CreateAccountResponse 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概览。