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-delete-bundle

Description

Deletes the specified bundle from Amazon S3 storage.

Syntax

ec2-delete-bundle -b s3_bucket -a access_key_id -s secret_key [-m manifest_path] [-p ami_prefix] [--url url] [--retry] [-y] [--clear]

Options

OptionDescriptionRequired

-b, --bucket s3_bucket

The name of the Amazon S3 bucket containing the bundled AMI, followed by an optional '/'-delimited path prefix

Example: -b ec2-bucket/ami-001

Yes

-a, --access-key access_key_id

The AWS access key ID.

Example: -a AKIADQKE4SARGYLE

Yes

-s, --secret-key secret_key

The AWS secret access key.

Example: -s eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ==

Yes

-m, --manifest manifest_path

The path to the unencrypted manifest file.

Example: -m /var/spool/my-first-bundle/image.manifest.xml

Condition: You must specify --prefix or --manifest.

Conditional

-p, --prefix ami_prefix

The bundled AMI filename prefix. Provide the entire prefix. For example, if the prefix is image.img, use -p image.img and not -p image.

Example: -p image.img

Condition: You must specify --prefix or --manifest.

Conditional

--url url

The Amazon S3 service URL.

Default: https://s3.amazonaws.com

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

No

--retry

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

Example: --retry

No

-y, --yes

Automatically assumes the answer to all prompts is 'yes'.

Example: -y

No

--clear

Deletes the specified bundle from the Amazon S3 bucket and deletes the bucket, if empty.

Example: --clear

No

Output

Amazon EC2 displays status messages indicating the stages and status of the delete process.

Example

This example deletes a bundle from Amazon S3.

$ ec2-delete-bundle -b my-s3-bucket -a AKIADQKE4SARGYLE -s eW91dHViZS5jb20vd2F0Y2g/dj1SU3NKMTlzeTNKSQ== -p fred
Deleting files:
my-s3-bucket/fred.manifest.xml
my-s3-bucket/fred.part.00
my-s3-bucket/fred.part.01
my-s3-bucket/fred.part.02
my-s3-bucket/fred.part.03
my-s3-bucket/fred.part.04
my-s3-bucket/fred.part.05
my-s3-bucket/fred.part.06
Continue? [y/n]
y
Deleted my-s3-bucket/fred.manifest.xml
Deleted my-s3-bucket/fred.part.00
Deleted my-s3-bucket/fred.part.01
Deleted my-s3-bucket/fred.part.02
Deleted my-s3-bucket/fred.part.03
Deleted my-s3-bucket/fred.part.04
Deleted my-s3-bucket/fred.part.05
Deleted my-s3-bucket/fred.part.06
ec2-delete-bundle complete.