简介

欢迎使用金山云开发者工具套件（SDK）。为方便 JAVA 开发者调试和接入金山云产品 API，这里向您介绍适用于 JAVA 的金山云开发工具包，并提供首次使用开发工具包的简单示例。让您快速获取金山云 JAVA SDK 并开始调用。

依赖环境

1. JDK 7 版本及以上
2. 从金山云控制台 开通相应产品
3. 获取 secretId、secretKey。

获取安装

安装 JAVA SDK 前，先获取安全凭证。在第一次使用云 API 之前，用户首先需要在金山云控制台上申请安全凭证，安全凭证包括 secretId 和 secretKey， secretId 是用于标识 API 调用者的身份，secretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。secretKey 必须严格保管，避免泄露。

通过 MAVEN 安装

1. 在maven 项目 pom.xml 中添加sdk 依赖

     <groupId>com.ksyun</groupId>
     <artifactId>ksyun-java-sdk</artifactId>
     <version> 版本 </version>  //以maven中央仓库为准：https://mvnrepository.com/artifact/com.ksyun/ksyun-java-sdk
   

2. 在您的代码中引用对应模块代码，可参考示例。

通过源码包安装

1. 前往 Github 仓库下载源码压缩包。
2. 解压源码包到您项目合适的位置。
3. 在您的代码中引用对应模块代码，可参考示例。

示例

public static void main(String[] args) {
   // 创建凭证
   Credential credential = new Credential("YOUR_SECRET_KEY", "YOUR_SIGN_STR", "YOUR_REGION");

   // 创建客户端
   AssumeRoleClient client = new AssumeRoleClient(credential);

   // 创建请求对象
   AssumeRoleRequest request = new AssumeRoleRequest();
   // 设置请求参数
   request.setRoleSessionName("Test");
   try {
      AssumeRoleResponse response = client.doPostSend("sts.api.ksyun.com", request);
      if (response != null) {
         System.out.println("请求成功: " + JSON.toJSON(response));
      } else {
         System.out.println("响应为空");
      }
   } catch (RuntimeException e) {
      // SDK 已经格式化好错误信息，直接输出即可
      System.err.println(e.getMessage());
   }
}

更多示例

参见金山云控制台-API Explorer-对应服务-SDK示例。