本示例介绍如何使用Alibaba Cloud SDK for Java调用RDS的DescribeDatabases接口查看实例下的数据库信息。
前提条件
- 使用Alibaba Cloud SDK for Java,您需要一个阿里云账号和访问密钥(AccessKey)。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey。
- 确保您已经安装了Alibaba Cloud SDK for Java,准确的SDK版本号,请参见 阿里云开发工具包(SDK)。
<project> <modelVersion>4.0.0</modelVersion> <groupId>java.demo</groupId> <artifactId>test</artifactId> <version>1.0-SNAPSHOT</version> <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> </project>
示例代码
说明
- 如果请求参数错误,返回数据为空。
- 该接口不支持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());
}
}
}