interface ManagedInstancesProviderProperty

Language	Type name
.NET	`Amazon.CDK.Mixins.Preview.AWS.ECS.Mixins.CfnCapacityProviderPropsMixin.ManagedInstancesProviderProperty`
Go	`github.com/aws/aws-cdk-go/awscdkmixinspreview/v2/awsecs/mixins#CfnCapacityProviderPropsMixin_ManagedInstancesProviderProperty`
Java	`software.amazon.awscdk.mixins.preview.services.ecs.mixins.CfnCapacityProviderPropsMixin.ManagedInstancesProviderProperty`
Python	`aws_cdk.mixins_preview.aws_ecs.mixins.CfnCapacityProviderPropsMixin.ManagedInstancesProviderProperty`
TypeScript	`@aws-cdk/mixins-preview` » `aws_ecs` » `mixins` » `CfnCapacityProviderPropsMixin` » `ManagedInstancesProviderProperty`

The configuration for a Amazon ECS Managed Instances provider.

Amazon ECS uses this configuration to automatically launch, manage, and terminate Amazon EC2 instances on your behalf. Managed instances provide access to the full range of Amazon EC2 instance types and features while offloading infrastructure management to AWS .

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { mixins as ecs_mixins } from '@aws-cdk/mixins-preview/aws-ecs';
const managedInstancesProviderProperty: ecs_mixins.CfnCapacityProviderPropsMixin.ManagedInstancesProviderProperty = {
  infrastructureOptimization: {
    scaleInAfter: 123,
  },
  infrastructureRoleArn: 'infrastructureRoleArn',
  instanceLaunchTemplate: {
    ec2InstanceProfileArn: 'ec2InstanceProfileArn',
    instanceRequirements: {
      acceleratorCount: {
        max: 123,
        min: 123,
      },
      acceleratorManufacturers: ['acceleratorManufacturers'],
      acceleratorNames: ['acceleratorNames'],
      acceleratorTotalMemoryMiB: {
        max: 123,
        min: 123,
      },
      acceleratorTypes: ['acceleratorTypes'],
      allowedInstanceTypes: ['allowedInstanceTypes'],
      bareMetal: 'bareMetal',
      baselineEbsBandwidthMbps: {
        max: 123,
        min: 123,
      },
      burstablePerformance: 'burstablePerformance',
      cpuManufacturers: ['cpuManufacturers'],
      excludedInstanceTypes: ['excludedInstanceTypes'],
      instanceGenerations: ['instanceGenerations'],
      localStorage: 'localStorage',
      localStorageTypes: ['localStorageTypes'],
      maxSpotPriceAsPercentageOfOptimalOnDemandPrice: 123,
      memoryGiBPerVCpu: {
        max: 123,
        min: 123,
      },
      memoryMiB: {
        max: 123,
        min: 123,
      },
      networkBandwidthGbps: {
        max: 123,
        min: 123,
      },
      networkInterfaceCount: {
        max: 123,
        min: 123,
      },
      onDemandMaxPricePercentageOverLowestPrice: 123,
      requireHibernateSupport: false,
      spotMaxPricePercentageOverLowestPrice: 123,
      totalLocalStorageGb: {
        max: 123,
        min: 123,
      },
      vCpuCount: {
        max: 123,
        min: 123,
      },
    },
    monitoring: 'monitoring',
    networkConfiguration: {
      securityGroups: ['securityGroups'],
      subnets: ['subnets'],
    },
    storageConfiguration: {
      storageSizeGiB: 123,
    },
  },
  propagateTags: 'propagateTags',
};

Properties

Name	Type	Description
infrastructureOptimization?	`IResolvable` `\|` `InfrastructureOptimizationProperty`	Defines how Amazon ECS Managed Instances optimizes the infrastastructure in your capacity provider.
infrastructureRoleArn?	`string`	The Amazon Resource Name (ARN) of the infrastructure role that Amazon ECS assumes to manage instances.
instanceLaunchTemplate?	`IResolvable` `\|` `InstanceLaunchTemplateProperty`	The launch template that defines how Amazon ECS launches Amazon ECS Managed Instances.
propagateTags?	`string`	Determines whether tags from the capacity provider are automatically applied to Amazon ECS Managed Instances.

infrastructureOptimization?

Type: IResolvable | InfrastructureOptimizationProperty (optional)

Defines how Amazon ECS Managed Instances optimizes the infrastastructure in your capacity provider.

Configure it to turn on or off the infrastructure optimization in your capacity provider, and to control the idle or underutilized EC2 instances optimization delay.

infrastructureRoleArn?

Type: string (optional)

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 .

instanceLaunchTemplate?

Type: IResolvable | InstanceLaunchTemplateProperty (optional)

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 .

propagateTags?

Type: string (optional)

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.

AWS CDK

2.233.0