Skip to content

EC2  >  Operations  >  bundle_instance

bundle_instance

Operation

bundle_instance async 

bundle_instance(input: BundleInstanceInput, plugins: list[Plugin] | None = None) -> BundleInstanceOutput

Bundles an Amazon instance store-backed Windows instance.

During bundling, only the root device volume (C:) is bundled. Data on other instance store volumes is not preserved.

Note

BundleInstance is no longer supported. To create an AMI, use CreateImage instead. For more information about creating an Amazon EBS-backed AMI, see Create an Amazon EBS-backed AMI in the Amazon EC2 User Guide.

Parameters:

Name Type Description Default
input BundleInstanceInput

An instance of BundleInstanceInput.

 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
BundleInstanceOutput

An instance of BundleInstanceOutput.

Input

BundleInstanceInput dataclass

Bases: _SerdeShape

Contains the parameters for BundleInstance.

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.

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

The ID of the instance to bundle.

Default: None

storage class-attribute instance-attribute 
storage: Storage | None = ...

The bucket in which to store the AMI. You can specify a bucket that you already own or a new bucket that Amazon EC2 creates on your behalf. If you specify a bucket that belongs to someone else, Amazon EC2 returns an error.

Output

BundleInstanceOutput dataclass

Bases: _SerdeShape

Contains the output of BundleInstance.

Attributes

bundle_task class-attribute instance-attribute 
bundle_task: BundleTask | None = ...

Information about the bundle task.

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.