Skip to content
v2.274.0

BlockDevice Struct ​

Block device.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_ec2 as ec2 } from 'aws-cdk-lib';

declare const blockDeviceVolume: ec2.BlockDeviceVolume;
const blockDevice: ec2.BlockDevice = {
  deviceName: 'deviceName',
  volume: blockDeviceVolume,

  // the properties below are optional
  mappingEnabled: false,
};

Properties ​

deviceNamestringdevice_namestrdeviceNameStringDeviceNamestringDeviceName*stringrequired#
The device name exposed to the EC2 instance.

For example, a value like /dev/sdh, xvdh.

mappingEnabledbooleanmapping_enabledboolmappingEnabledBooleanMappingEnabledboolMappingEnabled*bool= true - device mapping is left un…#
If false, the device mapping will be suppressed.

If set to false for the root device, the instance might fail the Amazon EC2 health check. Amazon EC2 Auto Scaling launches a replacement instance if the instance fails the health check.

default

Default: true - device mapping is left untouched

Defines the block device volume, to be either an Amazon EBS volume or an ephemeral instance store volume.

For example, a value like BlockDeviceVolume.ebs(15), BlockDeviceVolume.ephemeral(0).