euca-run-instances(1)
Launch instances of a machine image
SYNOPSIS
euca-run-instances [-n MIN[-MAX]] [-g GROUP] [-k KEYPAIR]
[-d DATA | --user-data-force DATA | -f FILE]
[--addressing {public,private}] [-t INSTANCETYPE]
[-z ZONE] [--kernel KERNEL] [--ramdisk RAMDISK]
[-b DEVICE=MAPPED] [-m] [--disable-api-termination]
[--instance-initiated-shutdown-behavior {stop,terminate}]
[--placement-group PLGROUP]
[--tenancy {default,dedicated}]
[--client-token TOKEN] [-s SUBNET]
[--private-ip-address ADDRESS]
[--secondary-address ADDRESS | --secondary-count COUNT]
[-a INTERFACE] [-p IPROFILE] [--ebs-optimized]
[--show-empty-fields] [-U URL]
[--region USER@REGION] [-I KEY_ID] [-S KEY]
[--security-token TOKEN] [--debug] [--debugger]
[--version] [-h]
IMAGE
DESCRIPTION
Launch instances of a machine image
positional arguments:
- IMAGE
-
ID of the image to instantiate (required)
optional arguments:
- -n MIN[-MAX], --instance-count MIN[-MAX]
-
number of instances to launch. If this number of
instances cannot be launched, no instances will
launch. If specified as a range (min-max), the server
will attempt to launch the maximum number, but no
fewer than the minimum number.
- -g GROUP, --group GROUP
-
security group(s) in which to launch the instances
- -k KEYPAIR, --key KEYPAIR
-
name of the key pair to use
- -d DATA, --user-data DATA
-
user data to make available to instances in this
reservation
- --user-data-force DATA
-
same as -d/--user-data, but without checking if a file
by that name exists first
- -f FILE, --user-data-file FILE
-
file containing user data to make available to the
instances in this reservation
- --addressing {public,private}
-
[Eucalyptus only] addressing scheme to launch the
instance with. Use "private" to run an instance with
no public address.
- -t INSTANCETYPE, --instance-type INSTANCETYPE
-
type of instance to launch
-
-z ZONE, --availability-zone ZONE
- --kernel KERNEL
-
- ID of the kernel to launch the instance(s) with
- --ramdisk RAMDISK
-
ID of the ramdisk to launch the instance(s) with
- -b DEVICE=MAPPED, --block-device-mapping DEVICE=MAPPED
-
define a block device mapping for the instances, in
the form DEVICE=MAPPED, where "MAPPED" is "none",
"ephemeral(0-3)", or "[SNAPID]:[GiB]:[true|false]:[standard|VOLTYPE[:IOPS]]"
- -m, --monitor
-
enable detailed monitoring for the instance(s)
- --disable-api-termination
-
prevent API users from terminating the instance(s)
- --instance-initiated-shutdown-behavior {stop,terminate}
-
whether to "stop" (default) or terminate EBS instances
when they shut down
- --placement-group PLGROUP
-
name of a placement group to launch into
- --tenancy {default,dedicated}
-
[VPC only] "dedicated" to run on single-tenant
hardware
- --client-token TOKEN
-
unique identifier to ensure request idempotency
- -s SUBNET, --subnet SUBNET
-
[VPC only] subnet to create the instance's network
interface in
- --private-ip-address ADDRESS
-
[VPC only] assign a specific primary private IP
address to an instance's interface
- --secondary-address ADDRESS, --secondary-private-ip-address ADDRESS
-
[VPC only] assign a specific secondary private IP
address to an instance's network interface. Use this
option multiple times to add additional addresses.
- --secondary-count COUNT, --secondary-private-ip-address-count COUNT
-
[VPC only] automatically assign a specific number of
secondary private IP addresses to an instance's
network interface
- -a INTERFACE, --network-interface INTERFACE
-
[VPC only] add a network interface to the new
instance. If the interface already exists, supply its
ID and a numeric index for it, separated by ":", in
the form "eni-NNNNNNNN:INDEX". To create a new
interface, supply a numeric index and subnet ID for
it, along with (in order) an optional description, a
primary private IP address, a list of security group
IDs to associate with the interface, whether to delete
the interface upon instance termination ("true" or
"false"), a number of secondary private IP addresses
to create automatically, and a list of secondary
private IP addresses to assign to the interface,
separated by ":", in the form ":INDEX:SUBNET:[DESCRIPT
ION]:[PRIV_IP]:[GROUP1,GROUP2,...]:[true|false]:[SEC_I
P_COUNT|:SEC_IP1,SEC_IP2,...]". You cannot specify
both of the latter two. This option may be used
multiple times. Each adds another network interface.
- -p IPROFILE, --iam-profile IPROFILE
-
name or ARN of the IAM instance profile to associate
with the new instance(s)
- --ebs-optimized
-
optimize the new instance(s) for EBS I/O
- --show-empty-fields
-
show empty values as "(nil)"
- -U URL, --url URL
-
compute service endpoint URL
- --region USER@REGION
-
region and/or user names to search when looking up
config file data
-
-I KEY_ID, --access-key-id KEY_ID
-
-S KEY, --secret-key KEY
-
--security-token TOKEN
- --debug
-
- show debugging output
- --debugger
-
launch interactive debugger on error
- --version
-
show the program's version and exit
- -h, --help
-
show this help message and exit