ec2-download-bundle

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

Download the specified bundles from S3 storage.

[Note]Note

This tool does not support the Common Options.

OptionDescriptionRequired

b, --bucket -s3_bucket

The name of the Amazon S3 bucket where the bundle is located.

Example: -b aes-cracked

Yes

-m, --manifest manifest

The manifest path and filename.

Example: -m /var/spool/my-first-bundle/Manifest

Yes

-a, --access-key access_key_id

Your AWS access key ID.

Example: -a 10QMXFEV71ZS32XQFTR2

Yes

-s, --secret-key secret_key

Your AWS secret access key.

Example: -s DMADSSfPfdaDjbK+RRUhS/aDrjsiZadgAUm8gRU2

Yes

-k, --privatekey private_key

The private key used to decrypt the manifest.

Example: -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.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 bundles are saved. The directory must exist.

Default: The current working directory

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

No

--url url

The S3 service URL.

Default: https://s3.amazonaws.com

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

No

--help

Display the help message.

Example: --help

No

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

This example downloads 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 10QMXFEV71ZS32XQFTR2 -s DMADSSfPfdaDjbK+RRUhS/aDrjsiZadgAUm8gRU2 -k pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.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.