ec2-bundle-instance

Description

Bundles the Windows instance. For more information, go to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud Getting Started Guide.

[Note]Note

During bundling, only the root store (C:\) is bundled. Data on other instance stores is not preserved.

This procedure is not applicable for Linux and UNIX instances or Windows instances that use Amazon EBS volumes as their root devices.

Syntax

ec2-bundle-instance instance_id -b bucket -p prefix -o access-key-id {-c policy | -w secret-access-key} [options]

Options

NameDescriptionRequired

instance_id

The ID of the instance to bundle.

Type: String

Default: None

Example: i-5e73d509

Yes

-b bucket

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: String

Default: None

Example: mybucket

Yes

-p prefix

Specifies the beginning of the file name of the AMI.

Type: String

Default: None

Example: winami

Yes

-o access-key-id

The Access Key ID of the owner of the Amazon S3 bucket.

Type: String

Default: None

Example: 157SZTMZQT516NAZ7CR2

Yes

-c policy

A Base64-encoded Amazon S3 upload policy that gives Amazon EC2 permission to upload items into Amazon S3 on the user's behalf.

Type: String

Default: None

Example: upload-policy

Yes

-v secret-access-key

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: String

Default: None

Example: eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ==

Yes

Output

The command returns a table that contains the following information:

  • BUNDLE identifier

  • ID of the bundle

  • ID of the instance

  • Bucket name

  • Bundle prefix

  • Bundle status

  • Bundle start time

Amazon EC2 displays errors on stderr.

Examples

Example Request

This example bundles the i-e468cd8d instance.

PROMPT> ec2-bundle-instance  i-12345 -b mybucket -p winami -o AIDADH4IGTRXXKCD -w
							eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ==
BUNDLE bun-c1a540a8 i-12345 mybucket winami pending
							2008-09-15T17:15:20+0000 2008-09-15T17:15:20+0000