BundleInstance
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
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.
- 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 isUnauthorizedOperation
.Type: Boolean
Required: No
- InstanceId
-
The ID of the instance to bundle.
Default: None
Type: String
Required: Yes
- Storage
-
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.
- bundleInstanceTask
-
Information about the bundle task.
Type: BundleTask object
- requestId
-
The ID of the request.
Type: String
Errors
For information about the errors that are common to all actions, see Common client error codes.
Examples
Example
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: