ec2-run-instances
SYNOPSIS
ec2-run-instances AMI [-n INSTANCE_COUNT] [-g GROUP [-g GROUP ...]] [-k KEY]
DESCRIPTION
Launches one or more instances of the specified AMI. An optional security group in which new
instances should be launched may be specified. If no group is specified instances are launched in the
default group. A keypair name may also be specified. If provided, the public key associated with this
keypair will be made available to the instances at boot time.
OUTPUT
A table containing the following information is returned:
Output type identifier ("INSTANCE")
Instance ID which uniquely identifies each running instance.
AMI ID of the image the instance is based on.
DNS name associated with the instance (only present for instances in the running state).
Instance state. This will in most cases be pending which indicates that the instance is being prepared
for launch.
Key name. If a key was associated with the instance at launch it's name will be displayed in this
column.
Errors are displayed on stderr.
OPTIONS
Option Definition Required? Example
-n IN-
STANCE_COUNT
The number of instances to launch. If
not specified, a value of 1 will be as-
sumed. If it is not possible to launch at
least this many instances (due to a lack
of capacity or funds), no instances will
be launched. If specified as a range
(min-max) Amazon EC2 will try to
launch as many instances as possible,
up to max, but will launch no fewer
than min instances.
No -n 5
-g GROUP The security group(s) within which the
instance(s) should be run. This determ-
ines the ingress firewall rules that will
be applied to the instances. By default
instances will run in the user's default
group. If more than one group is spe-
cified, the security policy of the in-
stances will be the union of the secur-
ity policies of the specified groups.
No -g fooGroup
Amazon EC2
Developer Guide
33
Option Definition Required? Example
-k KEY The keypair to make available to these
instances at boot time.
No -k fooKeyPair
EXAMPLE
$ ec2-run-instances ami-6ba54002 -n 5
INSTANCE i-3ea74257 ami-6ba54002 pending
INSTANCE i-31a74258 ami-6ba54002 pending
INSTANCE i-31a74259 ami-6ba54002 pending
INSTANCE i-31a7425a ami-6ba54002 pending
INSTANCE i-31a7425b ami-6ba54002 pending
INSTANCE i-31a7425c ami-6ba54002 pending
SEE ALSO
RunInstances
ec2-terminate-instances
ec2-describe-instances
ec2-add-keypair
Amazon EC2
Developer Guide
34
Previous Page Next Page