Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
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.
Synopsis
- data ModifyFleet = ModifyFleet' {}
- newModifyFleet :: Text -> ModifyFleet
- modifyFleet_context :: Lens' ModifyFleet (Maybe Text)
- modifyFleet_dryRun :: Lens' ModifyFleet (Maybe Bool)
- modifyFleet_excessCapacityTerminationPolicy :: Lens' ModifyFleet (Maybe FleetExcessCapacityTerminationPolicy)
- modifyFleet_launchTemplateConfigs :: Lens' ModifyFleet (Maybe [FleetLaunchTemplateConfigRequest])
- modifyFleet_targetCapacitySpecification :: Lens' ModifyFleet (Maybe TargetCapacitySpecificationRequest)
- modifyFleet_fleetId :: Lens' ModifyFleet Text
- data ModifyFleetResponse = ModifyFleetResponse' {
- return' :: Maybe Bool
- httpStatus :: Int
- newModifyFleetResponse :: Int -> ModifyFleetResponse
- modifyFleetResponse_return :: Lens' ModifyFleetResponse (Maybe Bool)
- modifyFleetResponse_httpStatus :: Lens' ModifyFleetResponse Int
Creating a Request
data ModifyFleet Source #
See: newModifyFleet
smart constructor.
ModifyFleet' | |
|
Instances
Create a value of ModifyFleet
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
ModifyFleet
, modifyFleet_context
- Reserved.
$sel:dryRun:ModifyFleet'
, modifyFleet_dryRun
- 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
.
ModifyFleet
, modifyFleet_excessCapacityTerminationPolicy
- 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.
ModifyFleet
, modifyFleet_launchTemplateConfigs
- The launch template and overrides.
ModifyFleet
, modifyFleet_targetCapacitySpecification
- The size of the EC2 Fleet.
ModifyFleet
, modifyFleet_fleetId
- The ID of the EC2 Fleet.
Request Lenses
modifyFleet_context :: Lens' ModifyFleet (Maybe Text) Source #
Reserved.
modifyFleet_dryRun :: Lens' ModifyFleet (Maybe Bool) Source #
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
.
modifyFleet_excessCapacityTerminationPolicy :: Lens' ModifyFleet (Maybe FleetExcessCapacityTerminationPolicy) Source #
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.
modifyFleet_launchTemplateConfigs :: Lens' ModifyFleet (Maybe [FleetLaunchTemplateConfigRequest]) Source #
The launch template and overrides.
modifyFleet_targetCapacitySpecification :: Lens' ModifyFleet (Maybe TargetCapacitySpecificationRequest) Source #
The size of the EC2 Fleet.
modifyFleet_fleetId :: Lens' ModifyFleet Text Source #
The ID of the EC2 Fleet.
Destructuring the Response
data ModifyFleetResponse Source #
See: newModifyFleetResponse
smart constructor.
ModifyFleetResponse' | |
|
Instances
newModifyFleetResponse Source #
Create a value of ModifyFleetResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
$sel:return':ModifyFleetResponse'
, modifyFleetResponse_return
- If the request succeeds, the response returns true
. If the request
fails, no response is returned, and instead an error message is
returned.
$sel:httpStatus:ModifyFleetResponse'
, modifyFleetResponse_httpStatus
- The response's http status code.
Response Lenses
modifyFleetResponse_return :: Lens' ModifyFleetResponse (Maybe Bool) Source #
If the request succeeds, the response returns true
. If the request
fails, no response is returned, and instead an error message is
returned.
modifyFleetResponse_httpStatus :: Lens' ModifyFleetResponse Int Source #
The response's http status code.