Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Contact Us
Online Help
Domain Status
Man Pages

Virtual Servers

Topology Map

Server Agreement
Year 2038

USA Flag



Man Pages

Manual Reference Pages  -  EUCA-RUN-INSTANCES (1)


euca-run-instances - Launch instances of a machine image




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] [--associate-public-ip-address ASSOCIATE_PUBLIC_IP_ADDRESS] [--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


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
  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, non-VPC only] addressing scheme to launch the instance with. Use "private" to run an instance with no public address.
  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)
  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
--associate-public-ip-address ASSOCIATE_PUBLIC_IP_ADDRESS
  [VPC only] assign a public address to the instance’s network interface
--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)
  optimize the new instance(s) for EBS I/O
  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
  launch interactive debugger on error
  show the program’s version and exit
-h, --help show this help message and exit
Search for    or go to Top of page |  Section 1 |  Main Index

euca2ools 3.3.0 EUCA-RUN-INSTANCES (1) October 2015

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.