/AWS1/CL_EC2FLEETLAUNCHTMPLO00

Describes overrides for a launch template.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_instancetype TYPE /AWS1/EC2INSTANCETYPE /AWS1/EC2INSTANCETYPE

The instance type.

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

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

iv_maxprice TYPE /AWS1/EC2STRING /AWS1/EC2STRING

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.

iv_subnetid TYPE /AWS1/EC2SUBNETID /AWS1/EC2SUBNETID

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.

iv_availabilityzone TYPE /AWS1/EC2AVAILABILITYZONENAME /AWS1/EC2AVAILABILITYZONENAME

The Availability Zone in which to launch the instances. For example, us-east-2a.

Either AvailabilityZone or AvailabilityZoneId must be specified in the request, but not both.

iv_weightedcapacity TYPE /AWS1/RT_DOUBLE_AS_STRING /AWS1/RT_DOUBLE_AS_STRING

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.

iv_priority TYPE /AWS1/RT_DOUBLE_AS_STRING /AWS1/RT_DOUBLE_AS_STRING

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.

io_placement TYPE REF TO /AWS1/CL_EC2PLACEMENT /AWS1/CL_EC2PLACEMENT

The location where the instance launched, if applicable.

it_blockdevicemappings TYPE /AWS1/CL_EC2FLEETBLKDEVMAPREQ=>TT_FLEETBLOCKDEVICEMAPREQLIST TT_FLEETBLOCKDEVICEMAPREQLIST

The block device mappings, which define the EBS volumes and instance store volumes to attach to the instance at launch.

Supported only for fleets of type instant.

For more information, see Block device mappings for volumes on Amazon EC2 instances in the Amazon EC2 User Guide.

io_instancerequirements TYPE REF TO /AWS1/CL_EC2INSTREQUIREMENTS00 /AWS1/CL_EC2INSTREQUIREMENTS00

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.

iv_imageid TYPE /AWS1/EC2STRING /AWS1/EC2STRING

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.

iv_availabilityzoneid TYPE /AWS1/EC2AVAILABILITYZONEID /AWS1/EC2AVAILABILITYZONEID

The ID of the Availability Zone in which to launch the instances. For example, use2-az1.

Either AvailabilityZone or AvailabilityZoneId must be specified in the request, but not both.

---

Queryable Attributes

InstanceType

The instance type.

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

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

Accessible with the following methods

Method	Description
GET_INSTANCETYPE()	Getter for INSTANCETYPE, with configurable default
ASK_INSTANCETYPE()	Getter for INSTANCETYPE w/ exceptions if field has no value
HAS_INSTANCETYPE()	Determine if INSTANCETYPE has a value

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.

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.

Accessible with the following methods

Method	Description
GET_MAXPRICE()	Getter for MAXPRICE, with configurable default
ASK_MAXPRICE()	Getter for MAXPRICE w/ exceptions if field has no value
HAS_MAXPRICE()	Determine if MAXPRICE has a value

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.

Accessible with the following methods

Method	Description
GET_SUBNETID()	Getter for SUBNETID, with configurable default
ASK_SUBNETID()	Getter for SUBNETID w/ exceptions if field has no value
HAS_SUBNETID()	Determine if SUBNETID has a value

AvailabilityZone

The Availability Zone in which to launch the instances. For example, us-east-2a.

Either AvailabilityZone or AvailabilityZoneId must be specified in the request, but not both.

Accessible with the following methods

Method	Description
GET_AVAILABILITYZONE()	Getter for AVAILABILITYZONE, with configurable default
ASK_AVAILABILITYZONE()	Getter for AVAILABILITYZONE w/ exceptions if field has no va
HAS_AVAILABILITYZONE()	Determine if AVAILABILITYZONE has a value

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.

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.

Accessible with the following methods

Method	Description
GET_WEIGHTEDCAPACITY()	Getter for WEIGHTEDCAPACITY, with configurable default
ASK_WEIGHTEDCAPACITY()	Getter for WEIGHTEDCAPACITY w/ exceptions if field has no va
STR_WEIGHTEDCAPACITY()	String format for WEIGHTEDCAPACITY, with configurable defaul
HAS_WEIGHTEDCAPACITY()	Determine if WEIGHTEDCAPACITY has a value

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.

Accessible with the following methods

Method	Description
GET_PRIORITY()	Getter for PRIORITY, with configurable default
ASK_PRIORITY()	Getter for PRIORITY w/ exceptions if field has no value
STR_PRIORITY()	String format for PRIORITY, with configurable default
HAS_PRIORITY()	Determine if PRIORITY has a value

Placement

The location where the instance launched, if applicable.

Accessible with the following methods

Method	Description
GET_PLACEMENT()	Getter for PLACEMENT

BlockDeviceMappings

The block device mappings, which define the EBS volumes and instance store volumes to attach to the instance at launch.

Supported only for fleets of type instant.

For more information, see Block device mappings for volumes on Amazon EC2 instances in the Amazon EC2 User Guide.

Accessible with the following methods

Method	Description
GET_BLOCKDEVICEMAPPINGS()	Getter for BLOCKDEVICEMAPPINGS, with configurable default
ASK_BLOCKDEVICEMAPPINGS()	Getter for BLOCKDEVICEMAPPINGS w/ exceptions if field has no
HAS_BLOCKDEVICEMAPPINGS()	Determine if BLOCKDEVICEMAPPINGS has a value

InstanceRequirements

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.

Accessible with the following methods

Method	Description
GET_INSTANCEREQUIREMENTS()	Getter for INSTANCEREQUIREMENTS

ImageId

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.

Accessible with the following methods

Method	Description
GET_IMAGEID()	Getter for IMAGEID, with configurable default
ASK_IMAGEID()	Getter for IMAGEID w/ exceptions if field has no value
HAS_IMAGEID()	Determine if IMAGEID has a value

AvailabilityZoneId

The ID of the Availability Zone in which to launch the instances. For example, use2-az1.

Either AvailabilityZone or AvailabilityZoneId must be specified in the request, but not both.

Accessible with the following methods

Method	Description
GET_AVAILABILITYZONEID()	Getter for AVAILABILITYZONEID, with configurable default
ASK_AVAILABILITYZONEID()	Getter for AVAILABILITYZONEID w/ exceptions if field has no
HAS_AVAILABILITYZONEID()	Determine if AVAILABILITYZONEID has a value

Public Local Types In This Class

Internal table types, representing arrays and maps of this class, are defined as local types:

TT_FLEETLAUNCHTMPLOVERRIDESL00

TYPES TT_FLEETLAUNCHTMPLOVERRIDESL00 TYPE STANDARD TABLE OF REF TO /AWS1/CL_EC2FLEETLAUNCHTMPLO00 WITH DEFAULT KEY
.