Java SDK

背景信息

RAM SDK包含阿里云Java SDK公共部分和RAM部分：

• 阿里云Java SDK公共部分依赖aliyun-java-sdk-core。关于SDK示例代码的自动生成和在线API调试，请参见OpenAPI Explorer。
• RAM部分依赖aliyun-java-sdk-ram。关于RAM API接口相关信息，请参见API参考（RAM）。

Java SDK的安装方法

您可以通过Maven管理项目依赖或手动下载RAM SDK的jar包后手动添加到项目中。

• 通过Maven管理项目依赖（推荐）。
  1. 使用Maven创建项目。

     mvn archetype:generate -DgroupId=com.aliyun.ram.sample \
     -DartifactId=ram-sdk-sample \
     -Dpackage=com.aliyun.ram.sample \
     -Dversion=1.0-SNAPSHOT

  2. 在项目的pom.xml文件中加入相应依赖项。

     添加aliyun-java-sdk的相关依赖，以2.0.7版本为例，在标签内添加如下内容：

     <dependency>
         <groupId>com.aliyun</groupId>
         <artifactId>aliyun-java-sdk-ram</artifactId>
         <version>2.0.7</version>
     </dependency>
     <dependency>
         <groupId>com.aliyun</groupId>
         <artifactId>aliyun-java-sdk-core</artifactId>
         <version>4.4.6</version>
     </dependency>

     说明

     对于上述代码示例的说明如下：

     • aliyun-java-sdk已经加入到Maven仓库中，无需设置settings.xml。
     • 请访问Maven仓库获取aliyun-java-sdk-core的最新版本。
• 手动下载RAM SDK的jar包后手动添加到项目中。

  下载地址：

  • Java SDK
  • RAM SDK

Java SDK示例

以Java SDK为例，说明如何创建RAM用户。

package com.aliyun.ram.sample;

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

//当前RAM API版本为：2015-05-01
import com.aliyuncs.ram.model.v20150501.*;

/**
 * Created by JasonGao on 15/11/4.
 */

public class RamServiceSample {

    public static void main(String[] args) {
        //构建一个阿里云client, 用于发起请求
        //构建阿里云client时需要设置AccessKey ID和AccessKey Secret
        //RAM是Global Service, API入口位于华东 1（杭州），这里地域填写：cn-hangzhou
        IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou",
                                                           "<AccessKeyId>",
                                                           "<AccessKeySecret>");
        DefaultAcsClient client = new DefaultAcsClient(profile);

        //构建CreateUser请求
        final CreateUserRequest request = new CreateUserRequest();

        //设置参数：UserName
        request.setUserName("alice");

        //发起请求，并得到response
        try {
            final CreateUserResponse response = client.getAcsResponse(request);

            System.out.println("UserName: " + response.getUser().getUserName());
            System.out.println("CreateTime: " + response.getUser().getCreateDate());
        } catch (ClientException e) {
            System.out.println("Failed.");
            System.out.println("Error code: " + e.getErrCode());
            System.out.println("Error message: " + e.getErrMsg());
        }

    }
}