AWS::EC2::EC2Fleet FleetLaunchTemplateOverridesRequest

Specifies overrides for a launch template for an EC2 Fleet.

FleetLaunchTemplateOverridesRequest is a property of the FleetLaunchTemplateConfigRequest property type.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON


{
  "AvailabilityZone" : String,
  "InstanceRequirements" : InstanceRequirementsRequest,
  "InstanceType" : String,
  "MaxPrice" : String,
  "Placement" : Placement,
  "Priority" : Number,
  "SubnetId" : String,
  "WeightedCapacity" : Number
}

YAML


  AvailabilityZone: String
  InstanceRequirements: 
    InstanceRequirementsRequest
  InstanceType: String
  MaxPrice: String
  Placement: 
    Placement
  Priority: Number
  SubnetId: String
  WeightedCapacity: Number

Properties

AvailabilityZone

The Availability Zone in which to launch the instances.

Required: No

Type: String

Update requires: Replacement

InstanceRequirements

The attributes for the instance types. When you specify instance attributes, Amazon EC2 will identify instance types with those attributes.

Note

If you specify InstanceRequirements, you can't specify InstanceType.

Required: No

Type: InstanceRequirementsRequest

Update requires: Replacement

InstanceType

The instance type.

mac1.metal is not supported as a launch template override.

Note

If you specify InstanceType, you can't specify InstanceRequirements.

Required: No

Type: String

Update requires: Replacement

MaxPrice

The maximum price per unit hour that you are willing to pay for a Spot Instance. We do not recommend using this parameter because it can lead to increased interruptions. If you do not specify this parameter, you will pay the current Spot price.

Important

If you specify a maximum price, your instances will be interrupted more frequently than if you do not specify this parameter.

If you specify a maximum price, it must be more than USD $0.001. Specifying a value below USD $0.001 will result in an InvalidParameterValue error message.

Required: No

Type: String

Update requires: Replacement

Placement

The location where the instance launched, if applicable.

Required: No

Type: Placement

Update requires: Replacement

Priority

The priority for the launch template override. The highest priority is launched first.

If the On-Demand AllocationStrategy is set to prioritized, EC2 Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity.

If the Spot AllocationStrategy is set to capacity-optimized-prioritized, EC2 Fleet uses priority on a best-effort basis to determine which launch template override to use in fulfilling Spot capacity, but optimizes for capacity first.

Valid values are whole numbers starting at 0. The lower the number, the higher the priority. If no number is set, the launch template override has the lowest priority. You can set the same priority for different launch template overrides.

Required: No

Type: Number

Update requires: Replacement

SubnetId

The IDs of the subnets in which to launch the instances. Separate multiple subnet IDs using commas (for example, subnet-1234abcdeexample1, subnet-0987cdef6example2). A request of type instant can have only one subnet ID.

Required: No

Type: String

Update requires: Replacement

WeightedCapacity

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 of 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, Amazon EC2 rounds the number of instances to the next whole number. If this value is not specified, the default is 1.

Note

When specifying weights, the price used in the lowest-price and price-capacity-optimized allocation strategies is per unit hour (where the instance price is divided by the specified weight). However, if all the specified weights are above the requested TargetCapacity, resulting in only 1 instance being launched, the price used is per instance hour.

Required: No

Type: Number

Update requires: Replacement

AWS::EC2::EC2Fleet FleetLaunchTemplateOverridesRequest

Syntax

JSON

YAML

Properties

Note

Note

Important

Note

See also