DisableFastLaunch - Amazon Elastic Compute Cloud
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

DisableFastLaunch

Discontinue faster launching for a Windows AMI, and clean up existing pre-provisioned snapshots. When you disable faster launching, the AMI uses the standard launch process for each instance. All pre-provisioned snapshots must be removed before you can enable faster launching again.

Note

To change these settings, you must own the AMI.

Request Parameters

The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.

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.

Type: Boolean

Required: No

Force

Forces the image settings to turn off faster launching for your Windows AMI. This parameter overrides any errors that are encountered while cleaning up resources in your account.

Type: Boolean

Required: No

ImageId

The ID of the image for which you’re turning off faster launching, and removing pre-provisioned snapshots.

Type: String

Required: Yes

Response Elements

The following elements are returned by the service.

imageId

The ID of the image for which faster-launching has been turned off.

Type: String

launchTemplate

The launch template that was used to launch Windows instances from pre-provisioned snapshots.

Type: FastLaunchLaunchTemplateSpecificationResponse object

maxParallelLaunches

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

Type: Integer

ownerId

The owner of the Windows AMI for which faster launching was turned off.

Type: String

requestId

The ID of the request.

Type: String

resourceType

The pre-provisioning resource type that must be cleaned after turning off faster launching for the Windows AMI. Supported values include: snapshot.

Type: String

Valid Values: snapshot

snapshotConfiguration

Parameters that were used for faster launching for the Windows AMI before faster launching was turned off. This informs the clean-up process.

Type: FastLaunchSnapshotConfigurationResponse object

state

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

Type: String

Valid Values: enabling | enabling-failed | enabled | enabled-failed | disabling | disabling-failed

stateTransitionReason

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

Type: String

stateTransitionTime

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

Type: Timestamp

Errors

For information about the errors that are common to all actions, see Common client error codes.

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: