本示例介绍如何使用Alibaba Cloud SDK for Java调用RDS的DescribeDatabases接口查看实例下的数据库信息。

前提条件

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

示例代码

说明
  • 如果请求参数错误,返回数据为空。
  • 该接口不支持PostgreSQL、PPAS实例。
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.rds.model.v20140815.DescribeDatabasesRequest;
import com.aliyuncs.rds.model.v20140815.DescribeDatabasesResponse;
import com.google.gson.Gson;

/**
 * 调用DescribeDatabases接口查看实例下的数据库信息。
 */
public class DescribeDatabases {
    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请求并获取参数
        DescribeDatabasesRequest request = new DescribeDatabasesRequest();
        // 实例ID
        request.setDBInstanceId("<your-DBInstanceId>");
        // 数据库名称(非必须按参数)
        request.setDBName("");
        // 数据库状态(非必须按参数)
        request.setDBStatus("");
        // 每页显示条数(分页非必须按参数)
        // request.setPageSize(100);
        // 显示页码(非必须按参数)
        // request.setPageNumber(1);

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