enum BurstablePerformance

Language	Type name
.NET	Amazon.CDK.AWS.EC2.BurstablePerformance
Go	github.com/aws/aws-cdk-go/awscdk/v2/awsec2#BurstablePerformance
Java	software.amazon.awscdk.services.ec2.BurstablePerformance
Python	aws_cdk.aws_ec2.BurstablePerformance
TypeScript (source)	aws-cdk-lib » aws_ec2 » BurstablePerformance

Burstable CPU performance requirements for EC2 instances.

Controls whether selected instance types must, may, or must not support burstable vCPU performance (e.g., T3, T4g families).

Example

declare const infrastructureRole: iam.Role;
declare const instanceProfile: iam.InstanceProfile;
declare const vpc: ec2.Vpc;

const miCapacityProvider = new ecs.ManagedInstancesCapacityProvider(this, 'MICapacityProvider', {
  infrastructureRole,
  ec2InstanceProfile: instanceProfile,
  subnets: vpc.privateSubnets,
  instanceRequirements: {
    // Required: CPU and memory constraints
    vCpuCountMin: 2,
    vCpuCountMax: 8,
    memoryMin: Size.gibibytes(4),
    memoryMax: Size.gibibytes(32),

    // CPU preferences
    cpuManufacturers: [ec2.CpuManufacturer.INTEL, ec2.CpuManufacturer.AMD],
    instanceGenerations: [ec2.InstanceGeneration.CURRENT],

    // Instance type filtering
    allowedInstanceTypes: ['m5.*', 'c5.*'],

    // Performance characteristics
    burstablePerformance: ec2.BurstablePerformance.EXCLUDED,
    bareMetal: ec2.BareMetal.EXCLUDED,

    // Accelerator requirements (for ML/AI workloads)
    acceleratorTypes: [ec2.AcceleratorType.GPU],
    acceleratorManufacturers: [ec2.AcceleratorManufacturer.NVIDIA],
    acceleratorNames: [ec2.AcceleratorName.T4, ec2.AcceleratorName.V100],
    acceleratorCountMin: 1,

    // Storage requirements
    localStorage: ec2.LocalStorage.REQUIRED,
    localStorageTypes: [ec2.LocalStorageType.SSD],
    totalLocalStorageGBMin: 100,

    // Network requirements
    networkInterfaceCountMin: 2,
    networkBandwidthGbpsMin: 10,

    // Cost optimization
    onDemandMaxPricePercentageOverLowestPrice: 10,
  },
});

Members

Name	Description
INCLUDED	Burstable-performance instance types are allowed, but non-burstable types may also be selected.
REQUIRED	Only burstable-performance instance types are allowed.
EXCLUDED	Burstable-performance instance types are disallowed.

---

INCLUDED

Burstable-performance instance types are allowed, but non-burstable types may also be selected.

---

REQUIRED

Only burstable-performance instance types are allowed.

Non-burstable types will be excluded from selection.

---

EXCLUDED

Burstable-performance instance types are disallowed.

Only non-burstable types may be selected.