ec2-bundle-instance
Syntax
ec2-bundle-instance instance -b bucket -p prefix -o access-key-id {-c policy | -w secret-access-key} --location {US | EU} [options]
Description
Bundles the Windows instance. This procedure is not applicable for Linux and UNIX instances. For more information, see
![]() | Note |
|---|---|
During bundling, only the root store (C:\) is bundled. Data on other instance stores is not preserved. |
Options
| Option | Description | Required |
|---|---|---|
|
|
ID of the instance to bundle. Example: i-5e73d509 |
Yes |
|
|
The name of the Amazon S3 bucket where the command stores 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. Example: |
Yes |
|
|
Specifies the beginning of the file name of the AMI. Example: |
Yes |
|
|
Access key ID of the bucket owner;. Example: |
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, see Bundling a Windows AMI. Condition: Required if a secret access key is not specified. Example: |
Conditional |
|
|
Secret access key of the bucket owner. Condition: Required if a policy signature is not specified. Example: |
Conditional |
|
|
The location of the destination Amazon S3 bucket. Default: Amazon EC2 attempts to determine the correct location. Example: Valid Values: US | EU |
No |
Output
Amazon EC2 returns a table that contains the following information:
-
Output type identifier ("BUNDLE")
-
Bundle identifier
-
Instance ID
-
Bucket name
-
Bundle prefix
-
Bundle status
-
Bundle start time
Amazon EC2 displays errors on stderr.
Example
This example bundles the i-2674d22r instance.
PROMPT>ec2-bundle-instance i-12345 -b mybucket -p winami -o 157SZTMZQT516NAZ7CR2 -w eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ==BUNDLE bun-c1a540a8 i-12345 mybucket winami pending 2008-09-15T17:15:20+0000 2008-09-15T17:15:20+0000
![[Note]](note.png)