BundleInstance
Description
Bundles the Windows instance. This procedure is not applicable for Linux and UNIX instances. For more information, go to the
![[Note]](note.png) | Note |
|---|---|
During bundling, only the root store (C:\) is bundled. Data on other instance stores is not preserved. |
Request Parameters
| Name | Description | Required |
|---|---|---|
|
|
Type: BundleInstanceType Ancestor: None Children: |
|
|
The ID of the instance to bundle. Type: xsd:string Default: None Ancestor: Children: None |
Yes |
|
Amazon S3 storage locations. Type: BundleInstanceTaskStorageType Ancestor: Children: |
Yes |
|
Amazon S3 storage location. Type: BundleInstanceS3StorageType Ancestor: Children: |
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: xsd:string Default: None Ancestor: Children: None |
Yes |
|
Specifies the beginning of the file name of the AMI. Type: xsd:string Default: None Ancestor: Children: None |
Yes |
|
The Access Key ID of the owner of the Amazon S3 bucket. Type: xsd:string Default: None Ancestor: Children: None |
Yes |
|
An Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on the user's behalf. For more information on bundling in Windows, go to the Type: xsd:string Default: None Ancestor: Children: None |
Yes |
|
The signature of the Base64 encoded JSON document. Type: xsd:string Default: None Ancestor: Children: None |
Yes |
JSON Parameters
The upload policy gives Amazon EC2 limited permission to upload items into your Amazon S3 bucket. The following table describes the required parameters for the upload policy JSON document. Parameter names are case sensitive. For more information about upload policies and how to sign them, go to the Amazon Elastic Compute Cloud Developer Guide.
| Name | Description | Required |
|---|---|---|
|
The expiration of the policy. We recommend 12 hours or longer. |
Yes |
|
A list of restrictions on what can be uploaded to Amazon S3. Must contain the bucket and ACL conditions in this table. |
Yes |
|
The bucket to store the AMI. |
Yes |
|
This must be set to ec2-bundle-read. |
Yes |
Response Elements
| Name | Description |
|---|---|
|
|
Type: BundleInstanceResponseType Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
Bundle task. Type: BundleInstanceTaskType Ancestor: Children: |
|
Instance associated with this bundle task. Type: xsd:string Ancestor: Children: None |
|
Identifier for this task. Type: xsd:string Ancestor: Children: None |
|
The state of the task. Type: xsd:string Ancestor: Children: None |
|
The time this task started. Type: xsd:dateTime Ancestor: Children: None |
|
The time of the most recent update for the task. Type: xsd:dateTime Ancestor: Children: None |
|
Amazon S3 storage locations. Type: BundleInstanceTaskStorageType Ancestor: Children: |
|
Amazon S3 storage location. Type: BundleInstanceS3StorageType Ancestor: Children: |
|
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: xsd:string Ancestor: Children: None |
|
Specifies the beginning of the file name of the AMI. Type: xsd:string Ancestor: Children: None |
|
The Access Key ID of the owner of the Amazon S3 bucket. Type: xsd:string Ancestor: Children: None |
|
An Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on the user's behalf. For more information on bundling in Windows, go to the Type: xsd:string Ancestor: Children: None |
|
The signature of the Base64 encoded JSON document. Type: xsd:string Ancestor: Children: None |
|
A percentage description of the progress of the task, such as 20%. Type: xsd:string Ancestor: Children: None |
|
If the task fails, a description of the error. Type: BundleInstanceTaskErrorType Ancestor: Children: |
|
Error code. Type: xsd:string Ancestor: Children: None |
|
Error message. Type: xsd:string Ancestor: Children: None |
Examples
Example Request
This example bundles the i-e468cd8d instance.
<BundleInstance xmlns="http://ec2.amazonaws.com/doc/2009-07-15/">
<instanceId>i-e468cd8d</instanceId>
<storage>
<S3>
<bucket>my-bucket</bucket>
<prefix>winami</prefix>
<awsAccessKeyId>10QMXFEV71ZS32XQFTR2</awsAccessKeyId>
<uploadPolicy>eyJleHBpcmF0aW9uIjogIjIwMDgtMDgtMzBUMDg6NDk6MDlaIiwiY29uZGl0aW9ucyI6IFt7Im
J1Y2tldCI6ICJteS1idWNrZXQifSxbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAibXktbmV3LWltYWdlIl1dfQ==</uploadPolicy>
<uploadPolicySignature>w6BZu2oxGsiiLZnoBmQSErotuMA=</uploadPolicySignature>
</S3>
</storage>
</BundleInstance>
Example Response
<BundleInstanceResponse xmlns="http://ec2.amazonaws.com/doc/2009-07-15/">
<requestId>bun-c1a540a8</requestId>
<bundleInstanceTask>
<instanceId>i-12345678</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>my-bucket</bucket>
<prefix>winami</prefix>
</S3>
</storage>
</bundleInstanceTask>
</BundleInstanceResponse>