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

NAME

       ec2-create-image - Register an AMI manifest for use with EC2

SYNOPSIS

        ec2cim ([ec2-create-image])
        ec2cim [GENERAL 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

        Creates an Amazon EBS-backed AMI from a running or stopped instance.

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).

SPECIFIC OPTIONS

        -n, --name NAME
            The name of the image.

        -d, --description DESCRIPTION
            The description of the image.

        --no-reboot
            If specified, the instance will not be rebooted during the bundle
            process.

        -b, --block-device-mapping MAPPING
            Defines a block device mapping for the image, in the form
            '<device>=<block-device>', where 'block-device' can be one of the
            following:

             - 'none': indicates that a block device that would be exposed at the
               specified device should be suppressed. For example: '/dev/sdb=none'

             - 'ephemeral[0-3]': indicates that the Amazon EC2 ephemeral store
               (instance local storage) should be exposed at the specified device.
               For example: '/dev/sdc=ephemeral0'.

             - '[<snapshot-id>][:<size>[:<delete-on-termination>][:<type>[:<iops>]]]': indicates
               that an Amazon EBS volume, created from the specified Amazon EBS
               snapshot, should be exposed at the specified device. The following
               combinations are supported:

                - '<snapshot-id>': the ID of an Amazon EBS snapshot, which must
                  be owned by the caller. May be left out if a <size> is
                  specified, creating an empty Amazon EBS volume of the specified
                  size.

                - '<size>': the size (GiBs) of the Amazon EBS volume to be
                  created. If a snapshot was specified, this may not be smaller
                  than the size of the snapshot itself.

                - '<delete-on-termination>': indicates whether the Amazon EBS
                  volume should be deleted on instance termination. If not
                  specified, this will default to 'true' and the volume will be
                  deleted.

                - '<type>': specifies the volume type. This can be either
                  'standard' or 'io1'. Defaults to standard.

                - '<iops>': The requested number of I/O operations per
                  second that the volume can support.

               For example: '/dev/sdb=snap-7eb96d16'
                            '/dev/sdc=snap-7eb96d16:80:false'
                            '/dev/sdc=snap-7eb96d16:80:false:io1:100'
                            '/dev/sdd=:120'

            See the latest Developer's Guide for further information.

SEE ALSO

         http://docs.amazonwebservices.com/AWSEC2/2013-10-15/CommandLineReference
         http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference