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.ModifyCapacityReservationFleet

Description

Modifies a Capacity Reservation Fleet.

When you modify the total target capacity of a Capacity Reservation Fleet, the Fleet automatically creates new Capacity Reservations, or modifies or cancels existing Capacity Reservations in the Fleet to meet the new total target capacity. When you modify the end date for the Fleet, the end dates for all of the individual Capacity Reservations in the Fleet are updated accordingly.

Synopsis

Creating a Request

data ModifyCapacityReservationFleet Source #

See: newModifyCapacityReservationFleet smart constructor.

Constructors

ModifyCapacityReservationFleet' 

Fields

  • 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.

  • endDate :: Maybe ISO8601

    The date and time at which the Capacity Reservation Fleet expires. When the Capacity Reservation Fleet expires, its state changes to expired and all of the Capacity Reservations in the Fleet expire.

    The Capacity Reservation Fleet expires within an hour after the specified time. For example, if you specify 5/31/2019, 13:30:55, the Capacity Reservation Fleet is guaranteed to expire between 13:30:55 and 14:30:55 on 5/31/2019.

    You can't specify EndDate and RemoveEndDate in the same request.

  • removeEndDate :: Maybe Bool

    Indicates whether to remove the end date from the Capacity Reservation Fleet. If you remove the end date, the Capacity Reservation Fleet does not expire and it remains active until you explicitly cancel it using the CancelCapacityReservationFleet action.

    You can't specify RemoveEndDate and EndDate in the same request.

  • totalTargetCapacity :: Maybe Int

    The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see Total target capacity in the Amazon EC2 User Guide.

  • capacityReservationFleetId :: Text

    The ID of the Capacity Reservation Fleet to modify.

Instances

Instances details
ToHeaders ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

ToPath ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

ToQuery ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

AWSRequest ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

Generic ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

Associated Types

type Rep ModifyCapacityReservationFleet :: Type -> Type #

Read ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

Show ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

NFData ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

Eq ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

Hashable ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

type AWSResponse ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

type Rep ModifyCapacityReservationFleet Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

type Rep ModifyCapacityReservationFleet = D1 ('MetaData "ModifyCapacityReservationFleet" "Amazonka.EC2.ModifyCapacityReservationFleet" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "ModifyCapacityReservationFleet'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "dryRun") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: S1 ('MetaSel ('Just "endDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601))) :*: (S1 ('MetaSel ('Just "removeEndDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Bool)) :*: (S1 ('MetaSel ('Just "totalTargetCapacity") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :*: S1 ('MetaSel ('Just "capacityReservationFleetId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newModifyCapacityReservationFleet Source #

Create a value of ModifyCapacityReservationFleet 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:dryRun:ModifyCapacityReservationFleet', modifyCapacityReservationFleet_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.

ModifyCapacityReservationFleet, modifyCapacityReservationFleet_endDate - The date and time at which the Capacity Reservation Fleet expires. When the Capacity Reservation Fleet expires, its state changes to expired and all of the Capacity Reservations in the Fleet expire.

The Capacity Reservation Fleet expires within an hour after the specified time. For example, if you specify 5/31/2019, 13:30:55, the Capacity Reservation Fleet is guaranteed to expire between 13:30:55 and 14:30:55 on 5/31/2019.

You can't specify EndDate and RemoveEndDate in the same request.

$sel:removeEndDate:ModifyCapacityReservationFleet', modifyCapacityReservationFleet_removeEndDate - Indicates whether to remove the end date from the Capacity Reservation Fleet. If you remove the end date, the Capacity Reservation Fleet does not expire and it remains active until you explicitly cancel it using the CancelCapacityReservationFleet action.

You can't specify RemoveEndDate and EndDate in the same request.

ModifyCapacityReservationFleet, modifyCapacityReservationFleet_totalTargetCapacity - The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see Total target capacity in the Amazon EC2 User Guide.

ModifyCapacityReservationFleet, modifyCapacityReservationFleet_capacityReservationFleetId - The ID of the Capacity Reservation Fleet to modify.

Request Lenses

modifyCapacityReservationFleet_dryRun :: Lens' ModifyCapacityReservationFleet (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.

modifyCapacityReservationFleet_endDate :: Lens' ModifyCapacityReservationFleet (Maybe UTCTime) Source #

The date and time at which the Capacity Reservation Fleet expires. When the Capacity Reservation Fleet expires, its state changes to expired and all of the Capacity Reservations in the Fleet expire.

The Capacity Reservation Fleet expires within an hour after the specified time. For example, if you specify 5/31/2019, 13:30:55, the Capacity Reservation Fleet is guaranteed to expire between 13:30:55 and 14:30:55 on 5/31/2019.

You can't specify EndDate and RemoveEndDate in the same request.

modifyCapacityReservationFleet_removeEndDate :: Lens' ModifyCapacityReservationFleet (Maybe Bool) Source #

Indicates whether to remove the end date from the Capacity Reservation Fleet. If you remove the end date, the Capacity Reservation Fleet does not expire and it remains active until you explicitly cancel it using the CancelCapacityReservationFleet action.

You can't specify RemoveEndDate and EndDate in the same request.

modifyCapacityReservationFleet_totalTargetCapacity :: Lens' ModifyCapacityReservationFleet (Maybe Int) Source #

The total number of capacity units to be reserved by the Capacity Reservation Fleet. This value, together with the instance type weights that you assign to each instance type used by the Fleet determine the number of instances for which the Fleet reserves capacity. Both values are based on units that make sense for your workload. For more information, see Total target capacity in the Amazon EC2 User Guide.

Destructuring the Response

data ModifyCapacityReservationFleetResponse Source #

Constructors

ModifyCapacityReservationFleetResponse' 

Fields

Instances

Instances details
Generic ModifyCapacityReservationFleetResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

Read ModifyCapacityReservationFleetResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

Show ModifyCapacityReservationFleetResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

NFData ModifyCapacityReservationFleetResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

Eq ModifyCapacityReservationFleetResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

type Rep ModifyCapacityReservationFleetResponse Source # 
Instance details

Defined in Amazonka.EC2.ModifyCapacityReservationFleet

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

newModifyCapacityReservationFleetResponse Source #

Create a value of ModifyCapacityReservationFleetResponse 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':ModifyCapacityReservationFleetResponse', modifyCapacityReservationFleetResponse_return - Returns true if the request succeeds; otherwise, it returns an error.

$sel:httpStatus:ModifyCapacityReservationFleetResponse', modifyCapacityReservationFleetResponse_httpStatus - The response's http status code.

Response Lenses

modifyCapacityReservationFleetResponse_return :: Lens' ModifyCapacityReservationFleetResponse (Maybe Bool) Source #

Returns true if the request succeeds; otherwise, it returns an error.