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

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

When you enable faster launching for a Windows AMI, images are pre-provisioned, using snapshots to launch instances up to 65% faster. To create the optimized Windows image, Amazon EC2 launches an instance and runs through Sysprep steps, rebooting as required. Then it creates a set of reserved snapshots that are used for subsequent launches. The reserved snapshots are automatically replenished as they are used, depending on your settings for launch frequency.

To change these settings, you must own the AMI.

Synopsis

Creating a Request

data EnableFastLaunch Source #

See: newEnableFastLaunch smart constructor.

Constructors

EnableFastLaunch'

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.
launchTemplate :: Maybe FastLaunchLaunchTemplateSpecificationRequest
The launch template to use when launching Windows instances from pre-provisioned snapshots. Launch template parameters can include either the name or ID of the launch template, but not both.
maxParallelLaunches :: Maybe Int
The maximum number of parallel instances to launch for creating resources. Value must be 6 or greater.
resourceType :: Maybe Text
The type of resource to use for pre-provisioning the Windows AMI for faster launching. Supported values include: snapshot, which is the default value.
snapshotConfiguration :: Maybe FastLaunchSnapshotConfigurationRequest
Configuration settings for creating and managing the snapshots that are used for pre-provisioning the Windows AMI for faster launching. The associated ResourceType must be snapshot.
imageId :: Text
The ID of the image for which you’re enabling faster launching.

Instances

Instances details

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

newEnableFastLaunch Source #

Arguments

:: Text	`EnableFastLaunch`
-> EnableFastLaunch

Create a value of EnableFastLaunch 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:EnableFastLaunch', enableFastLaunch_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.

EnableFastLaunch, enableFastLaunch_launchTemplate - The launch template to use when launching Windows instances from pre-provisioned snapshots. Launch template parameters can include either the name or ID of the launch template, but not both.

EnableFastLaunch, enableFastLaunch_maxParallelLaunches - The maximum number of parallel instances to launch for creating resources. Value must be 6 or greater.

EnableFastLaunch, enableFastLaunch_resourceType - The type of resource to use for pre-provisioning the Windows AMI for faster launching. Supported values include: snapshot, which is the default value.

EnableFastLaunch, enableFastLaunch_snapshotConfiguration - Configuration settings for creating and managing the snapshots that are used for pre-provisioning the Windows AMI for faster launching. The associated ResourceType must be snapshot.

EnableFastLaunch, enableFastLaunch_imageId - The ID of the image for which you’re enabling faster launching.

Request Lenses

enableFastLaunch_dryRun :: Lens' EnableFastLaunch (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.

enableFastLaunch_launchTemplate :: Lens' EnableFastLaunch (Maybe FastLaunchLaunchTemplateSpecificationRequest) Source #

The launch template to use when launching Windows instances from pre-provisioned snapshots. Launch template parameters can include either the name or ID of the launch template, but not both.

enableFastLaunch_maxParallelLaunches :: Lens' EnableFastLaunch (Maybe Int) Source #

The maximum number of parallel instances to launch for creating resources. Value must be 6 or greater.

enableFastLaunch_resourceType :: Lens' EnableFastLaunch (Maybe Text) Source #

The type of resource to use for pre-provisioning the Windows AMI for faster launching. Supported values include: snapshot, which is the default value.

enableFastLaunch_snapshotConfiguration :: Lens' EnableFastLaunch (Maybe FastLaunchSnapshotConfigurationRequest) Source #

Configuration settings for creating and managing the snapshots that are used for pre-provisioning the Windows AMI for faster launching. The associated ResourceType must be snapshot.

enableFastLaunch_imageId :: Lens' EnableFastLaunch Text Source #

The ID of the image for which you’re enabling faster launching.

Destructuring the Response

data EnableFastLaunchResponse Source #

See: newEnableFastLaunchResponse smart constructor.

Constructors

EnableFastLaunchResponse'

Fields

imageId :: Maybe Text
The image ID that identifies the Windows AMI for which faster launching was enabled.
launchTemplate :: Maybe FastLaunchLaunchTemplateSpecificationResponse
The launch template that is used when launching Windows instances from pre-provisioned snapshots.
maxParallelLaunches :: Maybe Int
The maximum number of parallel instances to launch for creating resources.
ownerId :: Maybe Text
The owner ID for the Windows AMI for which faster launching was enabled.
resourceType :: Maybe FastLaunchResourceType
The type of resource that was defined for pre-provisioning the Windows AMI for faster launching.
snapshotConfiguration :: Maybe FastLaunchSnapshotConfigurationResponse
The configuration settings that were defined for creating and managing the pre-provisioned snapshots for faster launching of the Windows AMI. This property is returned when the associated resourceType is snapshot.
state :: Maybe FastLaunchStateCode
The current state of faster launching for the specified Windows AMI.
stateTransitionReason :: Maybe Text
The reason that the state changed for faster launching for the Windows AMI.
stateTransitionTime :: Maybe ISO8601
The time that the state changed for faster launching for the Windows AMI.
httpStatus :: Int
The response's http status code.

Instances

Instances details

Generic EnableFastLaunchResponse Source #
Instance details Defined in Amazonka.EC2.EnableFastLaunch Associated Types type Rep EnableFastLaunchResponse :: Type -> Type # Methods from :: EnableFastLaunchResponse -> Rep EnableFastLaunchResponse x # to :: Rep EnableFastLaunchResponse x -> EnableFastLaunchResponse #
Read EnableFastLaunchResponse Source #
Instance details Defined in Amazonka.EC2.EnableFastLaunch Methods readsPrec :: Int -> ReadS EnableFastLaunchResponse # readList :: ReadS [EnableFastLaunchResponse] # readPrec :: ReadPrec EnableFastLaunchResponse # readListPrec :: ReadPrec [EnableFastLaunchResponse] #
Show EnableFastLaunchResponse Source #
Instance details Defined in Amazonka.EC2.EnableFastLaunch Methods showsPrec :: Int -> EnableFastLaunchResponse -> ShowS # show :: EnableFastLaunchResponse -> String # showList :: [EnableFastLaunchResponse] -> ShowS #
NFData EnableFastLaunchResponse Source #
Instance details Defined in Amazonka.EC2.EnableFastLaunch Methods rnf :: EnableFastLaunchResponse -> () #
Eq EnableFastLaunchResponse Source #
Instance details Defined in Amazonka.EC2.EnableFastLaunch Methods (==) :: EnableFastLaunchResponse -> EnableFastLaunchResponse -> Bool # (/=) :: EnableFastLaunchResponse -> EnableFastLaunchResponse -> Bool #
type Rep EnableFastLaunchResponse Source #
Instance details Defined in Amazonka.EC2.EnableFastLaunch type Rep EnableFastLaunchResponse = D1 ('MetaData "EnableFastLaunchResponse" "Amazonka.EC2.EnableFastLaunch" "amazonka-ec2-2.0-48L9RAJvmvzAdBkRegqWCL" 'False) (C1 ('MetaCons "EnableFastLaunchResponse'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "imageId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "launchTemplate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe FastLaunchLaunchTemplateSpecificationResponse))) :: (S1 ('MetaSel ('Just "maxParallelLaunches") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Int)) :: (S1 ('MetaSel ('Just "ownerId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "resourceType") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe FastLaunchResourceType))))) :: ((S1 ('MetaSel ('Just "snapshotConfiguration") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe FastLaunchSnapshotConfigurationResponse)) :: S1 ('MetaSel ('Just "state") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe FastLaunchStateCode))) :: (S1 ('MetaSel ('Just "stateTransitionReason") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: (S1 ('MetaSel ('Just "stateTransitionTime") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int))))))

newEnableFastLaunchResponse Source #

Arguments

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

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

EnableFastLaunch, enableFastLaunchResponse_imageId - The image ID that identifies the Windows AMI for which faster launching was enabled.

EnableFastLaunch, enableFastLaunchResponse_launchTemplate - The launch template that is used when launching Windows instances from pre-provisioned snapshots.

EnableFastLaunch, enableFastLaunchResponse_maxParallelLaunches - The maximum number of parallel instances to launch for creating resources.

EnableFastLaunchResponse, enableFastLaunchResponse_ownerId - The owner ID for the Windows AMI for which faster launching was enabled.

EnableFastLaunch, enableFastLaunchResponse_resourceType - The type of resource that was defined for pre-provisioning the Windows AMI for faster launching.

EnableFastLaunch, enableFastLaunchResponse_snapshotConfiguration - The configuration settings that were defined for creating and managing the pre-provisioned snapshots for faster launching of the Windows AMI. This property is returned when the associated resourceType is snapshot.

EnableFastLaunchResponse, enableFastLaunchResponse_state - The current state of faster launching for the specified Windows AMI.

EnableFastLaunchResponse, enableFastLaunchResponse_stateTransitionReason - The reason that the state changed for faster launching for the Windows AMI.

EnableFastLaunchResponse, enableFastLaunchResponse_stateTransitionTime - The time that the state changed for faster launching for the Windows AMI.

$sel:httpStatus:EnableFastLaunchResponse', enableFastLaunchResponse_httpStatus - The response's http status code.

Response Lenses

enableFastLaunchResponse_imageId :: Lens' EnableFastLaunchResponse (Maybe Text) Source #

The image ID that identifies the Windows AMI for which faster launching was enabled.

enableFastLaunchResponse_launchTemplate :: Lens' EnableFastLaunchResponse (Maybe FastLaunchLaunchTemplateSpecificationResponse) Source #

The launch template that is used when launching Windows instances from pre-provisioned snapshots.

enableFastLaunchResponse_maxParallelLaunches :: Lens' EnableFastLaunchResponse (Maybe Int) Source #

The maximum number of parallel instances to launch for creating resources.

enableFastLaunchResponse_ownerId :: Lens' EnableFastLaunchResponse (Maybe Text) Source #

The owner ID for the Windows AMI for which faster launching was enabled.

enableFastLaunchResponse_resourceType :: Lens' EnableFastLaunchResponse (Maybe FastLaunchResourceType) Source #

The type of resource that was defined for pre-provisioning the Windows AMI for faster launching.

enableFastLaunchResponse_snapshotConfiguration :: Lens' EnableFastLaunchResponse (Maybe FastLaunchSnapshotConfigurationResponse) Source #

The configuration settings that were defined for creating and managing the pre-provisioned snapshots for faster launching of the Windows AMI. This property is returned when the associated resourceType is snapshot.

enableFastLaunchResponse_state :: Lens' EnableFastLaunchResponse (Maybe FastLaunchStateCode) Source #

The current state of faster launching for the specified Windows AMI.

enableFastLaunchResponse_stateTransitionReason :: Lens' EnableFastLaunchResponse (Maybe Text) Source #

The reason that the state changed for faster launching for the Windows AMI.

enableFastLaunchResponse_stateTransitionTime :: Lens' EnableFastLaunchResponse (Maybe UTCTime) Source #

The time that the state changed for faster launching for the Windows AMI.

enableFastLaunchResponse_httpStatus :: Lens' EnableFastLaunchResponse Int Source #

The response's http status code.