Provided by: ec2-api-tools_1.6.12.0-0ubuntu1_all
NAME
ec2-bundle-instance - Bundle a running instance on next reboot
SYNOPSIS
ec2bundle ([ec2-bundle-instance]) ec2bundle [GENERAL OPTIONS] -b BUCKET -p PREFIX -o OWNER-AKID (-c POLICY | -w OWNER-ACCESS-KEY) [OPTIONS] INSTANCE
GENERAL NOTES
Any command option/parameter may be passed a value of '-' to indicate that values for that option should be read from stdin.
DESCRIPTION
Bundle a running instance into an AMI upon next reboot and store the image components in S3. Items are stored in S3 on the user's behalf using a signed S3 upload policy. An upload policy and corresponding signature can be specified as parameters or generated automatically if the Secret Access Key for the owner of the S3 bucket is available. The generated policy is valid for 24 hours by default. Alternatively, if a policy and Secret Access Key are given, the provided policy is signed and used. If a policy is generated, use --verbose to display the policy. The S3 bucket is created if it does not exist and the user ec2-bundled-images@amazon.com is granted read permissions on the entire bucket. To skip these checks, use --no-bucket-setup.
GENERAL OPTIONS
-O, --aws-access-key KEY AWS Access Key ID. Defaults to the value of the AWS_ACCESS_KEY environment variable (if set). -W, --aws-secret-key KEY AWS Secret Access Key. Defaults to the value of the AWS_SECRET_KEY environment variable (if set). -T, --security-token TOKEN AWS delegation token. Defaults to the value of the AWS_DELEGATION_TOKEN environment variable (if set). -K, --private-key KEY [DEPRECATED] Specify KEY as the private key to use. Defaults to the value of the EC2_PRIVATE_KEY environment variable (if set). Overrides the default. -C, --cert CERT [DEPRECATED] Specify CERT as the X509 certificate to use. Defaults to the value of the EC2_CERT environment variable (if set). Overrides the default. -U, --url URL Specify URL as the web service URL to use. Defaults to the value of 'https://ec2.amazonaws.com' (us-east-1) or to that of the EC2_URL environment variable (if set). Overrides the default. --region REGION Specify REGION as the web service region to use. This option will override the URL specified by the "-U URL" option and EC2_URL environment variable. This option defaults to the region specified by the EC2_URL environment variable or us-east-1 if this environment variable is not set. -D, --auth-dry-run Check if you can perform the requested action rather than actually performing it. -v, --verbose Verbose output. -?, --help Display this help. -H, --headers Display column headers. --debug Display additional debugging information. --show-empty-fields Indicate empty fields. --hide-tags Do not display tags for tagged resources. --connection-timeout TIMEOUT Specify a connection timeout TIMEOUT (in seconds). --request-timeout TIMEOUT Specify a request timeout TIMEOUT (in seconds). -b, --bucket BUCKET S3 bucket in which to place the image components. Bucket name should be in lower case. -p, --prefix PREFIX Prefix for the image component names being store in S3. -o, --owner-akid OWNER-ACCESS-KEY AWS Access Key Id of the owner of BUCKET. -w, --owner-sak OWNER-SECRET-KEY AWS Secret Access Key of the owner of BUCKET, used to sign the upload policy. This parameter is required to generate a policy if --policy is not given, and to sign a given or generated policy if --policy-signature is not given. This parameter value is not sent to EC2. -c, --policy POLICY Plaintext or base-64 encoded upload policy for S3, allowing EC2 to place items into S3 on the user's behalf. If this is not given, --owner-sak is required and an upload policy is generated and signed automatically. For more information on upload policies see the Amazon S3 Developer Guide. -s, --policy-signature POLICY-SIG Base-64 encoded signature for the S3 upload policy. If --policy is given but this is omitted, --owner-sak is required and the policy is signed using that value. -x, --expires HOURS Validity period for a generate upload policy, in hours. Defaults to 24. -B, --no-bucket-setup If the S3 bucket doesn't exist, don't create it. If the permissions aren't correct, don't attempt to fix them. --location The location of the destination Amazon S3 bucket
SEE ALSO
http://docs.amazonwebservices.com/AWSEC2/2013-10-15/CommandLineReference http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference