sourCEntral - mobile manpages

pdf

EC2-CREATE-IMAGE

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.

SEE ALSO

http://docs.amazonwebservices.com/AWSEC2/2014-05-01/CommandLineReference
http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference

pdf