Skip to content
v2.273.0

EbsDeviceProps Struct ​

Properties of an EBS block device.

Example ​

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

declare const size: cdk.Size;
const ebsDeviceProps: autoscaling.EbsDeviceProps = {
  deleteOnTermination: false,
  iops: 123,
  snapshotId: 'snapshotId',
  throughput: 123,
  volumeInitializationRate: size,
  volumeSize: 123,
  volumeType: autoscaling.EbsDeviceVolumeType.STANDARD,
};

Properties ​

deleteOnTerminationbooleandelete_on_terminationbooldeleteOnTerminationBooleanDeleteOnTerminationboolDeleteOnTermination*bool= true for Amazon EC2 Auto Scaling…#
Indicates whether to delete the volume when the instance is terminated.
default

Default: true for Amazon EC2 Auto Scaling, false otherwise (e.g. EBS)

iopsnumberiopsint | floatiopsNumberIopsdoubleIops*float64= none, required for `EbsDeviceVol…#
The number of I/O operations per second (IOPS) to provision for the volume.

Must only be set for volumeType: EbsDeviceVolumeType.IO1

The maximum ratio of IOPS to volume size (in GiB) is 50:1, so for 5,000 provisioned IOPS, you need at least 100 GiB storage on the volume.

default

Default: none, required for EbsDeviceVolumeType.IO1

snapshotIdstringsnapshot_idstrsnapshotIdStringSnapshotIdstringSnapshotId*string= No snapshot will be used#
The snapshot ID of the volume to use.
throughputnumberthroughputint | floatthroughputNumberThroughputdoubleThroughput*float64= 125 MiB/s. Only valid on gp3 vol…#
The throughput that the volume supports, in MiB/s Takes a minimum of 125 and maximum of 2000.
default

Default: 125 MiB/s. Only valid on gp3 volumes.

volumeInitializationRateSizevolume_initialization_rateSizevolumeInitializationRateSizeVolumeInitializationRateSizeVolumeInitializationRateSize= undefined - The volume initializ…#
The Amazon EBS Provisioned Rate for Volume Initialization, at which to download the snapshot blocks from Amazon S3 to the volume.

Valid range is between 100 and 300 MiB/s. This parameter is supported only for volumes created from snapshots.

default

Default: undefined - The volume initialization rate is not set.

volumeSizenumbervolume_sizeint | floatvolumeSizeNumberVolumeSizedoubleVolumeSize*float64= The snapshot size#
The volume size, in Gibibytes (GiB).

If you specify volumeSize, it must be equal or greater than the size of the snapshot.

volumeTypeEbsDeviceVolumeTypevolume_typeEbsDeviceVolumeTypevolumeTypeEbsDeviceVolumeTypeVolumeTypeEbsDeviceVolumeTypeVolumeTypeEbsDeviceVolumeType= `EbsDeviceVolumeType.GP2`#
The EBS volume type.

Used as props by ​