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