Skip to content

/AWS1/CL_EC2=>MODIFYFLEET()

About ModifyFleet

Modifies the specified EC2 Fleet.

You can only modify an EC2 Fleet request of type maintain.

While the EC2 Fleet is being modified, it is in the modifying state.

To scale up your EC2 Fleet, increase its target capacity. The EC2 Fleet launches the additional Spot Instances according to the allocation strategy for the EC2 Fleet request. If the allocation strategy is lowest-price, the EC2 Fleet launches instances using the Spot Instance pool with the lowest price. If the allocation strategy is diversified, the EC2 Fleet distributes the instances across the Spot Instance pools. If the allocation strategy is capacity-optimized, EC2 Fleet launches instances from Spot Instance pools with optimal capacity for the number of instances that are launching.

To scale down your EC2 Fleet, decrease its target capacity. First, the EC2 Fleet cancels any open requests that exceed the new target capacity. You can request that the EC2 Fleet terminate Spot Instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowest-price, the EC2 Fleet terminates the instances with the highest price per unit. If the allocation strategy is capacity-optimized, the EC2 Fleet terminates the instances in the Spot Instance pools that have the least available Spot Instance capacity. If the allocation strategy is diversified, the EC2 Fleet terminates instances across the Spot Instance pools. Alternatively, you can request that the EC2 Fleet keep the fleet at its current size, but not replace any Spot Instances that are interrupted or that you terminate manually.

If you are finished with your EC2 Fleet for now, but will use it again later, you can set the target capacity to 0.

Method Signature

IMPORTING

Required arguments:

IV_FLEETID TYPE /AWS1/EC2FLEETID /AWS1/EC2FLEETID

The ID of the EC2 Fleet.

Optional arguments:

IV_DRYRUN TYPE /AWS1/EC2BOOLEAN /AWS1/EC2BOOLEAN

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

IV_EXCESSCAPTERMINATIONPLY TYPE /AWS1/EC2FLEETEXCESSCAPTERMI00 /AWS1/EC2FLEETEXCESSCAPTERMI00

Indicates whether running instances should be terminated if the total target capacity of the EC2 Fleet is decreased below the current size of the EC2 Fleet.

Supported only for fleets of type maintain.

IT_LAUNCHTEMPLATECONFIGS TYPE /AWS1/CL_EC2FLEETLAUNCHTMPLC00=>TT_FLEETLAUNCHTMPLCFGLISTREQ TT_FLEETLAUNCHTMPLCFGLISTREQ

The launch template and overrides.

IO_TARGETCAPACITYSPEC TYPE REF TO /AWS1/CL_EC2TARGETCAPSPECREQ /AWS1/CL_EC2TARGETCAPSPECREQ

The size of the EC2 Fleet.

IV_CONTEXT TYPE /AWS1/EC2STRING /AWS1/EC2STRING

Reserved.

RETURNING

OO_OUTPUT TYPE REF TO /AWS1/CL_EC2MODIFYFLEETRESULT /AWS1/CL_EC2MODIFYFLEETRESULT