ec2-download-bundle

From Amazon Elastic Compute Cloud: 2008-12-01

previous page next page

ec2-download-bundle

Syntax

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]

Description

Download the specified bundles from S3 storage.

Options

Option	Description	Required
`-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-cracked`	Yes
`-m, --manifest` `manifest`	The manifest path and filename. Example: `-m /var/spool/my-first-bundle/Manifest`	No
`-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 eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ==`	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 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 10QMXFEV71ZS32XQFTR2 -s eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ== -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.

	Note
	This example uses the Linux and UNIX `mkdir` command.

ec2-download-bundle

ec2-download-bundle

Syntax

Description

Options

Output

Example

Related Topics