amazonka-ec2-2.0: Amazon Elastic Compute Cloud SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.EC2.ModifySpotFleetRequest

Description

Modifies the specified Spot Fleet request.

You can only modify a Spot Fleet request of type maintain.

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

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

To scale down your Spot Fleet, decrease its target capacity. First, the Spot Fleet cancels any open requests that exceed the new target capacity. You can request that the Spot Fleet terminate Spot Instances until the size of the fleet no longer exceeds the new target capacity. If the allocation strategy is lowestPrice, the Spot Fleet terminates the instances with the highest price per unit. If the allocation strategy is capacityOptimized, the Spot Fleet terminates the instances in the Spot Instance pools that have the least available Spot Instance capacity. If the allocation strategy is diversified, the Spot Fleet terminates instances across the Spot Instance pools. Alternatively, you can request that the Spot 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 Spot Fleet for now, but will use it again later, you can set the target capacity to 0.

Synopsis

Creating a Request

data ModifySpotFleetRequest Source #

Contains the parameters for ModifySpotFleetRequest.

See: newModifySpotFleetRequest smart constructor.

Constructors

ModifySpotFleetRequest' 

Fields

Instances

Instances details
ToHeaders ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

ToPath ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

ToQuery ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

AWSRequest ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

Associated Types

type AWSResponse ModifySpotFleetRequest #

Generic ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

Associated Types

type Rep ModifySpotFleetRequest :: Type -> Type #

Read ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

Show ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

NFData ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

Methods

rnf :: ModifySpotFleetRequest -> () #

Eq ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

Hashable ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

type AWSResponse ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

type Rep ModifySpotFleetRequest Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

type Rep ModifySpotFleetRequest = D1 ('MetaData "ModifySpotFleetRequest" "Amazonka.EC2.ModifySpotFleetRequest" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ModifySpotFleetRequest'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "context") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: (S1 ('MetaSel ('Just "excessCapacityTerminationPolicy") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ExcessCapacityTerminationPolicy)) :*: S1 ('MetaSel ('Just "launchTemplateConfigs") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [LaunchTemplateConfig])))) :*: (S1 ('MetaSel ('Just "onDemandTargetCapacity") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: (S1 ('MetaSel ('Just "targetCapacity") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: S1 ('MetaSel ('Just "spotFleetRequestId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newModifySpotFleetRequest Source #

Create a value of ModifySpotFleetRequest 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:

ModifySpotFleetRequest, modifySpotFleetRequest_context - Reserved.

ModifySpotFleetRequest, modifySpotFleetRequest_excessCapacityTerminationPolicy - Indicates whether running Spot Instances should be terminated if the target capacity of the Spot Fleet request is decreased below the current size of the Spot Fleet.

ModifySpotFleetRequest, modifySpotFleetRequest_launchTemplateConfigs - The launch template and overrides. You can only use this parameter if you specified a launch template (LaunchTemplateConfigs) in your Spot Fleet request. If you specified LaunchSpecifications in your Spot Fleet request, then omit this parameter.

ModifySpotFleetRequest, modifySpotFleetRequest_onDemandTargetCapacity - The number of On-Demand Instances in the fleet.

ModifySpotFleetRequest, modifySpotFleetRequest_targetCapacity - The size of the fleet.

ModifySpotFleetRequest, modifySpotFleetRequest_spotFleetRequestId - The ID of the Spot Fleet request.

Request Lenses

modifySpotFleetRequest_excessCapacityTerminationPolicy :: Lens' ModifySpotFleetRequest (Maybe ExcessCapacityTerminationPolicy) Source #

Indicates whether running Spot Instances should be terminated if the target capacity of the Spot Fleet request is decreased below the current size of the Spot Fleet.

modifySpotFleetRequest_launchTemplateConfigs :: Lens' ModifySpotFleetRequest (Maybe [LaunchTemplateConfig]) Source #

The launch template and overrides. You can only use this parameter if you specified a launch template (LaunchTemplateConfigs) in your Spot Fleet request. If you specified LaunchSpecifications in your Spot Fleet request, then omit this parameter.

modifySpotFleetRequest_onDemandTargetCapacity :: Lens' ModifySpotFleetRequest (Maybe Int) Source #

The number of On-Demand Instances in the fleet.

Destructuring the Response

data ModifySpotFleetRequestResponse Source #

Contains the output of ModifySpotFleetRequest.

See: newModifySpotFleetRequestResponse smart constructor.

Constructors

ModifySpotFleetRequestResponse' 

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 ModifySpotFleetRequestResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

Associated Types

type Rep ModifySpotFleetRequestResponse :: Type -> Type #

Read ModifySpotFleetRequestResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

Show ModifySpotFleetRequestResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

NFData ModifySpotFleetRequestResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

Eq ModifySpotFleetRequestResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

type Rep ModifySpotFleetRequestResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifySpotFleetRequest

type Rep ModifySpotFleetRequestResponse = D1 ('MetaData "ModifySpotFleetRequestResponse" "Amazonka.EC2.ModifySpotFleetRequest" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ModifySpotFleetRequestResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "return'") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newModifySpotFleetRequestResponse Source #

Create a value of ModifySpotFleetRequestResponse 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':ModifySpotFleetRequestResponse', modifySpotFleetRequestResponse_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:ModifySpotFleetRequestResponse', modifySpotFleetRequestResponse_httpStatus - The response's http status code.

Response Lenses

modifySpotFleetRequestResponse_return :: Lens' ModifySpotFleetRequestResponse (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.