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.Types.SpotInstanceRequest

Description

Synopsis

data SpotInstanceRequest = SpotInstanceRequest' {
- actualBlockHourlyPrice :: Maybe Text
- availabilityZoneGroup :: Maybe Text
- blockDurationMinutes :: Maybe Int
- createTime :: Maybe ISO8601
- fault :: Maybe SpotInstanceStateFault
- instanceId :: Maybe Text
- instanceInterruptionBehavior :: Maybe InstanceInterruptionBehavior
- launchGroup :: Maybe Text
- launchSpecification :: Maybe LaunchSpecification
- launchedAvailabilityZone :: Maybe Text
- productDescription :: Maybe RIProductDescription
- spotInstanceRequestId :: Maybe Text
- spotPrice :: Maybe Text
- state :: Maybe SpotInstanceState
- status :: Maybe SpotInstanceStatus
- tags :: Maybe [Tag]
- type' :: Maybe SpotInstanceType
- validFrom :: Maybe ISO8601
- validUntil :: Maybe ISO8601
}
newSpotInstanceRequest :: SpotInstanceRequest
spotInstanceRequest_actualBlockHourlyPrice :: Lens' SpotInstanceRequest (Maybe Text)
spotInstanceRequest_availabilityZoneGroup :: Lens' SpotInstanceRequest (Maybe Text)
spotInstanceRequest_blockDurationMinutes :: Lens' SpotInstanceRequest (Maybe Int)
spotInstanceRequest_createTime :: Lens' SpotInstanceRequest (Maybe UTCTime)
spotInstanceRequest_fault :: Lens' SpotInstanceRequest (Maybe SpotInstanceStateFault)
spotInstanceRequest_instanceId :: Lens' SpotInstanceRequest (Maybe Text)
spotInstanceRequest_instanceInterruptionBehavior :: Lens' SpotInstanceRequest (Maybe InstanceInterruptionBehavior)
spotInstanceRequest_launchGroup :: Lens' SpotInstanceRequest (Maybe Text)
spotInstanceRequest_launchSpecification :: Lens' SpotInstanceRequest (Maybe LaunchSpecification)
spotInstanceRequest_launchedAvailabilityZone :: Lens' SpotInstanceRequest (Maybe Text)
spotInstanceRequest_productDescription :: Lens' SpotInstanceRequest (Maybe RIProductDescription)
spotInstanceRequest_spotInstanceRequestId :: Lens' SpotInstanceRequest (Maybe Text)
spotInstanceRequest_spotPrice :: Lens' SpotInstanceRequest (Maybe Text)
spotInstanceRequest_state :: Lens' SpotInstanceRequest (Maybe SpotInstanceState)
spotInstanceRequest_status :: Lens' SpotInstanceRequest (Maybe SpotInstanceStatus)
spotInstanceRequest_tags :: Lens' SpotInstanceRequest (Maybe [Tag])
spotInstanceRequest_type :: Lens' SpotInstanceRequest (Maybe SpotInstanceType)
spotInstanceRequest_validFrom :: Lens' SpotInstanceRequest (Maybe UTCTime)
spotInstanceRequest_validUntil :: Lens' SpotInstanceRequest (Maybe UTCTime)

Documentation

data SpotInstanceRequest Source #

Describes a Spot Instance request.

See: newSpotInstanceRequest smart constructor.

Constructors

SpotInstanceRequest'

Fields

actualBlockHourlyPrice :: Maybe Text
Deprecated.
availabilityZoneGroup :: Maybe Text
The Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.
blockDurationMinutes :: Maybe Int
Deprecated.
createTime :: Maybe ISO8601
The date and time when the Spot Instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).
fault :: Maybe SpotInstanceStateFault
The fault codes for the Spot Instance request, if any.
instanceId :: Maybe Text
The instance ID, if an instance has been launched to fulfill the Spot Instance request.
instanceInterruptionBehavior :: Maybe InstanceInterruptionBehavior
The behavior when a Spot Instance is interrupted.
launchGroup :: Maybe Text
The instance launch group. Launch groups are Spot Instances that launch together and terminate together.
launchSpecification :: Maybe LaunchSpecification
Additional information for launching instances.
launchedAvailabilityZone :: Maybe Text
The Availability Zone in which the request is launched.
productDescription :: Maybe RIProductDescription
The product description associated with the Spot Instance.
spotInstanceRequestId :: Maybe Text
The ID of the Spot Instance request.
spotPrice :: Maybe Text
The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price.
If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter.
state :: Maybe SpotInstanceState
The state of the Spot Instance request. Spot request status information helps track your Spot Instance requests. For more information, see Spot request status in the Amazon EC2 User Guide for Linux Instances.
status :: Maybe SpotInstanceStatus
The status code and status message describing the Spot Instance request.
tags :: Maybe [Tag]
Any tags assigned to the resource.
type' :: Maybe SpotInstanceType
The Spot Instance request type.
validFrom :: Maybe ISO8601
The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The request becomes active at this date and time.
validUntil :: Maybe ISO8601
The end date of the request, in UTC format (YYYY-MM-DDTHH:MM:SSZ).
- For a persistent request, the request remains active until the validUntil date and time is reached. Otherwise, the request remains active until you cancel it.
- For a one-time request, the request remains active until all instances launch, the request is canceled, or the validUntil date and time is reached. By default, the request is valid for 7 days from the date the request was created.

Instances

Instances details

FromXML SpotInstanceRequest Source #
Instance details Defined in Amazonka.EC2.Types.SpotInstanceRequest Methods parseXML :: [Node] -> Either String SpotInstanceRequest #
Generic SpotInstanceRequest Source #
Instance details Defined in Amazonka.EC2.Types.SpotInstanceRequest Associated Types type Rep SpotInstanceRequest :: Type -> Type # Methods from :: SpotInstanceRequest -> Rep SpotInstanceRequest x # to :: Rep SpotInstanceRequest x -> SpotInstanceRequest #
Read SpotInstanceRequest Source #
Instance details Defined in Amazonka.EC2.Types.SpotInstanceRequest Methods readsPrec :: Int -> ReadS SpotInstanceRequest # readList :: ReadS [SpotInstanceRequest] # readPrec :: ReadPrec SpotInstanceRequest # readListPrec :: ReadPrec [SpotInstanceRequest] #
Show SpotInstanceRequest Source #
Instance details Defined in Amazonka.EC2.Types.SpotInstanceRequest Methods showsPrec :: Int -> SpotInstanceRequest -> ShowS # show :: SpotInstanceRequest -> String # showList :: [SpotInstanceRequest] -> ShowS #
NFData SpotInstanceRequest Source #
Instance details Defined in Amazonka.EC2.Types.SpotInstanceRequest Methods rnf :: SpotInstanceRequest -> () #
Eq SpotInstanceRequest Source #
Instance details Defined in Amazonka.EC2.Types.SpotInstanceRequest Methods (==) :: SpotInstanceRequest -> SpotInstanceRequest -> Bool # (/=) :: SpotInstanceRequest -> SpotInstanceRequest -> Bool #
Hashable SpotInstanceRequest Source #
Instance details Defined in Amazonka.EC2.Types.SpotInstanceRequest Methods hashWithSalt :: Int -> SpotInstanceRequest -> Int # hash :: SpotInstanceRequest -> Int #
type Rep SpotInstanceRequest Source #
Instance details Defined in Amazonka.EC2.Types.SpotInstanceRequest type Rep SpotInstanceRequest = D1 ('MetaData "SpotInstanceRequest" "Amazonka.EC2.Types.SpotInstanceRequest" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "SpotInstanceRequest'" 'PrefixI 'True) ((((S1 ('MetaSel ('Just "actualBlockHourlyPrice") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "availabilityZoneGroup") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "blockDurationMinutes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :: S1 ('MetaSel ('Just "createTime") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601)))) :: ((S1 ('MetaSel ('Just "fault") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SpotInstanceStateFault)) :: S1 ('MetaSel ('Just "instanceId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "instanceInterruptionBehavior") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe InstanceInterruptionBehavior)) :: (S1 ('MetaSel ('Just "launchGroup") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "launchSpecification") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe LaunchSpecification)))))) :: (((S1 ('MetaSel ('Just "launchedAvailabilityZone") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "productDescription") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe RIProductDescription))) :: (S1 ('MetaSel ('Just "spotInstanceRequestId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "spotPrice") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "state") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SpotInstanceState))))) :: ((S1 ('MetaSel ('Just "status") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SpotInstanceStatus)) :: S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Tag]))) :: (S1 ('MetaSel ('Just "type'") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe SpotInstanceType)) :: (S1 ('MetaSel ('Just "validFrom") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601)) :: S1 ('MetaSel ('Just "validUntil") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601))))))))

newSpotInstanceRequest :: SpotInstanceRequest Source #

Create a value of SpotInstanceRequest 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:actualBlockHourlyPrice:SpotInstanceRequest', spotInstanceRequest_actualBlockHourlyPrice - Deprecated.

$sel:availabilityZoneGroup:SpotInstanceRequest', spotInstanceRequest_availabilityZoneGroup - The Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

$sel:blockDurationMinutes:SpotInstanceRequest', spotInstanceRequest_blockDurationMinutes - Deprecated.

$sel:createTime:SpotInstanceRequest', spotInstanceRequest_createTime - The date and time when the Spot Instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

$sel:fault:SpotInstanceRequest', spotInstanceRequest_fault - The fault codes for the Spot Instance request, if any.

$sel:instanceId:SpotInstanceRequest', spotInstanceRequest_instanceId - The instance ID, if an instance has been launched to fulfill the Spot Instance request.

$sel:instanceInterruptionBehavior:SpotInstanceRequest', spotInstanceRequest_instanceInterruptionBehavior - The behavior when a Spot Instance is interrupted.

$sel:launchGroup:SpotInstanceRequest', spotInstanceRequest_launchGroup - The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

$sel:launchSpecification:SpotInstanceRequest', spotInstanceRequest_launchSpecification - Additional information for launching instances.

$sel:launchedAvailabilityZone:SpotInstanceRequest', spotInstanceRequest_launchedAvailabilityZone - The Availability Zone in which the request is launched.

$sel:productDescription:SpotInstanceRequest', spotInstanceRequest_productDescription - The product description associated with the Spot Instance.

$sel:spotInstanceRequestId:SpotInstanceRequest', spotInstanceRequest_spotInstanceRequestId - The ID of the Spot Instance request.

$sel:spotPrice:SpotInstanceRequest', spotInstanceRequest_spotPrice - The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price.

If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter.

$sel:state:SpotInstanceRequest', spotInstanceRequest_state - The state of the Spot Instance request. Spot request status information helps track your Spot Instance requests. For more information, see Spot request status in the Amazon EC2 User Guide for Linux Instances.

$sel:status:SpotInstanceRequest', spotInstanceRequest_status - The status code and status message describing the Spot Instance request.

$sel:tags:SpotInstanceRequest', spotInstanceRequest_tags - Any tags assigned to the resource.

$sel:type':SpotInstanceRequest', spotInstanceRequest_type - The Spot Instance request type.

$sel:validFrom:SpotInstanceRequest', spotInstanceRequest_validFrom - The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The request becomes active at this date and time.

$sel:validUntil:SpotInstanceRequest', spotInstanceRequest_validUntil - The end date of the request, in UTC format (YYYY-MM-DDTHH:MM:SSZ).

For a persistent request, the request remains active until the validUntil date and time is reached. Otherwise, the request remains active until you cancel it.
For a one-time request, the request remains active until all instances launch, the request is canceled, or the validUntil date and time is reached. By default, the request is valid for 7 days from the date the request was created.

spotInstanceRequest_actualBlockHourlyPrice :: Lens' SpotInstanceRequest (Maybe Text) Source #

Deprecated.

spotInstanceRequest_availabilityZoneGroup :: Lens' SpotInstanceRequest (Maybe Text) Source #

The Availability Zone group. If you specify the same Availability Zone group for all Spot Instance requests, all Spot Instances are launched in the same Availability Zone.

spotInstanceRequest_blockDurationMinutes :: Lens' SpotInstanceRequest (Maybe Int) Source #

Deprecated.

spotInstanceRequest_createTime :: Lens' SpotInstanceRequest (Maybe UTCTime) Source #

The date and time when the Spot Instance request was created, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ).

spotInstanceRequest_fault :: Lens' SpotInstanceRequest (Maybe SpotInstanceStateFault) Source #

The fault codes for the Spot Instance request, if any.

spotInstanceRequest_instanceId :: Lens' SpotInstanceRequest (Maybe Text) Source #

The instance ID, if an instance has been launched to fulfill the Spot Instance request.

spotInstanceRequest_instanceInterruptionBehavior :: Lens' SpotInstanceRequest (Maybe InstanceInterruptionBehavior) Source #

The behavior when a Spot Instance is interrupted.

spotInstanceRequest_launchGroup :: Lens' SpotInstanceRequest (Maybe Text) Source #

The instance launch group. Launch groups are Spot Instances that launch together and terminate together.

spotInstanceRequest_launchSpecification :: Lens' SpotInstanceRequest (Maybe LaunchSpecification) Source #

Additional information for launching instances.

spotInstanceRequest_launchedAvailabilityZone :: Lens' SpotInstanceRequest (Maybe Text) Source #

The Availability Zone in which the request is launched.

spotInstanceRequest_productDescription :: Lens' SpotInstanceRequest (Maybe RIProductDescription) Source #

The product description associated with the Spot Instance.

spotInstanceRequest_spotInstanceRequestId :: Lens' SpotInstanceRequest (Maybe Text) Source #

The ID of the Spot Instance request.

spotInstanceRequest_spotPrice :: Lens' SpotInstanceRequest (Maybe Text) Source #

The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price.

If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter.

spotInstanceRequest_state :: Lens' SpotInstanceRequest (Maybe SpotInstanceState) Source #

The state of the Spot Instance request. Spot request status information helps track your Spot Instance requests. For more information, see Spot request status in the Amazon EC2 User Guide for Linux Instances.

spotInstanceRequest_status :: Lens' SpotInstanceRequest (Maybe SpotInstanceStatus) Source #

The status code and status message describing the Spot Instance request.

spotInstanceRequest_tags :: Lens' SpotInstanceRequest (Maybe [Tag]) Source #

Any tags assigned to the resource.

spotInstanceRequest_type :: Lens' SpotInstanceRequest (Maybe SpotInstanceType) Source #

The Spot Instance request type.

spotInstanceRequest_validFrom :: Lens' SpotInstanceRequest (Maybe UTCTime) Source #

The start date of the request, in UTC format (for example, YYYY-MM-DDTHH:MM:SSZ). The request becomes active at this date and time.

spotInstanceRequest_validUntil :: Lens' SpotInstanceRequest (Maybe UTCTime) Source #

The end date of the request, in UTC format (YYYY-MM-DDTHH:MM:SSZ).

For a persistent request, the request remains active until the validUntil date and time is reached. Otherwise, the request remains active until you cancel it.
For a one-time request, the request remains active until all instances launch, the request is canceled, or the validUntil date and time is reached. By default, the request is valid for 7 days from the date the request was created.