xenial (1) euca-run-instances.1.gz

NAME

       euca-run-instances - 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-private-ip-address         ADDRESS         |
       --secondary-private-ip-address-count   COUNT]   [-a   INTERFACE]    [-p    IPROFILE]    [--ebs-optimized]
       [--show-empty-fields]  [--region  USER@REGION  |  -U  URL]  [-I  KEY_ID]  [-S KEY] [--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]:[SIZE]:[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-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-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_IP_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)"

       --region USER@REGION
              name of the region and/or user in config files to use to connect to the service

       -U URL, --url URL
              compute service endpoint URL

       -I KEY_ID, --access-key-id KEY_ID

       -S KEY, --secret-key KEY

       --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