Container for the parameters to the RunJobFlow operation.

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 JobFlowInstancesConfig 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 JobFlowInstancesConfig 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.

If your job flow is long-running (such as a Hive data warehouse) or complex, you may require more than 256 steps to process your data. You can bypass the 256-step limitation in various ways, including using the SSH shell to connect to the master node and submitting queries directly to the software running on the master node, such as Hive and Hadoop. For more information on how to do this, go to Add More than 256 Steps to a Job Flow in the Amazon Elastic MapReduce Developer's Guide .

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

Namespace: Amazon.ElasticMapReduce.Model
Assembly: AWSSDK (in AWSSDK.dll) Version: 1.4.10.0 (1.4.10.0)

Syntax

         
 C#  Visual Basic  Visual C++ 
public class RunJobFlowRequest : AmazonWebServiceRequest
Public Class RunJobFlowRequest _
	Inherits AmazonWebServiceRequest
public ref class RunJobFlowRequest : public AmazonWebServiceRequest

Members

            
 All Members  Constructors   Properties   Methods  
 Public

 Protected
 Instance

 Static 
 Declared

 Inherited
 XNA Framework Only 

 .NET Compact Framework Only 

 MemberDescription
RunJobFlowRequest()()()()
Initializes a new instance of the RunJobFlowRequest class
AdditionalInfo
A JSON string for selecting additional features.

Constraints:

Length
0 - 10280
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

AmiVersion
The version of the Amazon Machine Image (AMI) to use when launching Amazon EC2 instances in the job flow. The following values ane valid:
  • "latest" (latest AMI version; currently AMI 2.0, Hadoop 0.20.205)
  • "2.0" (AMI 2.0, Hadoop 0.20.205)
  • "1.0" (AMI 1.0, Hadoop 0.18)
If this value is not specified, the job flow uses the default of (AMI 1.0, Hadoop 0.18). If the AMI supports multiple versions of Hadoop (for example, AMI 1.0 supports both Hadoop 0.18 and 0.20) you can use the JobFlowInstancesConfigHadoopVersion parameter to modify the version of Hadoop from the defaults shown above. For details about the AMI versions currently supported by Amazon ElasticMapReduce, go to AMI Versions Supported in Elastic MapReduce in the Amazon Elastic MapReduce Developer's Guide.

Constraints:

Length
0 - 256
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

BootstrapActions
A list of bootstrap actions that will be run before Hadoop is started on the cluster nodes.
Equals(Object)
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
GetHashCode()()()()
Serves as a hash function for a particular type.
(Inherited from Object.)
GetType()()()()
Gets the Type of the current instance.
(Inherited from Object.)
Instances
A specification of the number and type of Amazon EC2 instances on which to run the job flow.
LogUri
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.

Constraints:

Length
0 - 10280
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Name
The name of the job flow.

Constraints:

Length
0 - 256
Pattern
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*

Steps
A list of steps to be executed by the job flow.
SupportedProducts
A list of strings used by third-party software to tag the job flow. Currently the only valid value is "karmasphere-enterprise-utility", which tags the job flow for management by Karmasphere.
ToString()()()()
Returns a String that represents the current Object.
(Inherited from Object.)
WithAdditionalInfo(String)
Sets the AdditionalInfo property
WithAmiVersion(String)
Sets the AmiVersion property
WithBootstrapActions(array<BootstrapActionConfig>[]()[][])
Adds elements to the BootstrapActions collection
WithBootstrapActions(IEnumerable<(Of <<'(BootstrapActionConfig>)>>))
Adds elements to the BootstrapActions collection
WithInstances(JobFlowInstancesConfig)
Sets the Instances property
WithLogUri(String)
Sets the LogUri property
WithName(String)
Sets the Name property
WithSteps(array<StepConfig>[]()[][])
Adds elements to the Steps collection
WithSteps(IEnumerable<(Of <<'(StepConfig>)>>))
Adds elements to the Steps collection
WithSupportedProducts(IEnumerable<(Of <<'(String>)>>))
Adds elements to the SupportedProducts collection
WithSupportedProducts(array<String>[]()[][])
Adds elements to the SupportedProducts collection

Inheritance Hierarchy

System..::..Object
  Amazon.Runtime..::..AmazonWebServiceRequest
    Amazon.ElasticMapReduce.Model..::..RunJobFlowRequest

See Also