This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.
AWS::ECS::CapacityProvider InstanceLaunchTemplate
The launch template configuration for Amazon ECS Managed Instances. This defines how Amazon ECS launches Amazon EC2 instances, including the instance profile for your tasks, network and storage configuration, capacity options, and instance requirements for flexible instance type selection.
Syntax
To declare this entity in your Amazon CloudFormation template, use the following syntax:
JSON
{ "Ec2InstanceProfileArn" :
String
, "InstanceRequirements" :InstanceRequirementsRequest
, "Monitoring" :String
, "NetworkConfiguration" :ManagedInstancesNetworkConfiguration
, "StorageConfiguration" :ManagedInstancesStorageConfiguration
}
YAML
Ec2InstanceProfileArn:
String
InstanceRequirements:InstanceRequirementsRequest
Monitoring:String
NetworkConfiguration:ManagedInstancesNetworkConfiguration
StorageConfiguration:ManagedInstancesStorageConfiguration
Properties
Ec2InstanceProfileArn
-
The Amazon Resource Name (ARN) of the instance profile that Amazon ECS applies to Amazon ECS Managed Instances. This instance profile must include the necessary permissions for your tasks to access Amazon services and resources.
For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide.
Required: Yes
Type: String
Update requires: No interruption
InstanceRequirements
-
The instance requirements. You can specify:
-
The instance types
-
Instance requirements such as vCPU count, memory, network performance, and accelerator specifications
Amazon ECS automatically selects the instances that match the specified criteria.
Required: No
Type: InstanceRequirementsRequest
Update requires: No interruption
-
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.
Required: No
Type: String
Allowed values:
BASIC | DETAILED
Update requires: No interruption
NetworkConfiguration
-
The network configuration for Amazon ECS Managed Instances. This specifies the subnets and security groups that instances use for network connectivity.
Required: Yes
Type: ManagedInstancesNetworkConfiguration
Update requires: No interruption
StorageConfiguration
-
The storage configuration for Amazon ECS Managed Instances. This defines the root volume size and type for the instances.
Required: No
Type: ManagedInstancesStorageConfiguration
Update requires: No interruption