BundleInstance - 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 (PDF).


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.


This action is not applicable for Linux/Unix instances or Windows instances that are backed by Amazon EBS.

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.


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


The ID of the instance to bundle.

Default: None

Type: String

Required: Yes


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.

Type: Storage object

Required: Yes

Response Elements

The following elements are returned by the service.


Information about the bundle task.

Type: BundleTask object


The ID of the request.

Type: String


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



This example request bundles the specified instance.

Before you specify a value for your access key ID, review and follow the guidance in Best Practices for Amazon accounts in the Amazon Account Management Reference Guide.

Sample Request

https://ec2.amazonaws.com/?Action=BundleInstance &InstanceId=i-1234567890abcdef0 &Storage.S3.AWSAccessKeyId='AKIAIOSFODNN7EXAMPLE' &Storage.S3.Bucket=myawsbucket &Storage.S3.Prefix=winami &Storage.S3.UploadPolicy=eyJleHBpcmF0aW9uIjogIjIwMDgtMDgtMzBUMDg6NDk6MD laIiwiY29uZGl0aW9ucyI6IFt7ImJ1Y2tldCI6ICJteS1idWNrZXQifSxbInN0YXJ0cy13aXRoIiwgI iRrZXkiLCAibXktbmV3LWltYWdlIl0seyJhY2wiOiAiZWMyLWJ1bmRsZS1yZWFkIn1dfEXAMPLE &Storage.S3.UploadPolicySignature=fh5tyyyQD8W4COEthj3nlGNEXAMPLE &AUTHPARAMS

Sample Response

<BundleInstanceResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/"> <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> <bundleInstanceTask> <instanceId>i-1234567890abcdef0</instanceId> <bundleId>bun-c1a540a8</bundleId> <state>bundling</state> <startTime>2008-10-07T11:41:50.000Z</startTime> <updateTime>2008-10-07T11:51:50.000Z</updateTime> <progress>70%</progress> <storage> <S3> <bucket>myawsbucket</bucket> <prefix>winami</prefix> </S3> </storage> </bundleInstanceTask> </BundleInstanceResponse>

See Also

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