Menu
Amazon Elastic Compute Cloud
API Reference (API Version 2016-11-15)

SpotFleetLaunchSpecification

Describes the launch specification for one or more Spot Instances.

Contents

AddressingType (request), addressingType (response)

Deprecated.

Type: String

Required: No

BlockDeviceMappings (request), blockDeviceMapping (response)

One or more block device mapping entries. You can't specify both a snapshot ID and an encryption value. This is because only blank volumes can be encrypted on creation. If a snapshot is the basis for a volume, it is not blank and its encryption status is used for the volume encryption status.

Type: Array of BlockDeviceMapping objects

Required: No

EbsOptimized (request), ebsOptimized (response)

Indicates whether the instances are optimized for EBS I/O. This optimization provides dedicated throughput to Amazon EBS and an optimized configuration stack to provide optimal EBS I/O performance. This optimization isn't available with all instance types. Additional usage charges apply when using an EBS Optimized instance.

Default: false

Type: Boolean

Required: No

SecurityGroups (request), groupSet (response)

One or more security groups. When requesting instances in a VPC, you must specify the IDs of the security groups. When requesting instances in EC2-Classic, you can specify the names or the IDs of the security groups.

Type: Array of GroupIdentifier objects

Required: No

IamInstanceProfile (request), iamInstanceProfile (response)

The IAM instance profile.

Type: IamInstanceProfileSpecification object

Required: No

ImageId (request), imageId (response)

The ID of the AMI.

Type: String

Required: No

InstanceType (request), instanceType (response)

The instance type.

Type: String

Valid Values: t1.micro | t2.nano | t2.micro | t2.small | t2.medium | t2.large | t2.xlarge | t2.2xlarge | m1.small | m1.medium | m1.large | m1.xlarge | m3.medium | m3.large | m3.xlarge | m3.2xlarge | m4.large | m4.xlarge | m4.2xlarge | m4.4xlarge | m4.10xlarge | m4.16xlarge | m2.xlarge | m2.2xlarge | m2.4xlarge | cr1.8xlarge | r3.large | r3.xlarge | r3.2xlarge | r3.4xlarge | r3.8xlarge | r4.large | r4.xlarge | r4.2xlarge | r4.4xlarge | r4.8xlarge | r4.16xlarge | x1.16xlarge | x1.32xlarge | x1e.xlarge | x1e.2xlarge | x1e.4xlarge | x1e.8xlarge | x1e.16xlarge | x1e.32xlarge | i2.xlarge | i2.2xlarge | i2.4xlarge | i2.8xlarge | i3.large | i3.xlarge | i3.2xlarge | i3.4xlarge | i3.8xlarge | i3.16xlarge | hi1.4xlarge | hs1.8xlarge | c1.medium | c1.xlarge | c3.large | c3.xlarge | c3.2xlarge | c3.4xlarge | c3.8xlarge | c4.large | c4.xlarge | c4.2xlarge | c4.4xlarge | c4.8xlarge | c5.large | c5.xlarge | c5.2xlarge | c5.4xlarge | c5.9xlarge | c5.18xlarge | cc1.4xlarge | cc2.8xlarge | g2.2xlarge | g2.8xlarge | g3.4xlarge | g3.8xlarge | g3.16xlarge | cg1.4xlarge | p2.xlarge | p2.8xlarge | p2.16xlarge | p3.2xlarge | p3.8xlarge | p3.16xlarge | d2.xlarge | d2.2xlarge | d2.4xlarge | d2.8xlarge | f1.2xlarge | f1.16xlarge | m5.large | m5.xlarge | m5.2xlarge | m5.4xlarge | m5.12xlarge | m5.24xlarge | h1.2xlarge | h1.4xlarge | h1.8xlarge | h1.16xlarge

Required: No

KernelId (request), kernelId (response)

The ID of the kernel.

Type: String

Required: No

KeyName (request), keyName (response)

The name of the key pair.

Type: String

Required: No

Monitoring (request), monitoring (response)

Enable or disable monitoring for the instances.

Type: SpotFleetMonitoring object

Required: No

NetworkInterfaces (request), networkInterfaceSet (response)

One or more network interfaces. If you specify a network interface, you must specify subnet IDs and security group IDs using the network interface.

Type: Array of InstanceNetworkInterfaceSpecification objects

Required: No

Placement (request), placement (response)

The placement information.

Type: SpotPlacement object

Required: No

RamdiskId (request), ramdiskId (response)

The ID of the RAM disk.

Type: String

Required: No

SpotPrice (request), spotPrice (response)

The maximum price per unit hour that you are willing to pay for a Spot Instance. If this value is not specified, the default is the Spot price specified for the fleet. To determine the Spot price per unit hour, divide the Spot price by the value of WeightedCapacity.

Type: String

Required: No

SubnetId (request), subnetId (response)

The ID of the subnet in which to launch the instances. To specify multiple subnets, separate them using commas; for example, "subnet-a61dafcf, subnet-65ea5f08".

Type: String

Required: No

TagSpecifications (request), tagSpecificationSet (response)

The tags to apply during creation.

Type: Array of SpotFleetTagSpecification objects

Required: No

UserData (request), userData (response)

The user data to make available to the instances. If you are using an AWS SDK or command line tool, Base64-encoding is performed for you, and you can load the text from a file. Otherwise, you must provide Base64-encoded text.

Type: String

Required: No

WeightedCapacity (request), weightedCapacity (response)

The number of units provided by the specified instance type. These are the same units that you chose to set the target capacity in terms (instances or a performance characteristic such as vCPUs, memory, or I/O).

If the target capacity divided by this value is not a whole number, we round the number of instances to the next whole number. If this value is not specified, the default is 1.

Type: Double

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: