Provided by: ec2-api-tools_184.108.40.206-0ubuntu1_all
ec2-request-spot-instances - Create a spot instance request
ec2rsi ([ec2-request-spot-instances]) ec2rsi [GENERAL OPTIONS] AMI [SPECIFIC OPTIONS]
Any command option/parameter may be passed a value of '-' to indicate that values for that option should be read from stdin.
Creates a spot instance request.
-K, --private-key KEY Specify KEY as the private key to use. Defaults to the value of the EC2_PRIVATE_KEY environment variable (if set). Overrides the default. -C, --cert CERT Specify CERT as the X509 certificate to use. Defaults to the value of the EC2_CERT environment variable (if set). Overrides the default. -U, --url URL Specify URL as the web service URL to use. Defaults to the value of 'https://ec2.amazonaws.com' (us-east-1) or to that of the EC2_URL environment variable (if set). Overrides the default. --region REGION Specify REGION as the web service region to use. This option will override the URL specified by the "-U URL" option and EC2_URL environment variable. -v, --verbose Verbose output. -?, --help Display this help. -H, --headers Display column headers. --debug Display additional debugging information. --show-empty-fields Indicate empty fields. --hide-tags Do not display tags for tagged resources. --connection-timeout TIMEOUT Specify a connection timeout TIMEOUT (in seconds). --request-timeout TIMEOUT Specify a request timeout TIMEOUT (in seconds).
-b, --block-device-mapping MAPPING Defines a block device mapping for the instance(s), in the form '<device>=<block-device>', where 'block-device' can be one of the following: - 'none': indicates that a block device that would be exposed at the specified device should be suppressed. For example: '/dev/sdb=none' - 'ephemeral[0-3]': indicates that the Amazon EC2 ephemeral store (instance local storage) should be exposed at the specified device. For example: '/dev/sdc=ephemeral0'. - '[<snapshot-id>][:<size>[:<delete-on-termination>]]': indicates that an Amazon EBS volume, created from the specified Amazon EBS snapshot, should be exposed at the specified device. The following combinations are supported: - '<snapshot-id>': the ID of an Amazon EBS snapshot, which must be owned by or restorable by the caller. May be left out if a <size> is specified, creating an empty Amazon EBS volume of the specified size. - '<size>': the size (GiBs) of the Amazon EBS volume to be created. If a snapshot was specified, this may not be smaller than the size of the snapshot itself. - '<delete-on-termination>': indicates whether the Amazon EBS volume should be deleted on instance termination. If not specified, this will default to 'true' and the volume will be deleted. For example: '/dev/sdb=snap-7eb96d16' '/dev/sdc=snap-7eb96d16:80:false' '/dev/sdd=:120' See the latest Developer's Guide for further information. -d, --user-data DATA Specifies the user data to be made available to the instance(s) in this reservation. -f, --user-data-file DATA-FILE Specifies the file containing user data to be made available to the instance(s) in this reservation. -g, --group GROUP [--group GROUP...] Specifies the security group (or groups if specified multiple times) within which the instance(s) should be run. Determines the ingress firewall rules that will be applied to the launched instances. Defaults to the user's default group if not supplied. -k, --key KEY-PAIR Specifies the key pair to use when launching the instance(s). -m, --monitor Enables monitoring of the specified instance(s). -n, --instance-count COUNT The maximum number of spot instances to launch. -p, --price PRICE Specifies the maximum hourly price for any spot instance launched to fulfill the request. -r, --type REQUEST Specified the spot instance request type; either 'one-time' or 'persistent'. -s, --subnet SUBNET The ID of the Amazon VPC subnet in which to launch the instance(s). -t, --instance-type TYPE Specifies the type of instance to be launched. Refer to the latest Developer's Guide for valid values. -z, --availability-zone ZONE Specifies the availability zone to launch the instance(s) in. Run the 'ec2-describe-availability-zones' command for a list of values, and see the latest Developer's Guide for their meanings. --addressing ADDRESSING Specifies the addressing type to use for the instance(s). Refer to the latest Developer's Guide for valid values. --availability-zone-group GROUP Specifies the spot instance availability zone group. --placement-group GROUP_NAME Specifies the placement group into which the instances should be launched. --kernel KERNEL Specifies the ID of the kernel to launch the instance(s) with. --launch-group GROUP Specifies the spot instance launch group. --ramdisk RAMDISK Specifies the ID of the ramdisk to launch the instance(s) with. --valid-from VALIDFROM The date and time after which the spot instance reuqest will be considered for fulfillment; specified in the format 'yyyy-MM-ddTHH:mm:ss'. --valid-until VALIDUNTIL The date and time after which the spot instance request will expire and no longer be considered for fulfillment; specified in the format 'yyyy-MM-ddTHH:mm:ss'.