2.219.0

enum BareMetal

LanguageType name
.NETAmazon.CDK.AWS.EC2.BareMetal
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsec2#BareMetal
Javasoftware.amazon.awscdk.services.ec2.BareMetal
Pythonaws_cdk.aws_ec2.BareMetal
TypeScript (source)aws-cdk-lib » aws_ec2 » BareMetal

Bare metal support requirements for EC2 instances.

Controls whether selected instance types must, may, or must not be bare metal variants (i.e., instances that run directly on physical hardware without a hypervisor).

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

NameDescription
INCLUDEDBare metal instance types are allowed, but non-bare-metal (virtualized) types may also be selected.
REQUIREDOnly bare metal instance types are allowed.
EXCLUDEDBare metal instance types are disallowed.

INCLUDED

Bare metal instance types are allowed, but non-bare-metal (virtualized) types may also be selected.

REQUIRED

Only bare metal instance types are allowed.

Non-bare-metal types will be excluded from selection.

EXCLUDED

Bare metal instance types are disallowed.

Only non-bare-metal types may be selected.

← PreviousNext →