Skip to content

EC2  >  Operations  >  enable_fast_launch

enable_fast_launch

Operation

enable_fast_launch async

enable_fast_launch(input: EnableFastLaunchInput, plugins: list[Plugin] | None = None) -> EnableFastLaunchOutput

When you enable Windows fast launch 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.

Note

You can only change these settings for Windows AMIs that you own or that have been shared with you.

Parameters:

Name Type Description Default
input EnableFastLaunchInput

An instance of EnableFastLaunchInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
EnableFastLaunchOutput

An instance of EnableFastLaunchOutput.

Input

EnableFastLaunchInput dataclass

Bases: _SerdeShape

Dataclass for EnableFastLaunchInput structure.

Attributes

dry_run class-attribute instance-attribute
dry_run: bool | None = ...

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.

image_id class-attribute instance-attribute
image_id: str | None = ...

Specify the ID of the image for which to enable Windows fast launch.

launch_template class-attribute instance-attribute
launch_template: FastLaunchLaunchTemplateSpecificationRequest | None = ...

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.

max_parallel_launches class-attribute instance-attribute
max_parallel_launches: int | None = ...

The maximum number of instances that Amazon EC2 can launch at the same time to create pre-provisioned snapshots for Windows fast launch. Value must be 6 or greater.

resource_type class-attribute instance-attribute
resource_type: str | None = ...

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

snapshot_configuration class-attribute instance-attribute
snapshot_configuration: FastLaunchSnapshotConfigurationRequest | None = ...

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

Output

EnableFastLaunchOutput dataclass

Bases: _SerdeShape

Dataclass for EnableFastLaunchOutput structure.

Attributes

image_id class-attribute instance-attribute
image_id: str | None = ...

The image ID that identifies the AMI for which Windows fast launch was enabled.

launch_template class-attribute instance-attribute
launch_template: FastLaunchLaunchTemplateSpecificationResponse | None = ...

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

max_parallel_launches class-attribute instance-attribute
max_parallel_launches: int | None = ...

The maximum number of instances that Amazon EC2 can launch at the same time to create pre-provisioned snapshots for Windows fast launch.

owner_id class-attribute instance-attribute
owner_id: str | None = ...

The owner ID for the AMI for which Windows fast launch was enabled.

resource_type class-attribute instance-attribute
resource_type: str | None = ...

The type of resource that was defined for pre-provisioning the AMI for Windows fast launch.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

snapshot_configuration class-attribute instance-attribute
snapshot_configuration: FastLaunchSnapshotConfigurationResponse | None = ...

Settings to create and manage the pre-provisioned snapshots that Amazon EC2 uses for faster launches from the Windows AMI. This property is returned when the associated resourceType is snapshot.

state class-attribute instance-attribute
state: str | None = ...

The current state of Windows fast launch for the specified AMI.

state_transition_reason class-attribute instance-attribute
state_transition_reason: str | None = ...

The reason that the state changed for Windows fast launch for the AMI.

state_transition_time class-attribute instance-attribute
state_transition_time: datetime | None = ...

The time that the state changed for Windows fast launch for the AMI.