Amazon Elastic Compute Cloud
CLI Reference (API Version 2011-12-15)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

ec2-download-bundle

Description

Download the specified bundles from S3 storage.

Syntax

ec2-download-bundle -b s3_bucket [-m manifest] -a access_key_id -s secret_key -k private_key [-p ami_prefix] [-d directory] [--retry] [--url url]

Options

OptionDescriptionRequired

-b, --bucket s3_bucket

The name of the Amazon S3 bucket where the bundle is located, followed by an optional '/'-delimited path prefix.

Example: -b ec2-bucket/ami-001

Yes

-m, --manifest manifest

The manifest filename (without the path). We recommend you specify either the manifest (option -m), or the filename prefix (option -p).

Example: -m my-image.manifest.xml

No

-a, --access-key access_key_id

Your AWS access key ID.

Example: -a AKIAIOSFODNN7EXAMPLE

Yes

-s, --secret-key secret_key

Your AWS secret access key.

Example: -s wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY

Yes

-k, --privatekey private_key

The private key used to decrypt the manifest.

Example: -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem

Yes

-p, --prefix ami_prefix

The filename prefix for the bundled AMI files.

Default: image

Example: -p my-image

No

-d, --directory directory

The directory where the downloaded bundle is saved. The directory must exist.

Default: The current working directory.

Example: -d /tmp/my-downloaded-bundle

No

--retry

Automatically retries on all Amazon S3 errors, up to five times per operation.

Example: --retry

No

--url url

The S3 service URL.

Default: https://s3.amazonaws.com

Example: --url https://s3.amazonaws.ie

No

Output

Status messages indicating the various stages of the download process are displayed.

Example

This example creates the bundled directory and downloads the bundle from the my-s3-bucket Amazon S3 bucket.

$ mkdir bundled
$ ec2-download-bundle -b my-s3-bucket -m fred.manifest.xml -a AKIAIOSFODNN7EXAMPLE -s wJalrXUtnFEMI/K7MDENG/bPxRfiCYzEXAMPLEKEY -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBEXAMPLE.pem -d bundled
downloading manifest https://s3.amazonaws.com/my-s3-bucket/image.manifest.xml to bundled/image.manifest.xml ...
downloading part https://s3.amazonaws.com/my-s3-bucket/image.part.00 to bundled/image.part.00 ...
Downloaded image.part.00 from https://s3.amazonaws.com/my-s3-bucket.
downloading part https://s3.amazonaws.com/my-s3-bucket/image.part.01 to bundled/image.part.01 ...
Downloaded image.part.01 from https://s3.amazonaws.com/my-s3-bucket.
downloading part https://s3.amazonaws.com/my-s3-bucket/image.part.02 to bundled/image.part.02 ...
Downloaded image.part.02 from https://s3.amazonaws.com/my-s3-bucket.
downloading part https://s3.amazonaws.com/my-s3-bucket/image.part.03 to bundled/image.part.03 ...
Downloaded image.part.03 from https://s3.amazonaws.com/my-s3-bucket.
downloading part https://s3.amazonaws.com/my-s3-bucket/image.part.04 to bundled/image.part.04 ...
Downloaded image.part.04 from https://s3.amazonaws.com/my-s3-bucket.
downloading part https://s3.amazonaws.com/my-s3-bucket/image.part.05 to bundled/image.part.05 ...
Downloaded image.part.05 from https://s3.amazonaws.com/my-s3-bucket.
downloading part https://s3.amazonaws.com/my-s3-bucket/image.part.06 to bundled/image.part.06 ...
Downloaded image.part.06 from https://s3.amazonaws.com/my-s3-bucket.
Download Bundle complete.   
[Note]Note

This example uses the Linux and UNIX mkdir command.