本文简要介绍了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 概览

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.2,5.0.0)</version>
      </dependency>
      说明 aliyun-java-sdk已经加入到Maven仓库中,无需设置settings.xml
  • 手动下载RAM SDK的jar包后手动添加到项目中。

    下载地址:

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 (杭州) , 这里Region填写: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());
        }

    }
}