Java Library for Amazon Elastic MapReduce

About this Library

• Based on the 2009-03-31 API version.

What's New?

• 2009-04-21:
  • Initial release

Prerequisites

• Amazon Elastic MapReduce account (http://aws.amazon.com/elasticmapreduce).
• Java 1.5 (http://java.sun.com/)
to compile sources.

Reference Documentation

• Online Java Docs

Package Content

Quick Start

1. Extract the amazon-elasticmapreduce-2009-03-31-java-library.zip file into a working directory.
2. Add all sources under "src" directory to your compilation path.
3. Add all jars files under "third-party/*" directory to your classpath. NOTE: if you are using JDK 1.6, do not add jaxb jars
4. Edit desired sample. For example: DescribeJobFlowsSample.java



• Set AWS Access Key ID and AWS Secret Access Key

String accessKeyId = "Your Access Key ID";
String secretAccessKey = "Your Secret Access Key";
                




• Set request parameters. For example, find following pre-generated snippet:

DescribeJobFlowsRequest request = new DescribeJobFlowsRequest();
// @TODO: set request parameters here
// invokeDescribeJobFlows(service, request);
                




• And uncomment third line:

DescribeJobFlowsRequest request = new DescribeJobFlowsRequest();
invokeDescribeJobFlows(service, request);
                



5. Compile and run DescribeJobFlows. You should see the output similar to the following:




    DescribeJobFlowsResponse
        ResponseMetadata
            RequestId
                95cdcb68-f46c-400b-8265-8c2de2a5c475
            



Note, you may also see additional debugging output. To adjust level of debugging, modify log4j.properties available in the root of the source tree.


6. Experiment with samples. When ready, add library binary distribution to your application classpath, and use it.

Making Requests to a Different Region

To make the service call to a different region, instantiate the client with the configuration object, and pass the region-specific endpoint. For example:

AmazonElasticMapReduce service = new AmazonElasticMapReduceClient
        (accessKeyId, secretAccessKey, 
            new AmazonElasticMapReduceConfig()
            .withServiceURL("https://eu-west-1.elasticmapreduce.amazonaws.com"));
                

See the Amazon Elastic MapReduce Developer Guide for a complete list of region endpoints.

Comments, Questions or Feedback