Skip to content

/AWS1/CL_ECSINSTLAUNCHTMPLUPD

The updated launch template configuration for Amazon ECS Managed Instances. You can modify the instance profile, network configuration, storage settings, and instance requirements. Changes apply to new instances launched after the update.

For more information, see Store instance launch parameters in Amazon EC2 launch templates in the Amazon EC2 User Guide.

CONSTRUCTOR

IMPORTING

Optional arguments:

iv_ec2instanceprofilearn TYPE /AWS1/ECSSTRING /AWS1/ECSSTRING

The updated Amazon Resource Name (ARN) of the instance profile. The new instance profile must have the necessary permissions for your tasks.

For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide.

io_networkconfiguration TYPE REF TO /AWS1/CL_ECSMANAGEDINSNETCONF /AWS1/CL_ECSMANAGEDINSNETCONF

The updated network configuration for Amazon ECS Managed Instances. Changes to subnets and security groups affect new instances launched after the update.

io_storageconfiguration TYPE REF TO /AWS1/CL_ECSMANAGEDINSSTRGCONF /AWS1/CL_ECSMANAGEDINSSTRGCONF

The updated storage configuration for Amazon ECS Managed Instances. Changes to storage settings apply to new instances launched after the update.

iv_instmetadatatagspropag TYPE /AWS1/ECSBOXEDBOOLEAN /AWS1/ECSBOXEDBOOLEAN

Determines whether tags are propagated to the instance metadata service (IMDS) for Amazon EC2 instances launched by the Managed Instances capacity provider. When enabled, all tags associated with the instance are available through the instance metadata service. When disabled, tags are not propagated to IMDS.

Disable this setting if your tags contain characters that are not compatible with IMDS, such as /. IMDS requires tag keys to match the pattern [0-9a-zA-Z-_+=,.@:]{1,255}.

The default value is true.

For more information, see Work with instance tags in instance metadata in the Amazon EC2 User Guide.

io_localstorageconfiguration TYPE REF TO /AWS1/CL_ECSMGDINSLOCALSTRGC00 /AWS1/CL_ECSMGDINSLOCALSTRGC00

The updated local storage configuration for Amazon ECS Managed Instances. Changes to local storage settings apply to new instances launched after the update.

iv_monitoring TYPE /AWS1/ECSMANAGEDINSTSMONOPTS /AWS1/ECSMANAGEDINSTSMONOPTS

CloudWatch provides two categories of monitoring: basic monitoring and detailed monitoring. By default, your managed instance is configured for basic monitoring. You can optionally enable detailed monitoring to help you more quickly identify and act on operational issues. You can enable or turn off detailed monitoring at launch or when the managed instance is running or stopped. For more information, see Detailed monitoring for Amazon ECS Managed Instances in the Amazon ECS Developer Guide.

io_instancerequirements TYPE REF TO /AWS1/CL_ECSINSTREQSREQUEST /AWS1/CL_ECSINSTREQSREQUEST

The updated instance requirements for attribute-based instance type selection. Changes to instance requirements affect which instance types Amazon ECS selects for new instances.

io_capacityreservations TYPE REF TO /AWS1/CL_ECSCAPRESVREQUEST /AWS1/CL_ECSCAPRESVREQUEST

The updated capacity reservations specifications for Amazon ECS Managed Instances. Changes to capacity reservations settings apply to new instances launched after the update.


Queryable Attributes

ec2InstanceProfileArn

The updated Amazon Resource Name (ARN) of the instance profile. The new instance profile must have the necessary permissions for your tasks.

For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide.

Accessible with the following methods

Method Description
GET_EC2INSTANCEPROFILEARN() Getter for EC2INSTANCEPROFILEARN, with configurable default
ASK_EC2INSTANCEPROFILEARN() Getter for EC2INSTANCEPROFILEARN w/ exceptions if field has
HAS_EC2INSTANCEPROFILEARN() Determine if EC2INSTANCEPROFILEARN has a value

networkConfiguration

The updated network configuration for Amazon ECS Managed Instances. Changes to subnets and security groups affect new instances launched after the update.

Accessible with the following methods

Method Description
GET_NETWORKCONFIGURATION() Getter for NETWORKCONFIGURATION

storageConfiguration

The updated storage configuration for Amazon ECS Managed Instances. Changes to storage settings apply to new instances launched after the update.

Accessible with the following methods

Method Description
GET_STORAGECONFIGURATION() Getter for STORAGECONFIGURATION

instanceMetadataTagsPropagation

Determines whether tags are propagated to the instance metadata service (IMDS) for Amazon EC2 instances launched by the Managed Instances capacity provider. When enabled, all tags associated with the instance are available through the instance metadata service. When disabled, tags are not propagated to IMDS.

Disable this setting if your tags contain characters that are not compatible with IMDS, such as /. IMDS requires tag keys to match the pattern [0-9a-zA-Z-_+=,.@:]{1,255}.

The default value is true.

For more information, see Work with instance tags in instance metadata in the Amazon EC2 User Guide.

Accessible with the following methods

Method Description
GET_INSTMETADATATAGSPROPAG() Getter for INSTANCEMETADATATAGSPROPAG, with configurable def
ASK_INSTMETADATATAGSPROPAG() Getter for INSTANCEMETADATATAGSPROPAG w/ exceptions if field
HAS_INSTMETADATATAGSPROPAG() Determine if INSTANCEMETADATATAGSPROPAG has a value

localStorageConfiguration

The updated local storage configuration for Amazon ECS Managed Instances. Changes to local storage settings apply to new instances launched after the update.

Accessible with the following methods

Method Description
GET_LOCALSTORAGECONF() Getter for LOCALSTORAGECONFIGURATION

monitoring

CloudWatch provides two categories of monitoring: basic monitoring and detailed monitoring. By default, your managed instance is configured for basic monitoring. You can optionally enable detailed monitoring to help you more quickly identify and act on operational issues. You can enable or turn off detailed monitoring at launch or when the managed instance is running or stopped. For more information, see Detailed monitoring for Amazon ECS Managed Instances in the Amazon ECS Developer Guide.

Accessible with the following methods

Method Description
GET_MONITORING() Getter for MONITORING, with configurable default
ASK_MONITORING() Getter for MONITORING w/ exceptions if field has no value
HAS_MONITORING() Determine if MONITORING has a value

instanceRequirements

The updated instance requirements for attribute-based instance type selection. Changes to instance requirements affect which instance types Amazon ECS selects for new instances.

Accessible with the following methods

Method Description
GET_INSTANCEREQUIREMENTS() Getter for INSTANCEREQUIREMENTS

capacityReservations

The updated capacity reservations specifications for Amazon ECS Managed Instances. Changes to capacity reservations settings apply to new instances launched after the update.

Accessible with the following methods

Method Description
GET_CAPACITYRESERVATIONS() Getter for CAPACITYRESERVATIONS