Input to an AddInstanceGroups call.

]]> Instance Groups to add.

]]> Job flow in which to add the instance groups.

]]> Output from an AddInstanceGroups call.

]]> The job flow ID in which the instance groups are added.

]]> Instance group IDs of the newly created instance groups.

]]> The input argument to the AddJobFlow operation.

]]> A string that uniquely identifies the job flow. This identifier is returned by RunJobFlow and can also be obtained from DescribeJobFlows.

]]> A list of StepConfig to be executed by the job flow.

]]> Input to the TerminateJobFlows operation.

]]> A list of job flows to be shutdown.

]]> The input for the DescribeJobFlows operation.

]]> Return only job flows created after this date and time.

]]> Return only job flows created before this date and time.

]]> Return only job flows whose job flow ID is contained in this list.

]]> Return only job flows whose state is contained in this list.

]]> The output for the DescribeJobFlows operation.

]]> A list of job flows matching the parameters supplied.

]]> The input argument to the TerminationProtection operation.

]]> A list of strings that uniquely identify the job flows to protect. This identifier is returned by RunJobFlow and can also be obtained from DescribeJobFlows .

]]> A Boolean that indicates whether to protect the job flow and prevent the Amazon EC2 instances in the cluster from shutting down due to API calls, user intervention, or job-flow error.

]]> Input to the RunJobFlow operation.

]]> The name of the job flow.

]]> Specifies the location in Amazon S3 to write the log files of the job flow. If a value is not provided, logs are not created.

]]> A JSON string for selecting additional features.

]]> A specification of the number and type of Amazon EC2 instances on which to run the job flow.

]]> A list of steps to be executed by the job flow.

]]> A list of bootstrap actions that will be run before Hadoop is started on the cluster nodes.

]]> The result of the RunJobFlow operation.

]]> An unique identifier for the job flow.

]]> Change the size of some instance groups.

]]> Instance groups to change.

]]> Describes the status of the job flow.

]]> The state of the job flow.

]]> The creation date and time of the job flow.

]]> The start date and time of the job flow.

]]> The date and time when the job flow was ready to start running bootstrap actions.

]]> The completion date and time of the job flow.

]]> Description of the job flow last changed state.

]]> Specification of a job flow step.

]]> The name of the job flow step.

]]> Specifies the action to take if the job flow step fails.

]]> Specifies the JAR file used for the job flow step.

]]> Specifies the execution state of a step.

]]> The state of the job flow step.

]]> The creation date and time of the step.

]]> The start date and time of the step.

]]> The completion date and time of the step.

]]> A description of the step's current state.

]]> The type of instance.

A small instance

A large instance

]]> Specifies the Amazon EC2 location for the job flow.

]]> The Amazon EC2 Availability Zone for the job flow.

]]> A description of the Amazon EC2 instance running the job flow.

]]> The EC2 instance type of the master node.

]]> The EC2 instance type of the slave nodes.

]]> The number of Amazon EC2 instances used to execute the job flow.

]]> Configuration for the job flow's instance groups.

]]> Specifies the name of the Amazon EC2 key pair that can be used to ssh to the master node as the user called "hadoop."

]]> Specifies the Availability Zone the job flow will run in.

]]> Specifies whether the job flow should terminate after completing all steps.

]]> Specifies whether to lock the job flow to prevent the Amazon EC2 instances from being terminated by API call, user intervention, or in the event of a job flow error.

]]> Specifies the Hadoop version for the job flow. Valid inputs are "0.18" or "0.20".

]]> Modify an instance group size.

]]> Unique ID of the instance group to expand or shrink.

]]> Target size for the instance group.

]]> A key value pair.

]]> The unique identifier of a key value pair.

]]> The value part of the identified key.

]]> Configuration of the script to run during a bootstrap action.

]]> Location of the script to run during a bootstrap action. Can be either a location in Amazon S3 or on a local file system.

]]> A list of command line arguments to pass to the bootstrap action script.

]]> Configuration of a bootstrap action.

]]> The name of the bootstrap action.

]]> The script run by the bootstrap action.

]]> Detailed information about an instance group.

]]> Unique identifier for the instance group.

]]> Friendly name for the instance group.

]]> Instance group role in the cluster

]]> Amazon EC2 Instance type.

]]> Target number of instances to run in the instance group.

]]> Actual count of running instances.

]]> State of instance group.

]]> Details regarding the state of the instance group.

]]> The date/time the instance group was created.

]]> The date/time the instance group was started.

]]> The date/time the instance group was available to the cluster.

]]> The date/time the instance group was terminated.

]]> Reports the configuration of a bootstrap action in a job flow.

]]> A description of the bootstrap action.

]]> Configuration defining a new instance group.

]]> Friendly name given to the instance group.

]]> The role of the instance group in the cluster.

]]> The Amazon EC2 instance type for all instances in the instance group.

]]> Target number of instances for the instance group.

]]> A description of a job flow.

]]> The job flow identifier.

]]> The name of the job flow.

]]> The location in Amazon S3 where log files for the job are stored.

]]> Describes the execution status of the job flow.

]]> Describes the Amazon EC2 instances of the job flow.

]]> A list of steps run by the job flow.

]]> A list of the bootstrap actions run by the job flow.

]]> Combines the execution state and configuration of a step.

]]> The step configuration.

]]> The description of the step status.

]]> A job flow step consisting of a JAR file whose main function will be executed. The main function submits a job for Hadoop to execute and waits for the job to finish or fail.

]]> A list of Java properties that are set when the step runs. You can use these properties to pass key value pairs to your main function.

]]> A path to a JAR file run during the step.

]]> The name of the main class in the specified Java file. If not specified, the JAR file should specify a Main-Class in its manifest file.

]]> A list of command line arguments passed to the JAR file's main function when executed.

]]> Specify the type of Amazon EC2 instances to run the job flow on.

]]> The Amazon EC2 master node instance type.

]]> The DNS name of the master node.

]]> The Amazon EC2 instance identifier of the master node.

]]> The Amazon EC2 slave node instance type.

]]> The number of Amazon EC2 instances in the cluster. If the value is 1, the same instance serves as both the master and slave node. If the value is greater than 1, one instance is the master node and all others are slave nodes.

]]> Details about the job flow's instance groups.

]]> An approximation of the cost of the job flow, represented in m1.small/hours. This value is incremented once for every hour an m1.small runs. Larger instances are weighted more, so an Amazon EC2 instance that is roughly four times more expensive would result in the normalized instance hours being incremented by four. This result is only an approximation and does not reflect the actual billing rate.

]]> The name of an Amazon EC2 key pair that can be used to ssh to the master node of job flow.

]]> Specifies the Amazon EC2 Availability Zone for the job flow.

]]> Specifies whether or not the job flow should terminate after completing all steps.

]]> Specifies whether the Amazon EC2 instances in the cluster are protected from termination by API calls, user intervention, or in the event of a job flow error.

]]> Specifies the Hadoop version for the job flow.

]]> AddInstanceGroups adds an instance group to a running cluster.

https://elasticmapreduce.amazonaws.com?Operation=AddInstanceGroups &JobFlowId=j-3UN6WX5RRO2AG &InstanceGroups.member.1.Name="Task Instance Group" &InstanceGroups.member.1.InstanceRole=TASK &InstanceGroups.member.1.Market=On_DEMAND &InstanceGroups.member.1.InstanceType=m1.small &InstanceGroups.member.1.InstanceRequestCount=2 &AuthParams i-3UN6WX5RRO2AG ]]> AddJobFlowSteps adds new steps to a running job flow. A maximum of 256 steps are allowed in each job flow.

A step specifies the location of a JAR file stored either on the master node of the job flow or in Amazon S3. Each step is performed by the main function of the main class of the JAR file. The main class can be specified either in the manifest of the JAR or by using the MainFunction parameter of the step.

Elastic MapReduce executes each step in the order listed. For a step to be considered complete, the main function must exit with a zero exit code and all Hadoop jobs started while the step was running must have completed and run successfully.

You can only add steps to a job flow that is in one of the following states: STARTING, BOOTSTAPPING, RUNNING, or WAITING.

https://elasticmapreduce.amazonaws.com?Operation=AddJobFlowSteps &JobFlowId=j-3UN6WX5RRO2AG &Steps.member.1.Name=MyStep2 &Steps.member.1.ActionOnFailure=CONTINUE &Steps.member.1.HadoopJarStep.Jar=MyJar &Steps.member.1.HadoopJarStep.MainClass=MainClass &Steps.member.1.HadoopJarStep.Args.member.1=arg1 &AuthParams df6f4f4a-ed85-11dd-9877-6fad448a8419 ]]> TerminateJobFlows shuts a list of job flows down. When a job flow is shut down, any step not yet completed is canceled and the EC2 instances on which the job flow is running are stopped. Any log files not already saved are uploaded to Amazon S3 if a LogUri was specified when the job flow was created.

https://elasticmapreduce.amazonaws.com?Operation=TerminateJobFlows &JobFlowIds.member.1=j-3UN6WX5RRO2AG &AuthParams 2690d7eb-ed86-11dd-9877-6fad448a8419 ]]> DescribeJobFlows returns a list of job flows that match all of the supplied parameters. The parameters can include a list of job flow IDs, job flow states, and restrictions on job flow creation date and time.

Regardless of supplied parameters, only job flows created within the last two months are returned.

If no parameters are supplied, then job flows matching either of the following criteria are returned:

Job flows created and completed in the last two weeks
Job flows created within the last two months that are in one of the following states: RUNNING, WAITING, SHUTTING_DOWN, STARTING

Amazon Elastic MapReduce can return a maximum of 512 job flow descriptions.

https://elasticmapreduce.amazonaws.com?Operation=DescribeJobFlows &JobFlowIds.member.1=j-3UN6WX5RRO2AG &AuthParams 2009-01-28T21:49:16Z 2009-01-28T21:49:16Z STARTING MyJobFlowName mybucket/subdir/ 2009-01-28T21:49:16Z PENDING MyJarFile MyMainClass arg1 arg2 MyStepName CONTINUE j-3UN6WX5RRO2AG us-east-1a m1.small m1.small myec2keyname 4 true true 9cea3229-ed85-11dd-9877-6fad448a8419 ]]> SetTerminationProtection locks a job flow so the Amazon EC2 instances in the cluster cannot be terminated by user intervention, an API call, or in the event of a job-flow error. The cluster still terminates upon successful completion of the job flow. Calling SetTerminationProtection on a job flow is analogous to calling the Amazon EC2 DisableAPITermination API on all of the EC2 instances in a cluster.

SetTerminationProtection is used to prevent accidental termination of a job flow and to ensure that in the event of an error, the instances will persist so you can recover any data stored in their ephemeral instance storage.

To terminate a job flow that has been locked by setting SetTerminationProtection to true, you must first unlock the job flow by a subsequent call to SetTerminationProtection in which you set the value to false.

For more information, go to Protecting a Job Flow from Termination in the Amazon Elastic MapReduce Developer's Guide.

https://elasticmapreduce.amazonaws.com?Operation=SetTerminationProtection &JobFlowIds.member.1=j-3UN6WX5RRO2AG &TerminationProtected=true &AuthParams df6f4f4a-ed85-11dd-9877-6fad448a8419 ]]> RunJobFlow creates and starts running a new job flow. The job flow will run the steps specified. Once the job flow completes, the cluster is stopped and the HDFS partition is lost. To prevent loss of data, configure the last step of the job flow to store results in Amazon S3. If the JobFlowInstancesDetail KeepJobFlowAliveWhenNoSteps parameter is set to TRUE, the job flow will transition to the WAITING state rather than shutting down once the steps have completed.

For additional protection, you can set the JobFlowInstancesDetail TerminationProtected parameter to TRUE to lock the job flow and prevent it from being terminated by API call, user intervention, or in the event of a job flow error.

A maximum of 256 steps are allowed in each job flow.

For long running job flows, we recommended that you periodically store your results.

https://elasticmapreduce.amazonaws.com?Operation=RunJobFlow &Name=MyJobFlowName &LogUri=s3n%3A%2F%2Fmybucket%2Fsubdir &Instances.MasterInstanceType=m1.small &Instances.SlaveInstanceType=m1.small &Instances.InstanceCount=4 &Instances.Ec2KeyName=myec2keyname &Instances.Placement.AvailabilityZone=us-east-1a &Instances.KeepJobFlowAliveWhenNoSteps=true &Instances.TerminationProtected=true &Steps.member.1.Name=MyStepName &Steps.member.1.ActionOnFailure=CONTINUE &Steps.member.1.HadoopJarStep.Jar=MyJarFile &Steps.member.1.HadoopJarStep.MainClass=MyMainClass &Steps.member.1.HadoopJarStep.Args.member.1=arg1 &Steps.member.1.HadoopJarStep.Args.member.2=arg2 &AuthParams j-3UN6WX5RRO2AG 8296d8b8-ed85-11dd-9877-6fad448a8419 ]]> ModifyInstanceGroups modifies the number of nodes and configuration settings of an instance group. The input parameters include the new target instance count for the group and the instance group ID. The call will either succeed or fail atomically.

https://elasticmapreduce.amazonaws.com?Operation=ModifyInstanceGroups &InstanceGroups.member.1.InstanceGroupId=i-3UN6WX5RRO2AG &InstanceGroups.member.1.InstanceRequestCount=2 &AuthParams 2690d7eb-ed86-11dd-9877-6fad448a8419 ]]> This is the Amazon Elastic MapReduce API Reference. This guide provides descriptions and samples of the Amazon Elastic MapReduce APIs.

Amazon Elastic MapReduce is a web service that makes it easy to process large amounts of data efficiently. Elastic MapReduce uses Hadoop processing combined with several AWS products to do tasks such as web indexing, data mining, log file analysis, machine learning, scientific simulation, and data warehousing.

For more information about this product go to the Amazon Elastic MapReduce detail page. For specific information about setting up signatures and authorization through the API, go to Amazon Elastic MapReduce Developer Guide.

]]>