Package software.amazon.awscdk.services.ec2

Interface EbsDeviceProps

All Superinterfaces:

EbsDeviceOptions, EbsDeviceOptionsBase, EbsDeviceSnapshotOptions, software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

EbsDeviceProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.121.0 (build d7af9b9)",
           date="2025-12-18T18:20:09.181Z")
@Stability(Stable)
public interface EbsDeviceProps
extends software.amazon.jsii.JsiiSerializable, EbsDeviceSnapshotOptions, EbsDeviceOptions

Properties of an EBS block device.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.ec2.*;
 import software.amazon.awscdk.services.kms.*;
 Key key;
 EbsDeviceProps ebsDeviceProps = EbsDeviceProps.builder()
         .deleteOnTermination(false)
         .encrypted(false)
         .iops(123)
         .kmsKey(key)
         .snapshotId("snapshotId")
         .throughput(123)
         .volumeSize(123)
         .volumeType(EbsDeviceVolumeType.STANDARD)
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	EbsDeviceProps.Builder	A builder for EbsDeviceProps
static final class	EbsDeviceProps.Jsii$Proxy	An implementation for EbsDeviceProps

Method Summary

Modifier and Type	Method	Description
static EbsDeviceProps.Builder	builder()
default Boolean	getDeleteOnTermination()	Indicates whether to delete the volume when the instance is terminated.
default Number	getIops()	The number of I/O operations per second (IOPS) to provision for the volume.
default String	getSnapshotId()	The snapshot ID of the volume to use.
default Number	getThroughput()	The throughput to provision for a gp3 volume.
default EbsDeviceVolumeType	getVolumeType()	The EBS volume type.

Methods inherited from interface software.amazon.awscdk.services.ec2.EbsDeviceOptions

getEncrypted, getKmsKey

Methods inherited from interface software.amazon.awscdk.services.ec2.EbsDeviceSnapshotOptions

getVolumeSize

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getSnapshotId

@Stability(Stable)
@Nullable
default String getSnapshotId()

The snapshot ID of the volume to use.

Default: - No snapshot will be used

getDeleteOnTermination

@Stability(Stable)
@Nullable
default Boolean getDeleteOnTermination()

Indicates whether to delete the volume when the instance is terminated.

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

Specified by:

getDeleteOnTermination in interface EbsDeviceOptionsBase

getIops

@Stability(Stable)
@Nullable
default Number getIops()

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: - none, required for `EbsDeviceVolumeType.IO1`

Specified by:

getIops in interface EbsDeviceOptionsBase

See Also:

• https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html

getThroughput

@Stability(Stable)
@Nullable
default Number getThroughput()

The throughput to provision for a gp3 volume.

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.

Default: - 125 MiB/s.

Specified by:

getThroughput in interface EbsDeviceOptionsBase

See Also:

• https://docs.aws.amazon.com/ebs/latest/userguide/general-purpose.html#gp3-performance

getVolumeType

@Stability(Stable)
@Nullable
default EbsDeviceVolumeType getVolumeType()

The EBS volume type.

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

Specified by:

getVolumeType in interface EbsDeviceOptionsBase

See Also:

• https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/EBSVolumeTypes.html

builder

@Stability(Stable)
static EbsDeviceProps.Builder builder()

Returns:

a EbsDeviceProps.Builder of EbsDeviceProps