EC2-CREATE-IMAGE(1) | User Commands | EC2-CREATE-IMAGE(1) |
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
1.6.14.1 api=2014-05-01 | EC2 API command line tools |