/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 specifyInstanceRequirements
.
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.
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 typeinstant
can have only one subnet ID.
IV_AVAILABILITYZONE
TYPE /AWS1/EC2STRING
/AWS1/EC2STRING
¶
The Availability Zone in which to launch the instances.
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
andprice-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 requestedTargetCapacity
, 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 toprioritized
, EC2 Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity.If the Spot
AllocationStrategy
is set tocapacity-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.
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 specifyInstanceType
.
IV_IMAGEID
TYPE /AWS1/EC2IMAGEID
/AWS1/EC2IMAGEID
¶
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 typemaintain
andrequest
, you must specify the AMI ID in the launch template.
Queryable Attributes¶
InstanceType¶
The instance type.
mac1.metal
is not supported as a launch template override.If you specify
InstanceType
, you can't specifyInstanceRequirements
.
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.
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 typeinstant
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.
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
andprice-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 requestedTargetCapacity
, 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 toprioritized
, EC2 Fleet uses priority to determine which launch template override to use first in fulfilling On-Demand capacity.If the Spot
AllocationStrategy
is set tocapacity-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 |
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 specifyInstanceType
.
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 typemaintain
andrequest
, 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 |
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
.