1EUCA-RUN-INSTANCES(1) User Commands EUCA-RUN-INSTANCES(1)
2
6 euca-run-instances - Launch instances of a machine image
7
9 euca-run-instances [-n MIN[-MAX]] [-g GROUP] [-k KEYPAIR]
10 [-d DATA | --user-data-force DATA | -f FILE]
12 [--addressing {public,private}] [-t INSTANCETYPE] [-z ZONE]
13 [--kernel KERNEL] [--ramdisk RAMDISK] [-b DEVICE=MAPPED] [-m]
14 [--disable-api-termination] [--instance-initiated-shut‐
15 down-behavior {stop,terminate}] [--placement-group PLGROUP]
16 [--tenancy {default,dedicated}] [--client-token TOKEN] [-s SUB‐
17 NET] [--associate-public-ip-address ASSOCIATE_PUBLIC_IP_ADDRESS]
18 [--private-ip-address ADDRESS] [--secondary-address ADDRESS |
19 --secondary-count COUNT] [-a INTERFACE] [-p IPROFILE]
20 [--ebs-optimized] [--show-empty-fields] [-U URL] [--region
21 USER@REGION] [-I KEY_ID] [-S KEY] [--security-token TOKEN]
22 [--debug] [--debugger] [--version] [-h] IMAGE
23
25 Launch instances of a machine image
26 positional arguments:
28 IMAGE ID of the image to instantiate (required)
29 optional arguments:
31 -n MIN[-MAX], --instance-count MIN[-MAX]
32 number of instances to launch. If this number of instances can‐
33 not be launched, no instances will launch. If specified as a
34 range (min-max), the server will attempt to launch the maximum
35 number, but no fewer than the minimum number.
36 -g GROUP, --group GROUP
38 security group(s) in which to launch the instances
39 -k KEYPAIR, --key KEYPAIR
41 name of the key pair to use
42 -d DATA, --user-data DATA
44 user data to make available to instances in this reservation
45 --user-data-force DATA
47 same as -d/--user-data, but without checking if a file by that
48 name exists first
49 -f FILE, --user-data-file FILE
51 file containing user data to make available to the instances in
52 this reservation
53 --addressing {public,private}
55 [Eucalyptus only, non-VPC only] addressing scheme to launch the
56 instance with. Use "private" to run an instance with no public
57 address.
58 -t INSTANCETYPE, --instance-type INSTANCETYPE
60 type of instance to launch
61 -z ZONE, --availability-zone ZONE
63 --kernel KERNEL
65 ID of the kernel to launch the instance(s) with
66 --ramdisk RAMDISK
68 ID of the ramdisk to launch the instance(s) with
69 -b DEVICE=MAPPED, --block-device-mapping DEVICE=MAPPED
71 define a block device mapping for the instances, in the form
72 DEVICE=MAPPED, where "MAPPED" is "none", "ephemeral(0-3)", or
73 "[SNAPID]:[GiB]:[true|false]:[standard|VOLTYPE[:IOPS]]"
74 -m, --monitor
76 enable detailed monitoring for the instance(s)
77 --disable-api-termination
79 prevent API users from terminating the instance(s)
80 --instance-initiated-shutdown-behavior {stop,terminate}
82 whether to "stop" (default) or terminate EBS instances when they
83 shut down
84 --placement-group PLGROUP
86 name of a placement group to launch into
87 --tenancy {default,dedicated}
89 [VPC only] "dedicated" to run on single-tenant hardware
90 --client-token TOKEN
92 unique identifier to ensure request idempotency
93 -s SUBNET, --subnet SUBNET
95 [VPC only] subnet to create the instance's network interface in
96 --associate-public-ip-address ASSOCIATE_PUBLIC_IP_ADDRESS
98 [VPC only] whether or not to assign a public address to the
99 instance's network interface
100 --private-ip-address ADDRESS
102 [VPC only] assign a specific primary private IP address to an
103 instance's interface
104 --secondary-address ADDRESS, --secondary-private-ip-address ADDRESS
106 [VPC only] assign a specific secondary private IP address to an
107 instance's network interface. Use this option multiple times to
108 add additional addresses.
109 --secondary-count COUNT, --secondary-private-ip-address-count COUNT
111 [VPC only] automatically assign a specific number of secondary
112 private IP addresses to an instance's network interface
113 -a INTERFACE, --network-interface INTERFACE
115 [VPC only] add a network interface to the new instance. If the
116 interface already exists, supply its ID and a numeric index for
117 it, separated by ":", in the form "eni-NNNNNNNN:INDEX". To cre‐
118 ate a new interface, supply a numeric index and subnet ID for
119 it, along with (in order) an optional description, a primary
120 private IP address, a list of security group IDs to associate
121 with the interface, whether to delete the interface upon
122 instance termination ("true" or "false"), a number of secondary
123 private IP addresses to create automatically, and a list of sec‐
124 ondary private IP addresses to assign to the interface, sepa‐
125 rated by ":", in the form ":INDEX:SUBNET:[DESCRIPT
126 ION]:[PRIV_IP]:[GROUP1,GROUP2,...]:[true|false]:[SEC_I
127 P_COUNT|:SEC_IP1,SEC_IP2,...]". You cannot specify both of the
128 latter two. This option may be used multiple times. Each adds
129 another network interface.
130 -p IPROFILE, --iam-profile IPROFILE
132 name or ARN of the IAM instance profile to associate with the
133 new instance(s)
134 --ebs-optimized
136 optimize the new instance(s) for EBS I/O
137 --show-empty-fields
139 show empty values as "(nil)"
140 -U URL, --url URL
142 compute service endpoint URL
143 --region USER@REGION
145 region and/or user names to search when looking up config file
146 data
147 -I KEY_ID, --access-key-id KEY_ID
149 -S KEY, --secret-key KEY
151 --security-token TOKEN
153 --debug
155 show debugging output
156 --debugger
158 launch interactive debugger on error
159 --version
161 show the program's version and exit
162 -h, --help
164 show this help message and exit
165euca2ools 3.4 December 2016 EUCA-RUN-INSTANCES(1)