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

NAME

       ec2-register - Register image

SYNOPSIS

        ec2reg ([ec2-register])
        ec2reg [GENERAL OPTIONS] [MANIFEST] [SPECIFIC OPTIONS]

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

        Register an Amazon Machine Image (AMI) for use within Amazon EC2.

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

        -a, --architecture ARCHITECTURE
            The architecture of the image; either 'i386' or 'x86_64'. If not
            specified, 'i386' will be used.

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

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

        -n, --name NAME
            The name of the image, which must be between 3 and 128 characters
            long, and may contain letters, numbers and the following special
            characters: ( ) . - / _

        -s, --snapshot SNAPSHOT
            The ID of the Amazon EBS snapshot to be used as the root device.

        --kernel KERNEL
            The ID of the kernel associated with the image.

        --ramdisk RAMDISK
            The ID of the ramdisk associated with the image.

        --root-device-name ROOTDEVICENAME
            The name of the root device, e.g. '/dev/sda1'.

        --virtualization-type VIRTUALIZATION_TYPE
            Set the AMI virtualization type.

        --sriov SRIOV
            Set SR-IOV networking support for the AMI.

SEE ALSO

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