bionic (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]      [--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

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,  non-VPC  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

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

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