Amazon Elastic MapReduce
API Reference (API Version 2009-03-31)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

AddInstanceGroups

Description

AddInstanceGroups adds an instance group to a running cluster.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.

Name Description Required
InstanceGroups.member.N

Instance Groups to add.

Type: InstanceGroupConfig list

Yes
JobFlowId

Job flow in which to add the instance groups.

Type: String

Length constraints: Minimum length of 0. Maximum length of 256.

Yes

Response Elements

The following elements come wrapped in a AddInstanceGroupsResult structure.
NameDescription
InstanceGroupIds

Instance group IDs of the newly created instance groups.

Type: String list

JobFlowId

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

Type: String

Errors

For information about the common errors that all actions use, see Common Errors.

Error Description HTTP Status Code
InternalServerError

Indicates that an error occurred while processing the request and that the request was not completed.

500

Examples

Sample Request

https://elasticmapreduce.amazonaws.com?Action=AddInstanceGroups
&JobFlowId=j-3UN6WX5RRO2AG 
&InstanceGroups.member.1.Name="Task Instance Group" 
&InstanceGroups.member.1.InstanceRole=TASK
&InstanceGroups.member.1.InstanceType=m1.small 
&InstanceGroups.member.1.InstanceRequestCount=2 
&AuthParams

Sample Response

<AddInstanceGroupsResponse xmlns="http://elasticmapreduce.amazonaws.com/doc/2009-03-31">
   <InstanceGroupIds> 
      <InstanceGroup> 
         <InstanceGroupId> 
            i-3UN6WX5RRO2AG
         </InstanceGroupId> 
      </InstanceGroup> 
   </InstanceGroupIds>
</AddInstanceGroupsResponse>