enum InstanceGeneration

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

Instance generation categories for EC2.

Determines whether the instance type must belong to the latest (current) generation or to an older (previous) generation.

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
CURRENT	Current generation instances (latest families).
PREVIOUS	Previous generation instances (older families).

---

CURRENT

Current generation instances (latest families).

---

PREVIOUS

Previous generation instances (older families).