Request Syntax Request Parameters Response Elements Errors See Also

ModifyInstanceFleet

Modifies the target On-Demand and target Spot capacities for the instance fleet with the specified InstanceFleetID within the cluster specified using ClusterID. The call either succeeds or fails atomically.

Note

The instance fleet configuration is available only in Amazon EMR releases 4.8.0 and later, excluding 5.0.x versions.

Request Syntax


{
   "ClusterId": "string",
   "InstanceFleet": { 
      "Context": "string",
      "InstanceFleetId": "string",
      "InstanceTypeConfigs": [ 
         { 
            "BidPrice": "string",
            "BidPriceAsPercentageOfOnDemandPrice": number,
            "Configurations": [ 
               { 
                  "Classification": "string",
                  "Configurations": [ 
                     "Configuration"
                  ],
                  "Properties": { 
                     "string" : "string" 
                  }
               }
            ],
            "CustomAmiId": "string",
            "EbsConfiguration": { 
               "EbsBlockDeviceConfigs": [ 
                  { 
                     "VolumeSpecification": { 
                        "Iops": number,
                        "SizeInGB": number,
                        "Throughput": number,
                        "VolumeType": "string"
                     },
                     "VolumesPerInstance": number
                  }
               ],
               "EbsOptimized": boolean
            },
            "InstanceType": "string",
            "Priority": number,
            "WeightedCapacity": number
         }
      ],
      "ResizeSpecifications": { 
         "OnDemandResizeSpecification": { 
            "AllocationStrategy": "string",
            "CapacityReservationOptions": { 
               "CapacityReservationPreference": "string",
               "CapacityReservationResourceGroupArn": "string",
               "UsageStrategy": "string"
            },
            "TimeoutDurationMinutes": number
         },
         "SpotResizeSpecification": { 
            "AllocationStrategy": "string",
            "TimeoutDurationMinutes": number
         }
      },
      "TargetOnDemandCapacity": number,
      "TargetSpotCapacity": number
   }
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

ClusterId

The unique identifier of the cluster.

Type: String

Required: Yes

InstanceFleet

The configuration parameters of the instance fleet.

Type: InstanceFleetModifyConfig object

Required: Yes

Response Elements

If the action is successful, the service sends back an HTTP 200 response with an empty HTTP body.

Errors

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

InternalServerException

This exception occurs when there is an internal failure in the Amazon EMR service.

HTTP Status Code: 500

InvalidRequestException

This exception occurs when there is something wrong with user input.

HTTP Status Code: 400