We recommend new projects start with resources from the AWS provider.
aws-native.ecs.getCapacityProvider
We recommend new projects start with resources from the AWS provider.
Resource Type definition for AWS::ECS::CapacityProvider.
Using getCapacityProvider
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getCapacityProvider(args: GetCapacityProviderArgs, opts?: InvokeOptions): Promise<GetCapacityProviderResult>
function getCapacityProviderOutput(args: GetCapacityProviderOutputArgs, opts?: InvokeOptions): Output<GetCapacityProviderResult>def get_capacity_provider(name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetCapacityProviderResult
def get_capacity_provider_output(name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetCapacityProviderResult]func LookupCapacityProvider(ctx *Context, args *LookupCapacityProviderArgs, opts ...InvokeOption) (*LookupCapacityProviderResult, error)
func LookupCapacityProviderOutput(ctx *Context, args *LookupCapacityProviderOutputArgs, opts ...InvokeOption) LookupCapacityProviderResultOutput> Note: This function is named LookupCapacityProvider in the Go SDK.
public static class GetCapacityProvider
{
public static Task<GetCapacityProviderResult> InvokeAsync(GetCapacityProviderArgs args, InvokeOptions? opts = null)
public static Output<GetCapacityProviderResult> Invoke(GetCapacityProviderInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetCapacityProviderResult> getCapacityProvider(GetCapacityProviderArgs args, InvokeOptions options)
public static Output<GetCapacityProviderResult> getCapacityProvider(GetCapacityProviderArgs args, InvokeOptions options)
fn::invoke:
function: aws-native:ecs:getCapacityProvider
arguments:
# arguments dictionaryThe following arguments are supported:
- Name string
- The name of the capacity provider. If a name is specified, it cannot start with
aws,ecs, orfargate. If no name is specified, a default name in theCFNStackName-CFNResourceName-RandomStringformat is used.
- Name string
- The name of the capacity provider. If a name is specified, it cannot start with
aws,ecs, orfargate. If no name is specified, a default name in theCFNStackName-CFNResourceName-RandomStringformat is used.
- name String
- The name of the capacity provider. If a name is specified, it cannot start with
aws,ecs, orfargate. If no name is specified, a default name in theCFNStackName-CFNResourceName-RandomStringformat is used.
- name string
- The name of the capacity provider. If a name is specified, it cannot start with
aws,ecs, orfargate. If no name is specified, a default name in theCFNStackName-CFNResourceName-RandomStringformat is used.
- name str
- The name of the capacity provider. If a name is specified, it cannot start with
aws,ecs, orfargate. If no name is specified, a default name in theCFNStackName-CFNResourceName-RandomStringformat is used.
- name String
- The name of the capacity provider. If a name is specified, it cannot start with
aws,ecs, orfargate. If no name is specified, a default name in theCFNStackName-CFNResourceName-RandomStringformat is used.
getCapacityProvider Result
The following output properties are available:
- Auto
Scaling Pulumi.Group Provider Aws Native. Ecs. Outputs. Capacity Provider Auto Scaling Group Provider - The Auto Scaling group settings for the capacity provider.
- Managed
Instances Pulumi.Provider Aws Native. Ecs. Outputs. Capacity Provider Managed Instances Provider - The configuration for the Amazon ECS Managed Instances provider. This includes the infrastructure role, the launch template configuration, and tag propagation settings.
-
List<Pulumi.
Aws Native. Outputs. Tag> The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.
The following basic restrictions apply to tags:
- Maximum number of tags per resource - 50
- For each resource, each tag key must be unique, and each tag key can have only one value.
- Maximum key length - 128 Unicode characters in UTF-8
- Maximum value length - 256 Unicode characters in UTF-8
- If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
- Tag keys and values are case-sensitive.
- Do not use
aws:,AWS:, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
- Auto
Scaling CapacityGroup Provider Provider Auto Scaling Group Provider - The Auto Scaling group settings for the capacity provider.
- Managed
Instances CapacityProvider Provider Managed Instances Provider - The configuration for the Amazon ECS Managed Instances provider. This includes the infrastructure role, the launch template configuration, and tag propagation settings.
- Tag
The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.
The following basic restrictions apply to tags:
- Maximum number of tags per resource - 50
- For each resource, each tag key must be unique, and each tag key can have only one value.
- Maximum key length - 128 Unicode characters in UTF-8
- Maximum value length - 256 Unicode characters in UTF-8
- If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
- Tag keys and values are case-sensitive.
- Do not use
aws:,AWS:, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
- auto
Scaling CapacityGroup Provider Provider Auto Scaling Group Provider - The Auto Scaling group settings for the capacity provider.
- managed
Instances CapacityProvider Provider Managed Instances Provider - The configuration for the Amazon ECS Managed Instances provider. This includes the infrastructure role, the launch template configuration, and tag propagation settings.
- List<Tag>
The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.
The following basic restrictions apply to tags:
- Maximum number of tags per resource - 50
- For each resource, each tag key must be unique, and each tag key can have only one value.
- Maximum key length - 128 Unicode characters in UTF-8
- Maximum value length - 256 Unicode characters in UTF-8
- If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
- Tag keys and values are case-sensitive.
- Do not use
aws:,AWS:, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
- auto
Scaling CapacityGroup Provider Provider Auto Scaling Group Provider - The Auto Scaling group settings for the capacity provider.
- managed
Instances CapacityProvider Provider Managed Instances Provider - The configuration for the Amazon ECS Managed Instances provider. This includes the infrastructure role, the launch template configuration, and tag propagation settings.
- Tag[]
The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.
The following basic restrictions apply to tags:
- Maximum number of tags per resource - 50
- For each resource, each tag key must be unique, and each tag key can have only one value.
- Maximum key length - 128 Unicode characters in UTF-8
- Maximum value length - 256 Unicode characters in UTF-8
- If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
- Tag keys and values are case-sensitive.
- Do not use
aws:,AWS:, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
- auto_
scaling_ Capacitygroup_ provider Provider Auto Scaling Group Provider - The Auto Scaling group settings for the capacity provider.
- managed_
instances_ Capacityprovider Provider Managed Instances Provider - The configuration for the Amazon ECS Managed Instances provider. This includes the infrastructure role, the launch template configuration, and tag propagation settings.
- Sequence[root_Tag]
The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.
The following basic restrictions apply to tags:
- Maximum number of tags per resource - 50
- For each resource, each tag key must be unique, and each tag key can have only one value.
- Maximum key length - 128 Unicode characters in UTF-8
- Maximum value length - 256 Unicode characters in UTF-8
- If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
- Tag keys and values are case-sensitive.
- Do not use
aws:,AWS:, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
- auto
Scaling Property MapGroup Provider - The Auto Scaling group settings for the capacity provider.
- managed
Instances Property MapProvider - The configuration for the Amazon ECS Managed Instances provider. This includes the infrastructure role, the launch template configuration, and tag propagation settings.
- List<Property Map>
The metadata that you apply to the capacity provider to help you categorize and organize it. Each tag consists of a key and an optional value. You define both.
The following basic restrictions apply to tags:
- Maximum number of tags per resource - 50
- For each resource, each tag key must be unique, and each tag key can have only one value.
- Maximum key length - 128 Unicode characters in UTF-8
- Maximum value length - 256 Unicode characters in UTF-8
- If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : / @.
- Tag keys and values are case-sensitive.
- Do not use
aws:,AWS:, or any upper or lowercase combination of such as a prefix for either keys or values as it is reserved for AWS use. You cannot edit or delete tag keys or values with this prefix. Tags with this prefix do not count against your tags per resource limit.
Supporting Types
CapacityProviderAcceleratorCountRequest
CapacityProviderAcceleratorTotalMemoryMiBRequest
CapacityProviderAutoScalingGroupProvider
- Auto
Scaling stringGroup Arn - The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
- Managed
Draining Pulumi.Aws Native. Ecs. Capacity Provider Auto Scaling Group Provider Managed Draining - The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
- Managed
Scaling Pulumi.Aws Native. Ecs. Inputs. Capacity Provider Managed Scaling - The managed scaling settings for the Auto Scaling group capacity provider.
- Managed
Termination Pulumi.Protection Aws Native. Ecs. Capacity Provider Auto Scaling Group Provider Managed Termination Protection The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.
When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.
When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .
When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.
- Auto
Scaling stringGroup Arn - The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
- Managed
Draining CapacityProvider Auto Scaling Group Provider Managed Draining - The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
- Managed
Scaling CapacityProvider Managed Scaling - The managed scaling settings for the Auto Scaling group capacity provider.
- Managed
Termination CapacityProtection Provider Auto Scaling Group Provider Managed Termination Protection The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.
When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.
When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .
When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.
- auto
Scaling StringGroup Arn - The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
- managed
Draining CapacityProvider Auto Scaling Group Provider Managed Draining - The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
- managed
Scaling CapacityProvider Managed Scaling - The managed scaling settings for the Auto Scaling group capacity provider.
- managed
Termination CapacityProtection Provider Auto Scaling Group Provider Managed Termination Protection The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.
When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.
When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .
When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.
- auto
Scaling stringGroup Arn - The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
- managed
Draining CapacityProvider Auto Scaling Group Provider Managed Draining - The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
- managed
Scaling CapacityProvider Managed Scaling - The managed scaling settings for the Auto Scaling group capacity provider.
- managed
Termination CapacityProtection Provider Auto Scaling Group Provider Managed Termination Protection The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.
When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.
When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .
When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.
- auto_
scaling_ strgroup_ arn - The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
- managed_
draining CapacityProvider Auto Scaling Group Provider Managed Draining - The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
- managed_
scaling CapacityProvider Managed Scaling - The managed scaling settings for the Auto Scaling group capacity provider.
- managed_
termination_ Capacityprotection Provider Auto Scaling Group Provider Managed Termination Protection The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.
When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.
When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .
When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.
- auto
Scaling StringGroup Arn - The Amazon Resource Name (ARN) that identifies the Auto Scaling group, or the Auto Scaling group name.
- managed
Draining "DISABLED" | "ENABLED" - The managed draining option for the Auto Scaling group capacity provider. When you enable this, Amazon ECS manages and gracefully drains the EC2 container instances that are in the Auto Scaling group capacity provider.
- managed
Scaling Property Map - The managed scaling settings for the Auto Scaling group capacity provider.
- managed
Termination "DISABLED" | "ENABLED"Protection The managed termination protection setting to use for the Auto Scaling group capacity provider. This determines whether the Auto Scaling group has managed termination protection. The default is off.
When using managed termination protection, managed scaling must also be used otherwise managed termination protection doesn't work.
When managed termination protection is on, Amazon ECS prevents the Amazon EC2 instances in an Auto Scaling group that contain tasks from being terminated during a scale-in action. The Auto Scaling group and each instance in the Auto Scaling group must have instance protection from scale-in actions on as well. For more information, see Instance Protection in the AWS Auto Scaling User Guide .
When managed termination protection is off, your Amazon EC2 instances aren't protected from termination when the Auto Scaling group scales in.
CapacityProviderAutoScalingGroupProviderManagedDraining
CapacityProviderAutoScalingGroupProviderManagedTerminationProtection
CapacityProviderBaselineEbsBandwidthMbpsRequest
CapacityProviderInstanceLaunchTemplate
- Ec2Instance
Profile stringArn 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 AWS services and resources.
For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide .
- Network
Configuration Pulumi.Aws Native. Ecs. Inputs. Capacity Provider Managed Instances Network Configuration - The network configuration for Amazon ECS Managed Instances. This specifies the subnets and security groups that instances use for network connectivity.
- Instance
Requirements Pulumi.Aws Native. Ecs. Inputs. Capacity Provider Instance Requirements Request 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.
- Monitoring
Pulumi.
Aws Native. Ecs. Capacity Provider Managed Instances Monitoring Options - 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.
- Storage
Configuration Pulumi.Aws Native. Ecs. Inputs. Capacity Provider Managed Instances Storage Configuration - The storage configuration for Amazon ECS Managed Instances. This defines the root volume size and type for the instances.
- Ec2Instance
Profile stringArn 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 AWS services and resources.
For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide .
- Network
Configuration CapacityProvider Managed Instances Network Configuration - The network configuration for Amazon ECS Managed Instances. This specifies the subnets and security groups that instances use for network connectivity.
- Instance
Requirements CapacityProvider Instance Requirements Request 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.
- Monitoring
Capacity
Provider Managed Instances Monitoring Options - 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.
- Storage
Configuration CapacityProvider Managed Instances Storage Configuration - The storage configuration for Amazon ECS Managed Instances. This defines the root volume size and type for the instances.
- ec2Instance
Profile StringArn 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 AWS services and resources.
For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide .
- network
Configuration CapacityProvider Managed Instances Network Configuration - The network configuration for Amazon ECS Managed Instances. This specifies the subnets and security groups that instances use for network connectivity.
- instance
Requirements CapacityProvider Instance Requirements Request 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.
- monitoring
Capacity
Provider Managed Instances Monitoring Options - 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.
- storage
Configuration CapacityProvider Managed Instances Storage Configuration - The storage configuration for Amazon ECS Managed Instances. This defines the root volume size and type for the instances.
- ec2Instance
Profile stringArn 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 AWS services and resources.
For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide .
- network
Configuration CapacityProvider Managed Instances Network Configuration - The network configuration for Amazon ECS Managed Instances. This specifies the subnets and security groups that instances use for network connectivity.
- instance
Requirements CapacityProvider Instance Requirements Request 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.
- monitoring
Capacity
Provider Managed Instances Monitoring Options - 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.
- storage
Configuration CapacityProvider Managed Instances Storage Configuration - The storage configuration for Amazon ECS Managed Instances. This defines the root volume size and type for the instances.
- ec2_
instance_ strprofile_ arn 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 AWS services and resources.
For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide .
- network_
configuration CapacityProvider Managed Instances Network Configuration - The network configuration for Amazon ECS Managed Instances. This specifies the subnets and security groups that instances use for network connectivity.
- instance_
requirements CapacityProvider Instance Requirements Request 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.
- monitoring
Capacity
Provider Managed Instances Monitoring Options - 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.
- storage_
configuration CapacityProvider Managed Instances Storage Configuration - The storage configuration for Amazon ECS Managed Instances. This defines the root volume size and type for the instances.
- ec2Instance
Profile StringArn 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 AWS services and resources.
For more information, see Amazon ECS instance profile for Managed Instances in the Amazon ECS Developer Guide .
- network
Configuration Property Map - The network configuration for Amazon ECS Managed Instances. This specifies the subnets and security groups that instances use for network connectivity.
- instance
Requirements Property Map 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.
- monitoring "BASIC" | "DETAILED"
- 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.
- storage
Configuration Property Map - The storage configuration for Amazon ECS Managed Instances. This defines the root volume size and type for the instances.
CapacityProviderInstanceRequirementsRequest
- Memory
Mi Pulumi.B Aws Native. Ecs. Inputs. Capacity Provider Memory Mi BRequest - The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.
- VCpu
Count Pulumi.Aws Native. Ecs. Inputs. Capacity Provider VCpu Count Range Request - The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.
- Accelerator
Count Pulumi.Aws Native. Ecs. Inputs. Capacity Provider Accelerator Count Request - The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.
- Accelerator
Manufacturers List<Pulumi.Aws Native. Ecs. Capacity Provider Instance Requirements Request Accelerator Manufacturers Item> - The accelerator manufacturers to include. You can specify
nvidia,amd,amazon-web-services, orxilinxdepending on your accelerator requirements. - Accelerator
Names List<Pulumi.Aws Native. Ecs. Capacity Provider Instance Requirements Request Accelerator Names Item> - The specific accelerator names to include. For example, you can specify
a100,v100,k80, or other specific accelerator models. - Accelerator
Total Pulumi.Memory Mi B Aws Native. Ecs. Inputs. Capacity Provider Accelerator Total Memory Mi BRequest - The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.
- Accelerator
Types List<Pulumi.Aws Native. Ecs. Capacity Provider Instance Requirements Request Accelerator Types Item> - The accelerator types to include. You can specify
gpufor graphics processing units,fpgafor field programmable gate arrays, orinferencefor machine learning inference accelerators. - Allowed
Instance List<string>Types - The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.
- Bare
Metal Pulumi.Aws Native. Ecs. Capacity Provider Instance Requirements Request Bare Metal - Indicates whether to include bare metal instance types. Set to
includedto allow bare metal instances,excludedto exclude them, orrequiredto use only bare metal instances. - Baseline
Ebs Pulumi.Bandwidth Mbps Aws Native. Ecs. Inputs. Capacity Provider Baseline Ebs Bandwidth Mbps Request - The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.
- Burstable
Performance Pulumi.Aws Native. Ecs. Capacity Provider Instance Requirements Request Burstable Performance - Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to
includedto allow burstable instances,excludedto exclude them, orrequiredto use only burstable instances. - Cpu
Manufacturers List<Pulumi.Aws Native. Ecs. Capacity Provider Instance Requirements Request Cpu Manufacturers Item> - The CPU manufacturers to include or exclude. You can specify
intel,amd, oramazon-web-servicesto control which CPU types are used for your workloads. - Excluded
Instance List<string>Types - The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.
- Instance
Generations List<Pulumi.Aws Native. Ecs. Capacity Provider Instance Requirements Request Instance Generations Item> - The instance generations to include. You can specify
currentto use the latest generation instances, orpreviousto include previous generation instances for cost optimization. - Local
Storage Pulumi.Aws Native. Ecs. Capacity Provider Instance Requirements Request Local Storage - Indicates whether to include instance types with local storage. Set to
includedto allow local storage,excludedto exclude it, orrequiredto use only instances with local storage. - Local
Storage List<Pulumi.Types Aws Native. Ecs. Capacity Provider Instance Requirements Request Local Storage Types Item> - The local storage types to include. You can specify
hddfor hard disk drives,ssdfor solid state drives, or both. - Max
Spot intPrice As Percentage Of Optimal On Demand Price - The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.
- Memory
Gi Pulumi.BPer VCpu Aws Native. Ecs. Inputs. Capacity Provider Memory Gi BPer VCpu Request - The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.
- Network
Bandwidth Pulumi.Gbps Aws Native. Ecs. Inputs. Capacity Provider Network Bandwidth Gbps Request - The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.
- Network
Interface Pulumi.Count Aws Native. Ecs. Inputs. Capacity Provider Network Interface Count Request - The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.
- On
Demand intMax Price Percentage Over Lowest Price - The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.
- Require
Hibernate boolSupport - Indicates whether the instance types must support hibernation. When set to
true, only instance types that support hibernation are selected. - Spot
Max intPrice Percentage Over Lowest Price - The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.
- Total
Local Pulumi.Storage Gb Aws Native. Ecs. Inputs. Capacity Provider Total Local Storage Gb Request - The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.
- Memory
Mi CapacityB Provider Memory Mi BRequest - The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.
- VCpu
Count CapacityProvider VCpu Count Range Request - The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.
- Accelerator
Count CapacityProvider Accelerator Count Request - The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.
- Accelerator
Manufacturers []CapacityProvider Instance Requirements Request Accelerator Manufacturers Item - The accelerator manufacturers to include. You can specify
nvidia,amd,amazon-web-services, orxilinxdepending on your accelerator requirements. - Accelerator
Names []CapacityProvider Instance Requirements Request Accelerator Names Item - The specific accelerator names to include. For example, you can specify
a100,v100,k80, or other specific accelerator models. - Accelerator
Total CapacityMemory Mi B Provider Accelerator Total Memory Mi BRequest - The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.
- Accelerator
Types []CapacityProvider Instance Requirements Request Accelerator Types Item - The accelerator types to include. You can specify
gpufor graphics processing units,fpgafor field programmable gate arrays, orinferencefor machine learning inference accelerators. - Allowed
Instance []stringTypes - The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.
- Bare
Metal CapacityProvider Instance Requirements Request Bare Metal - Indicates whether to include bare metal instance types. Set to
includedto allow bare metal instances,excludedto exclude them, orrequiredto use only bare metal instances. - Baseline
Ebs CapacityBandwidth Mbps Provider Baseline Ebs Bandwidth Mbps Request - The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.
- Burstable
Performance CapacityProvider Instance Requirements Request Burstable Performance - Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to
includedto allow burstable instances,excludedto exclude them, orrequiredto use only burstable instances. - Cpu
Manufacturers []CapacityProvider Instance Requirements Request Cpu Manufacturers Item - The CPU manufacturers to include or exclude. You can specify
intel,amd, oramazon-web-servicesto control which CPU types are used for your workloads. - Excluded
Instance []stringTypes - The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.
- Instance
Generations []CapacityProvider Instance Requirements Request Instance Generations Item - The instance generations to include. You can specify
currentto use the latest generation instances, orpreviousto include previous generation instances for cost optimization. - Local
Storage CapacityProvider Instance Requirements Request Local Storage - Indicates whether to include instance types with local storage. Set to
includedto allow local storage,excludedto exclude it, orrequiredto use only instances with local storage. - Local
Storage []CapacityTypes Provider Instance Requirements Request Local Storage Types Item - The local storage types to include. You can specify
hddfor hard disk drives,ssdfor solid state drives, or both. - Max
Spot intPrice As Percentage Of Optimal On Demand Price - The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.
- Memory
Gi CapacityBPer VCpu Provider Memory Gi BPer VCpu Request - The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.
- Network
Bandwidth CapacityGbps Provider Network Bandwidth Gbps Request - The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.
- Network
Interface CapacityCount Provider Network Interface Count Request - The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.
- On
Demand intMax Price Percentage Over Lowest Price - The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.
- Require
Hibernate boolSupport - Indicates whether the instance types must support hibernation. When set to
true, only instance types that support hibernation are selected. - Spot
Max intPrice Percentage Over Lowest Price - The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.
- Total
Local CapacityStorage Gb Provider Total Local Storage Gb Request - The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.
- memory
Mi CapacityB Provider Memory Mi BRequest - The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.
- v
Cpu CapacityCount Provider VCpu Count Range Request - The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.
- accelerator
Count CapacityProvider Accelerator Count Request - The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.
- accelerator
Manufacturers List<CapacityProvider Instance Requirements Request Accelerator Manufacturers Item> - The accelerator manufacturers to include. You can specify
nvidia,amd,amazon-web-services, orxilinxdepending on your accelerator requirements. - accelerator
Names List<CapacityProvider Instance Requirements Request Accelerator Names Item> - The specific accelerator names to include. For example, you can specify
a100,v100,k80, or other specific accelerator models. - accelerator
Total CapacityMemory Mi B Provider Accelerator Total Memory Mi BRequest - The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.
- accelerator
Types List<CapacityProvider Instance Requirements Request Accelerator Types Item> - The accelerator types to include. You can specify
gpufor graphics processing units,fpgafor field programmable gate arrays, orinferencefor machine learning inference accelerators. - allowed
Instance List<String>Types - The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.
- bare
Metal CapacityProvider Instance Requirements Request Bare Metal - Indicates whether to include bare metal instance types. Set to
includedto allow bare metal instances,excludedto exclude them, orrequiredto use only bare metal instances. - baseline
Ebs CapacityBandwidth Mbps Provider Baseline Ebs Bandwidth Mbps Request - The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.
- burstable
Performance CapacityProvider Instance Requirements Request Burstable Performance - Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to
includedto allow burstable instances,excludedto exclude them, orrequiredto use only burstable instances. - cpu
Manufacturers List<CapacityProvider Instance Requirements Request Cpu Manufacturers Item> - The CPU manufacturers to include or exclude. You can specify
intel,amd, oramazon-web-servicesto control which CPU types are used for your workloads. - excluded
Instance List<String>Types - The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.
- instance
Generations List<CapacityProvider Instance Requirements Request Instance Generations Item> - The instance generations to include. You can specify
currentto use the latest generation instances, orpreviousto include previous generation instances for cost optimization. - local
Storage CapacityProvider Instance Requirements Request Local Storage - Indicates whether to include instance types with local storage. Set to
includedto allow local storage,excludedto exclude it, orrequiredto use only instances with local storage. - local
Storage List<CapacityTypes Provider Instance Requirements Request Local Storage Types Item> - The local storage types to include. You can specify
hddfor hard disk drives,ssdfor solid state drives, or both. - max
Spot IntegerPrice As Percentage Of Optimal On Demand Price - The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.
- memory
Gi CapacityBPer VCpu Provider Memory Gi BPer VCpu Request - The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.
- network
Bandwidth CapacityGbps Provider Network Bandwidth Gbps Request - The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.
- network
Interface CapacityCount Provider Network Interface Count Request - The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.
- on
Demand IntegerMax Price Percentage Over Lowest Price - The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.
- require
Hibernate BooleanSupport - Indicates whether the instance types must support hibernation. When set to
true, only instance types that support hibernation are selected. - spot
Max IntegerPrice Percentage Over Lowest Price - The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.
- total
Local CapacityStorage Gb Provider Total Local Storage Gb Request - The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.
- memory
Mi CapacityB Provider Memory Mi BRequest - The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.
- v
Cpu CapacityCount Provider VCpu Count Range Request - The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.
- accelerator
Count CapacityProvider Accelerator Count Request - The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.
- accelerator
Manufacturers CapacityProvider Instance Requirements Request Accelerator Manufacturers Item[] - The accelerator manufacturers to include. You can specify
nvidia,amd,amazon-web-services, orxilinxdepending on your accelerator requirements. - accelerator
Names CapacityProvider Instance Requirements Request Accelerator Names Item[] - The specific accelerator names to include. For example, you can specify
a100,v100,k80, or other specific accelerator models. - accelerator
Total CapacityMemory Mi B Provider Accelerator Total Memory Mi BRequest - The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.
- accelerator
Types CapacityProvider Instance Requirements Request Accelerator Types Item[] - The accelerator types to include. You can specify
gpufor graphics processing units,fpgafor field programmable gate arrays, orinferencefor machine learning inference accelerators. - allowed
Instance string[]Types - The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.
- bare
Metal CapacityProvider Instance Requirements Request Bare Metal - Indicates whether to include bare metal instance types. Set to
includedto allow bare metal instances,excludedto exclude them, orrequiredto use only bare metal instances. - baseline
Ebs CapacityBandwidth Mbps Provider Baseline Ebs Bandwidth Mbps Request - The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.
- burstable
Performance CapacityProvider Instance Requirements Request Burstable Performance - Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to
includedto allow burstable instances,excludedto exclude them, orrequiredto use only burstable instances. - cpu
Manufacturers CapacityProvider Instance Requirements Request Cpu Manufacturers Item[] - The CPU manufacturers to include or exclude. You can specify
intel,amd, oramazon-web-servicesto control which CPU types are used for your workloads. - excluded
Instance string[]Types - The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.
- instance
Generations CapacityProvider Instance Requirements Request Instance Generations Item[] - The instance generations to include. You can specify
currentto use the latest generation instances, orpreviousto include previous generation instances for cost optimization. - local
Storage CapacityProvider Instance Requirements Request Local Storage - Indicates whether to include instance types with local storage. Set to
includedto allow local storage,excludedto exclude it, orrequiredto use only instances with local storage. - local
Storage CapacityTypes Provider Instance Requirements Request Local Storage Types Item[] - The local storage types to include. You can specify
hddfor hard disk drives,ssdfor solid state drives, or both. - max
Spot numberPrice As Percentage Of Optimal On Demand Price - The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.
- memory
Gi CapacityBPer VCpu Provider Memory Gi BPer VCpu Request - The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.
- network
Bandwidth CapacityGbps Provider Network Bandwidth Gbps Request - The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.
- network
Interface CapacityCount Provider Network Interface Count Request - The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.
- on
Demand numberMax Price Percentage Over Lowest Price - The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.
- require
Hibernate booleanSupport - Indicates whether the instance types must support hibernation. When set to
true, only instance types that support hibernation are selected. - spot
Max numberPrice Percentage Over Lowest Price - The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.
- total
Local CapacityStorage Gb Provider Total Local Storage Gb Request - The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.
- memory_
mi_ Capacityb Provider Memory Mi BRequest - The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.
- v_
cpu_ Capacitycount Provider VCpu Count Range Request - The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.
- accelerator_
count CapacityProvider Accelerator Count Request - The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.
- accelerator_
manufacturers Sequence[CapacityProvider Instance Requirements Request Accelerator Manufacturers Item] - The accelerator manufacturers to include. You can specify
nvidia,amd,amazon-web-services, orxilinxdepending on your accelerator requirements. - accelerator_
names Sequence[CapacityProvider Instance Requirements Request Accelerator Names Item] - The specific accelerator names to include. For example, you can specify
a100,v100,k80, or other specific accelerator models. - accelerator_
total_ Capacitymemory_ mi_ b Provider Accelerator Total Memory Mi BRequest - The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.
- accelerator_
types Sequence[CapacityProvider Instance Requirements Request Accelerator Types Item] - The accelerator types to include. You can specify
gpufor graphics processing units,fpgafor field programmable gate arrays, orinferencefor machine learning inference accelerators. - allowed_
instance_ Sequence[str]types - The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.
- bare_
metal CapacityProvider Instance Requirements Request Bare Metal - Indicates whether to include bare metal instance types. Set to
includedto allow bare metal instances,excludedto exclude them, orrequiredto use only bare metal instances. - baseline_
ebs_ Capacitybandwidth_ mbps Provider Baseline Ebs Bandwidth Mbps Request - The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.
- burstable_
performance CapacityProvider Instance Requirements Request Burstable Performance - Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to
includedto allow burstable instances,excludedto exclude them, orrequiredto use only burstable instances. - cpu_
manufacturers Sequence[CapacityProvider Instance Requirements Request Cpu Manufacturers Item] - The CPU manufacturers to include or exclude. You can specify
intel,amd, oramazon-web-servicesto control which CPU types are used for your workloads. - excluded_
instance_ Sequence[str]types - The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.
- instance_
generations Sequence[CapacityProvider Instance Requirements Request Instance Generations Item] - The instance generations to include. You can specify
currentto use the latest generation instances, orpreviousto include previous generation instances for cost optimization. - local_
storage CapacityProvider Instance Requirements Request Local Storage - Indicates whether to include instance types with local storage. Set to
includedto allow local storage,excludedto exclude it, orrequiredto use only instances with local storage. - local_
storage_ Sequence[Capacitytypes Provider Instance Requirements Request Local Storage Types Item] - The local storage types to include. You can specify
hddfor hard disk drives,ssdfor solid state drives, or both. - max_
spot_ intprice_ as_ percentage_ of_ optimal_ on_ demand_ price - The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.
- memory_
gi_ Capacityb_ per_ v_ cpu Provider Memory Gi BPer VCpu Request - The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.
- network_
bandwidth_ Capacitygbps Provider Network Bandwidth Gbps Request - The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.
- network_
interface_ Capacitycount Provider Network Interface Count Request - The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.
- on_
demand_ intmax_ price_ percentage_ over_ lowest_ price - The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.
- require_
hibernate_ boolsupport - Indicates whether the instance types must support hibernation. When set to
true, only instance types that support hibernation are selected. - spot_
max_ intprice_ percentage_ over_ lowest_ price - The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.
- total_
local_ Capacitystorage_ gb Provider Total Local Storage Gb Request - The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.
- memory
Mi Property MapB - The minimum and maximum amount of memory in mebibytes (MiB) for the instance types. Amazon ECS selects instance types that have memory within this range.
- v
Cpu Property MapCount - The minimum and maximum number of vCPUs for the instance types. Amazon ECS selects instance types that have vCPU counts within this range.
- accelerator
Count Property Map - The minimum and maximum number of accelerators for the instance types. This is used when you need instances with specific numbers of GPUs or other accelerators.
- accelerator
Manufacturers List<"amazon-web-services" | "amd" | "habana" | "nvidia" | "xilinx"> - The accelerator manufacturers to include. You can specify
nvidia,amd,amazon-web-services, orxilinxdepending on your accelerator requirements. - accelerator
Names List<"a10g" | "a100" | "h100" | "inferentia" | "k520" | "k80" | "m60" | "radeon-pro-v520" | "t4" | "t4g" | "vu9p" | "v100"> - The specific accelerator names to include. For example, you can specify
a100,v100,k80, or other specific accelerator models. - accelerator
Total Property MapMemory Mi B - The minimum and maximum total accelerator memory in mebibytes (MiB). This is important for GPU workloads that require specific amounts of video memory.
- accelerator
Types List<"gpu" | "fpga" | "inference"> - The accelerator types to include. You can specify
gpufor graphics processing units,fpgafor field programmable gate arrays, orinferencefor machine learning inference accelerators. - allowed
Instance List<String>Types - The instance types to include in the selection. When specified, Amazon ECS only considers these instance types, subject to the other requirements specified.
- bare
Metal "included" | "required" | "excluded" - Indicates whether to include bare metal instance types. Set to
includedto allow bare metal instances,excludedto exclude them, orrequiredto use only bare metal instances. - baseline
Ebs Property MapBandwidth Mbps - The minimum and maximum baseline Amazon EBS bandwidth in megabits per second (Mbps). This is important for workloads with high storage I/O requirements.
- burstable
Performance "included" | "required" | "excluded" - Indicates whether to include burstable performance instance types (T2, T3, T3a, T4g). Set to
includedto allow burstable instances,excludedto exclude them, orrequiredto use only burstable instances. - cpu
Manufacturers List<"intel" | "amd" | "amazon-web-services"> - The CPU manufacturers to include or exclude. You can specify
intel,amd, oramazon-web-servicesto control which CPU types are used for your workloads. - excluded
Instance List<String>Types - The instance types to exclude from selection. Use this to prevent Amazon ECS from selecting specific instance types that may not be suitable for your workloads.
- instance
Generations List<"current" | "previous"> - The instance generations to include. You can specify
currentto use the latest generation instances, orpreviousto include previous generation instances for cost optimization. - local
Storage "included" | "required" | "excluded" - Indicates whether to include instance types with local storage. Set to
includedto allow local storage,excludedto exclude it, orrequiredto use only instances with local storage. - local
Storage List<"hdd" | "ssd">Types - The local storage types to include. You can specify
hddfor hard disk drives,ssdfor solid state drives, or both. - max
Spot NumberPrice As Percentage Of Optimal On Demand Price - The maximum price for Spot instances as a percentage of the optimal On-Demand price. This provides more precise cost control for Spot instance selection.
- memory
Gi Property MapBPer VCpu - The minimum and maximum amount of memory per vCPU in gibibytes (GiB). This helps ensure that instance types have the appropriate memory-to-CPU ratio for your workloads.
- network
Bandwidth Property MapGbps - The minimum and maximum network bandwidth in gigabits per second (Gbps). This is crucial for network-intensive workloads that require high throughput.
- network
Interface Property MapCount - The minimum and maximum number of network interfaces for the instance types. This is useful for workloads that require multiple network interfaces.
- on
Demand NumberMax Price Percentage Over Lowest Price - The price protection threshold for On-Demand Instances, as a percentage higher than an identified On-Demand price. The identified On-Demand price is the price of the lowest priced current generation C, M, or R instance type with your specified attributes. If no current generation C, M, or R instance type matches your attributes, then the identified price is from either the lowest priced current generation instance types or, failing that, the lowest priced previous generation instance types that match your attributes. When Amazon ECS selects instance types with your attributes, we will exclude instance types whose price exceeds your specified threshold.
- require
Hibernate BooleanSupport - Indicates whether the instance types must support hibernation. When set to
true, only instance types that support hibernation are selected. - spot
Max NumberPrice Percentage Over Lowest Price - The maximum price for Spot instances as a percentage over the lowest priced On-Demand instance. This helps control Spot instance costs while maintaining access to capacity.
- total
Local Property MapStorage Gb - The minimum and maximum total local storage in gigabytes (GB) for instance types with local storage.
CapacityProviderInstanceRequirementsRequestAcceleratorManufacturersItem
CapacityProviderInstanceRequirementsRequestAcceleratorNamesItem
CapacityProviderInstanceRequirementsRequestAcceleratorTypesItem
CapacityProviderInstanceRequirementsRequestBareMetal
CapacityProviderInstanceRequirementsRequestBurstablePerformance
CapacityProviderInstanceRequirementsRequestCpuManufacturersItem
CapacityProviderInstanceRequirementsRequestInstanceGenerationsItem
CapacityProviderInstanceRequirementsRequestLocalStorage
CapacityProviderInstanceRequirementsRequestLocalStorageTypesItem
CapacityProviderManagedInstancesMonitoringOptions
CapacityProviderManagedInstancesNetworkConfiguration
- Subnets List<string>
- The list of subnet IDs where Amazon ECS can launch Amazon ECS Managed Instances. Instances are distributed across the specified subnets for high availability. All subnets must be in the same VPC.
- Security
Groups List<string> - The list of security group IDs to apply to Amazon ECS Managed Instances. These security groups control the network traffic allowed to and from the instances.
- Subnets []string
- The list of subnet IDs where Amazon ECS can launch Amazon ECS Managed Instances. Instances are distributed across the specified subnets for high availability. All subnets must be in the same VPC.
- Security
Groups []string - The list of security group IDs to apply to Amazon ECS Managed Instances. These security groups control the network traffic allowed to and from the instances.
- subnets List<String>
- The list of subnet IDs where Amazon ECS can launch Amazon ECS Managed Instances. Instances are distributed across the specified subnets for high availability. All subnets must be in the same VPC.
- security
Groups List<String> - The list of security group IDs to apply to Amazon ECS Managed Instances. These security groups control the network traffic allowed to and from the instances.
- subnets string[]
- The list of subnet IDs where Amazon ECS can launch Amazon ECS Managed Instances. Instances are distributed across the specified subnets for high availability. All subnets must be in the same VPC.
- security
Groups string[] - The list of security group IDs to apply to Amazon ECS Managed Instances. These security groups control the network traffic allowed to and from the instances.
- subnets Sequence[str]
- The list of subnet IDs where Amazon ECS can launch Amazon ECS Managed Instances. Instances are distributed across the specified subnets for high availability. All subnets must be in the same VPC.
- security_
groups Sequence[str] - The list of security group IDs to apply to Amazon ECS Managed Instances. These security groups control the network traffic allowed to and from the instances.
- subnets List<String>
- The list of subnet IDs where Amazon ECS can launch Amazon ECS Managed Instances. Instances are distributed across the specified subnets for high availability. All subnets must be in the same VPC.
- security
Groups List<String> - The list of security group IDs to apply to Amazon ECS Managed Instances. These security groups control the network traffic allowed to and from the instances.
CapacityProviderManagedInstancesProvider
- Infrastructure
Role stringArn The Amazon Resource Name (ARN) of the infrastructure role that Amazon ECS assumes to manage instances. This role must include permissions for Amazon EC2 instance lifecycle management, networking, and any additional AWS services required for your workloads.
For more information, see Amazon ECS infrastructure IAM role in the Amazon ECS Developer Guide .
- Instance
Launch Pulumi.Template Aws Native. Ecs. Inputs. Capacity Provider Instance Launch Template The launch template that defines how Amazon ECS launches Amazon ECS Managed Instances. This includes the instance profile for your tasks, network and storage configuration, and instance requirements that determine which Amazon EC2 instance types can be used.
For more information, see Store instance launch parameters in Amazon EC2 launch templates in the Amazon EC2 User Guide .
-
Pulumi.
Aws Native. Ecs. Capacity Provider Managed Instances Provider Propagate Tags - Determines whether tags from the capacity provider are automatically applied to Amazon ECS Managed Instances. This helps with cost allocation and resource management by ensuring consistent tagging across your infrastructure.
- Infrastructure
Role stringArn The Amazon Resource Name (ARN) of the infrastructure role that Amazon ECS assumes to manage instances. This role must include permissions for Amazon EC2 instance lifecycle management, networking, and any additional AWS services required for your workloads.
For more information, see Amazon ECS infrastructure IAM role in the Amazon ECS Developer Guide .
- Instance
Launch CapacityTemplate Provider Instance Launch Template The launch template that defines how Amazon ECS launches Amazon ECS Managed Instances. This includes the instance profile for your tasks, network and storage configuration, and instance requirements that determine which Amazon EC2 instance types can be used.
For more information, see Store instance launch parameters in Amazon EC2 launch templates in the Amazon EC2 User Guide .
-
Capacity
Provider Managed Instances Provider Propagate Tags - Determines whether tags from the capacity provider are automatically applied to Amazon ECS Managed Instances. This helps with cost allocation and resource management by ensuring consistent tagging across your infrastructure.
- infrastructure
Role StringArn The Amazon Resource Name (ARN) of the infrastructure role that Amazon ECS assumes to manage instances. This role must include permissions for Amazon EC2 instance lifecycle management, networking, and any additional AWS services required for your workloads.
For more information, see Amazon ECS infrastructure IAM role in the Amazon ECS Developer Guide .
- instance
Launch CapacityTemplate Provider Instance Launch Template The launch template that defines how Amazon ECS launches Amazon ECS Managed Instances. This includes the instance profile for your tasks, network and storage configuration, and instance requirements that determine which Amazon EC2 instance types can be used.
For more information, see Store instance launch parameters in Amazon EC2 launch templates in the Amazon EC2 User Guide .
-
Capacity
Provider Managed Instances Provider Propagate Tags - Determines whether tags from the capacity provider are automatically applied to Amazon ECS Managed Instances. This helps with cost allocation and resource management by ensuring consistent tagging across your infrastructure.
- infrastructure
Role stringArn The Amazon Resource Name (ARN) of the infrastructure role that Amazon ECS assumes to manage instances. This role must include permissions for Amazon EC2 instance lifecycle management, networking, and any additional AWS services required for your workloads.
For more information, see Amazon ECS infrastructure IAM role in the Amazon ECS Developer Guide .
- instance
Launch CapacityTemplate Provider Instance Launch Template The launch template that defines how Amazon ECS launches Amazon ECS Managed Instances. This includes the instance profile for your tasks, network and storage configuration, and instance requirements that determine which Amazon EC2 instance types can be used.
For more information, see Store instance launch parameters in Amazon EC2 launch templates in the Amazon EC2 User Guide .
-
Capacity
Provider Managed Instances Provider Propagate Tags - Determines whether tags from the capacity provider are automatically applied to Amazon ECS Managed Instances. This helps with cost allocation and resource management by ensuring consistent tagging across your infrastructure.
- infrastructure_
role_ strarn The Amazon Resource Name (ARN) of the infrastructure role that Amazon ECS assumes to manage instances. This role must include permissions for Amazon EC2 instance lifecycle management, networking, and any additional AWS services required for your workloads.
For more information, see Amazon ECS infrastructure IAM role in the Amazon ECS Developer Guide .
- instance_
launch_ Capacitytemplate Provider Instance Launch Template The launch template that defines how Amazon ECS launches Amazon ECS Managed Instances. This includes the instance profile for your tasks, network and storage configuration, and instance requirements that determine which Amazon EC2 instance types can be used.
For more information, see Store instance launch parameters in Amazon EC2 launch templates in the Amazon EC2 User Guide .
-
Capacity
Provider Managed Instances Provider Propagate Tags - Determines whether tags from the capacity provider are automatically applied to Amazon ECS Managed Instances. This helps with cost allocation and resource management by ensuring consistent tagging across your infrastructure.
- infrastructure
Role StringArn The Amazon Resource Name (ARN) of the infrastructure role that Amazon ECS assumes to manage instances. This role must include permissions for Amazon EC2 instance lifecycle management, networking, and any additional AWS services required for your workloads.
For more information, see Amazon ECS infrastructure IAM role in the Amazon ECS Developer Guide .
- instance
Launch Property MapTemplate The launch template that defines how Amazon ECS launches Amazon ECS Managed Instances. This includes the instance profile for your tasks, network and storage configuration, and instance requirements that determine which Amazon EC2 instance types can be used.
For more information, see Store instance launch parameters in Amazon EC2 launch templates in the Amazon EC2 User Guide .
- "CAPACITY_PROVIDER" | "NONE"
- Determines whether tags from the capacity provider are automatically applied to Amazon ECS Managed Instances. This helps with cost allocation and resource management by ensuring consistent tagging across your infrastructure.
CapacityProviderManagedInstancesProviderPropagateTags
CapacityProviderManagedInstancesStorageConfiguration
- Storage
Size intGi B - The size of the tasks volume.
- Storage
Size intGi B - The size of the tasks volume.
- storage
Size IntegerGi B - The size of the tasks volume.
- storage
Size numberGi B - The size of the tasks volume.
- storage_
size_ intgi_ b - The size of the tasks volume.
- storage
Size NumberGi B - The size of the tasks volume.
CapacityProviderManagedScaling
- Instance
Warmup intPeriod - The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of
300seconds is used. - Maximum
Scaling intStep Size - The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of
10000is used. - Minimum
Scaling intStep Size The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of
1is used.When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.
- Status
Pulumi.
Aws Native. Ecs. Capacity Provider Managed Scaling Status - Determines whether to use managed scaling for the capacity provider.
- Target
Capacity int - The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than
0and less than or equal to100. For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use atargetCapacityof90. The default value of100percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
- Instance
Warmup intPeriod - The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of
300seconds is used. - Maximum
Scaling intStep Size - The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of
10000is used. - Minimum
Scaling intStep Size The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of
1is used.When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.
- Status
Capacity
Provider Managed Scaling Status - Determines whether to use managed scaling for the capacity provider.
- Target
Capacity int - The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than
0and less than or equal to100. For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use atargetCapacityof90. The default value of100percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
- instance
Warmup IntegerPeriod - The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of
300seconds is used. - maximum
Scaling IntegerStep Size - The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of
10000is used. - minimum
Scaling IntegerStep Size The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of
1is used.When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.
- status
Capacity
Provider Managed Scaling Status - Determines whether to use managed scaling for the capacity provider.
- target
Capacity Integer - The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than
0and less than or equal to100. For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use atargetCapacityof90. The default value of100percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
- instance
Warmup numberPeriod - The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of
300seconds is used. - maximum
Scaling numberStep Size - The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of
10000is used. - minimum
Scaling numberStep Size The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of
1is used.When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.
- status
Capacity
Provider Managed Scaling Status - Determines whether to use managed scaling for the capacity provider.
- target
Capacity number - The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than
0and less than or equal to100. For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use atargetCapacityof90. The default value of100percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
- instance_
warmup_ intperiod - The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of
300seconds is used. - maximum_
scaling_ intstep_ size - The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of
10000is used. - minimum_
scaling_ intstep_ size The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of
1is used.When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.
- status
Capacity
Provider Managed Scaling Status - Determines whether to use managed scaling for the capacity provider.
- target_
capacity int - The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than
0and less than or equal to100. For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use atargetCapacityof90. The default value of100percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
- instance
Warmup NumberPeriod - The period of time, in seconds, after a newly launched Amazon EC2 instance can contribute to CloudWatch metrics for Auto Scaling group. If this parameter is omitted, the default value of
300seconds is used. - maximum
Scaling NumberStep Size - The maximum number of Amazon EC2 instances that Amazon ECS will scale out at one time. If this parameter is omitted, the default value of
10000is used. - minimum
Scaling NumberStep Size The minimum number of Amazon EC2 instances that Amazon ECS will scale out at one time. The scale in process is not affected by this parameter If this parameter is omitted, the default value of
1is used.When additional capacity is required, Amazon ECS will scale up the minimum scaling step size even if the actual demand is less than the minimum scaling step size.
- status "DISABLED" | "ENABLED"
- Determines whether to use managed scaling for the capacity provider.
- target
Capacity Number - The target capacity utilization as a percentage for the capacity provider. The specified value must be greater than
0and less than or equal to100. For example, if you want the capacity provider to maintain 10% spare capacity, then that means the utilization is 90%, so use atargetCapacityof90. The default value of100percent results in the Amazon EC2 instances in your Auto Scaling group being completely used.
CapacityProviderManagedScalingStatus
CapacityProviderMemoryGiBPerVCpuRequest
CapacityProviderMemoryMiBRequest
CapacityProviderNetworkBandwidthGbpsRequest
CapacityProviderNetworkInterfaceCountRequest
CapacityProviderTotalLocalStorageGbRequest
CapacityProviderVCpuCountRangeRequest
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
