ec2-create-image - Online in the Cloud

PROGRAM:

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>]][:encrypted]]':
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.

- 'encrypted': Indicates that the volume should be encrypted.

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

See the latest Developer's Guide for further information.

Use ec2-create-image online using onworks.net services