AWS CDK Reference

Appearance

v2.273.0

EbsDeviceSnapshotOptions Struct ​

Block device options for an EBS volume created from a snapshot.

Source
aws-ec2/lib/volume.ts

Example ​

ts
const launchTemplate = new ec2.LaunchTemplate(this, 'LaunchTemplate', {
  blockDevices: [
    {
      deviceName: 'deviceName',
      volume: ec2.BlockDeviceVolume.ebsFromSnapshot('snap-1234567890abcdef0', {
        volumeSize: 150,
        volumeInitializationRate: Size.mebibytes(200),
      }),
    },
  ],
});

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

throughputnumberthroughputint | floatthroughputNumberThroughputdoubleThroughput*float64= 125 MiB/s.#
The throughput to provision for a `gp3` volume.
notes

Valid Range: Minimum value of 125. Maximum value of 2000.

gp3 volumes deliver a consistent baseline throughput performance of 125 MiB/s. You can provision additional throughput for an additional cost at a ratio of 0.25 MiB/s per provisioned IOPS.

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.GENERAL_PUR…#
The EBS volume type.
default

Default: EbsDeviceVolumeType.GENERAL_PURPOSE_SSD or EbsDeviceVolumeType.GENERAL_PURPOSE_SSD_GP3 if @aws-cdk/aws-ec2:ebsDefaultGp3Volume is enabled.