Common Options
All command line tools covered in the following sections accept a common set of optional parameters as
follows:
Element Name Definition Valid Values/
Types
Example
-U URL URL is the uniform resource locator of the
Amazon EC2 web service entry point. This op-
tion defaults to the value of the EC2_URL envir-
onment variable, or http://ec2.amazonaws.com
if that is not set.
URL -U ht-
tp://ec2.a
mazon-
aws.com
-K
EC2-PRIVATE-KE
Y
The private key to use when constructing re-
quests to Amazon EC2. This parameter defaults
to the value of the EC2_PRIVATE_KEY environ-
ment variable.
File name -K pk-
HKZYK-
TAIG2ECMXY
IBH3HXV4ZB
ZQ55CLO.pe
m
-C EC2-CERT The X509 certificate to use when constructing
requests to Amazon EC2. This parameter de-
faults to the value of the EC2_CERT environ-
ment variable.
File name -C cert-
HKZYK-
TAIG2ECMXY
IBH3HXV4ZB
ZQ55CLO.pe
m
-v
Increase output verbosity. This will print the
SOAP request and response on the command
line. This is particularly useful if you're trying
to build your own tools to talk directly to our
SOAP API.
N/A N/A
--debug
Print internal debugging information. This is in-
tended to assist us to troubleshoot problems.
N/A N/A
-?
Show help.
N/A N/A
- If - is specified as an argument to one of the
parameters, a list of arguments will be read
from stdin. This is useful for piping the output
of one command into the input of another.
N/A ec2-descri
be-
instances
| grep
running |
cut -f 2 |
ec2-termin
ate-
instances
-i -
Amazon EC2
Developer Guide
25
ec2-register
SYNOPSIS
ec2-register MANIFEST
DESCRIPTION
Registers the Amazon Machine Image (AMI) described by the named MANIFEST file, generating a
new Amazon Machine Image (AMI) ID. MANIFEST must specify a location of a manifest file in
Amazon S3 and must be of the form bucket/object.
OUTPUT
The image ID that was assigned by Amazon EC2 is displayed.
Errors are displayed on stderr.
EXAMPLE
$ ec2-register mybucket/image.manifest
IMAGE ami-78a54011
SEE ALSO
RegisterImage
ec2-deregister
ec2-describe-images
Amazon EC2
Developer Guide
26
Previous Page Next Page