RAM SDK consists of two parts. The public part of Alibaba Cloud Java SDK depends on aliyun-java-sdk-core, and the RAM part depends on aliyun-java-sdk-ram.

For details about each API interface, see RAM API documentation.

For the automatic generation and online API debugging of SDK Demo codes, see OpenAPI Explorer.


You can use Maven Repo to introduce RAM SDK or manually download RAM SDK.jar and then add it to the project.

Maven Dependencies
Download the JAR package




Creation of a sub-account named “alice” in RAM is used as an example:
package com.aliyun.ram.sample;

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

// The RAM API version is 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) {
        // Construct an Aliyun Client for initiating a request
        // Set AccessKeyID and AccessKeySevcret when constructing the Aliyun Client
        // RAM is a Global Service, and its API ingress is located in the East China 1 (Hangzhou) region. Enter "cn-hangzhou" in "Region"
        IClientProfile profile = DefaultProfile.getProfile("cn-hangzhou",
        DefaultAcsClient client = new DefaultAcsClient(profile);

        // Construct a "CreateUser" request
        final CreateUserRequest request = new CreateUserRequest();

        // Set the parameter - User

        // Initiate a request and obtain the 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());


Release Notes

Version: 2.0.7

The first version of RAM Java SDK was released on November 7, 2015, which contains all APIs of RAM.