enum LocalStorage

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

Local storage support requirements for EC2 instances.

Controls whether selected instance types must, may, or must not include directly attached local storage (instance store).

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	Instance types with local storage are allowed, but types without local storage may also be selected.
REQUIRED	Only instance types with local storage are allowed.
EXCLUDED	Instance types with local storage are disallowed.

---

INCLUDED

Instance types with local storage are allowed, but types without local storage may also be selected.

---

REQUIRED

Only instance types with local storage are allowed.

Types without local storage will be excluded.

---

EXCLUDED

Instance types with local storage are disallowed.

Only types without local storage may be selected.