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

Amazonka.EC2.ModifyFleet

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

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.

Constructors

ModifyFleet'

Fields

context :: Maybe Text
Reserved.
dryRun :: Maybe Bool
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.
excessCapacityTerminationPolicy :: Maybe FleetExcessCapacityTerminationPolicy
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.
launchTemplateConfigs :: Maybe [FleetLaunchTemplateConfigRequest]
The launch template and overrides.
targetCapacitySpecification :: Maybe TargetCapacitySpecificationRequest
The size of the EC2 Fleet.
fleetId :: Text
The ID of the EC2 Fleet.

Instances

Instances details

ToHeaders ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods toHeaders :: ModifyFleet -> [Header] #
ToPath ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods toPath :: ModifyFleet -> ByteString #
ToQuery ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods toQuery :: ModifyFleet -> QueryString #
AWSRequest ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Associated Types type AWSResponse ModifyFleet # Methods request :: (Service -> Service) -> ModifyFleet -> Request ModifyFleet # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy ModifyFleet -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse ModifyFleet))) #
Generic ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Associated Types type Rep ModifyFleet :: Type -> Type # Methods from :: ModifyFleet -> Rep ModifyFleet x # to :: Rep ModifyFleet x -> ModifyFleet #
Read ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods readsPrec :: Int -> ReadS ModifyFleet # readList :: ReadS [ModifyFleet] # readPrec :: ReadPrec ModifyFleet # readListPrec :: ReadPrec [ModifyFleet] #
Show ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods showsPrec :: Int -> ModifyFleet -> ShowS # show :: ModifyFleet -> String # showList :: [ModifyFleet] -> ShowS #
NFData ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods rnf :: ModifyFleet -> () #
Eq ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods (==) :: ModifyFleet -> ModifyFleet -> Bool # (/=) :: ModifyFleet -> ModifyFleet -> Bool #
Hashable ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods hashWithSalt :: Int -> ModifyFleet -> Int # hash :: ModifyFleet -> Int #
type AWSResponse ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet type AWSResponse ModifyFleet = ModifyFleetResponse
type Rep ModifyFleet Source #
Instance details Defined in Amazonka.EC2.ModifyFleet type Rep ModifyFleet = D1 ('MetaData "ModifyFleet" "Amazonka.EC2.ModifyFleet" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ModifyFleet'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "context") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :: S1 ('MetaSel ('Just "excessCapacityTerminationPolicy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe FleetExcessCapacityTerminationPolicy)))) :: (S1 ('MetaSel ('Just "launchTemplateConfigs") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [FleetLaunchTemplateConfigRequest])) :: (S1 ('MetaSel ('Just "targetCapacitySpecification") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe TargetCapacitySpecificationRequest)) :*: S1 ('MetaSel ('Just "fleetId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newModifyFleet Source #

Arguments

:: Text	`ModifyFleet`
-> ModifyFleet

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.

Constructors

ModifyFleetResponse'
Fields return' :: Maybe Bool If the request succeeds, the response returns `true`. If the request fails, no response is returned, and instead an error message is returned. httpStatus :: Int The response's http status code.

Instances

Instances details

Generic ModifyFleetResponse Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Associated Types type Rep ModifyFleetResponse :: Type -> Type # Methods from :: ModifyFleetResponse -> Rep ModifyFleetResponse x # to :: Rep ModifyFleetResponse x -> ModifyFleetResponse #
Read ModifyFleetResponse Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods readsPrec :: Int -> ReadS ModifyFleetResponse # readList :: ReadS [ModifyFleetResponse] # readPrec :: ReadPrec ModifyFleetResponse # readListPrec :: ReadPrec [ModifyFleetResponse] #
Show ModifyFleetResponse Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods showsPrec :: Int -> ModifyFleetResponse -> ShowS # show :: ModifyFleetResponse -> String # showList :: [ModifyFleetResponse] -> ShowS #
NFData ModifyFleetResponse Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods rnf :: ModifyFleetResponse -> () #
Eq ModifyFleetResponse Source #
Instance details Defined in Amazonka.EC2.ModifyFleet Methods (==) :: ModifyFleetResponse -> ModifyFleetResponse -> Bool # (/=) :: ModifyFleetResponse -> ModifyFleetResponse -> Bool #
type Rep ModifyFleetResponse Source #
Instance details Defined in Amazonka.EC2.ModifyFleet type Rep ModifyFleetResponse = D1 ('MetaData "ModifyFleetResponse" "Amazonka.EC2.ModifyFleet" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ModifyFleetResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "return'") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newModifyFleetResponse Source #

Arguments

:: Int	`$sel:httpStatus:ModifyFleetResponse'`
-> ModifyFleetResponse

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.