Class: Aws::EC2::Types::FleetLaunchTemplateOverridesRequest

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb

Overview

Describes overrides for a launch template.

See Also:

Constant Summary collapse

SENSITIVE = 
[]

Instance Attribute Summary collapse

Instance Attribute Details

#availability_zone ⇒ String

The Availability Zone in which to launch the instances.

Returns:

  • (String) 


36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#block_device_mappings ⇒ Array<Types::FleetBlockDeviceMappingRequest>

The block device mapping, which defines the EBS volumes and instance store volumes to attach to the instance at launch. For more information, see Block device mappings for volumes on Amazon EC2 instances in the Amazon EC2 User Guide.

To override a block device mapping specified in the launch template:

  • Specify the exact same DeviceName here as specified in the launch template.

  • Only specify the parameters you want to change.

  • Any parameters you don't specify here will keep their original launch template values.

To add a new block device mapping:

  • Specify a DeviceName that doesn't exist in the launch template.

  • Specify all desired parameters here.

Returns:



36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#image_id ⇒ String

The ID of the AMI in the format ami-17characters00000.

Alternatively, you can specify a Systems Manager parameter, using one of the following formats. The Systems Manager parameter will resolve to an AMI ID on launch.

To reference a public parameter:

  • resolve:ssm:public-parameter

^

To reference a parameter stored in the same account:

  • resolve:ssm:parameter-name

  • resolve:ssm:parameter-name:version-number

  • resolve:ssm:parameter-name:label

To reference a parameter shared from another Amazon Web Services account:

  • resolve:ssm:parameter-ARN

  • resolve:ssm:parameter-ARN:version-number

  • resolve:ssm:parameter-ARN:label

For more information, see Use a Systems Manager parameter instead of an AMI ID in the Amazon EC2 User Guide.

This parameter is only available for fleets of type instant. For fleets of type maintain and request, you must specify the AMI ID in the launch template.

Returns:

  • (String) 


36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#instance_requirements ⇒ Types::InstanceRequirementsRequest

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

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

Returns:



36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#instance_type ⇒ String

The instance type.

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

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

Returns:

  • (String) 


36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#max_price ⇒ String

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.

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.

Returns:

  • (String) 


36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#placement ⇒ Types::Placement

The location where the instance launched, if applicable.

Returns:



36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#priority ⇒ Float

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.

Returns:

  • (Float) 


36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#subnet_id ⇒ String

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.

Returns:

  • (String) 


36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end

#weighted_capacity ⇒ Float

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.

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.

Returns:

  • (Float) 


36404
36405
36406
36407
36408
36409
36410
36411
36412
36413
36414
36415
36416
36417
 
# File 'gems/aws-sdk-ec2/lib/aws-sdk-ec2/types.rb', line 36404

class FleetLaunchTemplateOverridesRequest < Struct.new(
  :instance_type,
  :max_price,
  :subnet_id,
  :availability_zone,
  :weighted_capacity,
  :priority,
  :placement,
  :block_device_mappings,
  :instance_requirements,
  :image_id)
  SENSITIVE = []
  include Aws::Structure
end