Provided by: ec2-api-tools_1.6.12.0-0ubuntu1_all bug

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