GSP
Quick Navigator

Search Site

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

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


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

NAME

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

CONTENTS

Synopsis
Description

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