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.58.0 (build f8ba112)",
           date="2022-05-11T19:24:28.772Z")
 @Stability(value=Experimental)
public interface EbsDeviceProps
extends software.amazon.jsii.JsiiSerializable, EbsDeviceSnapshotOptions, EbsDeviceOptions

(experimental) 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")
         .volumeSize(123)
         .volumeType(EbsDeviceVolumeType.STANDARD)
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

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

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

getVolumeSize

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

getEncrypted, getKmsKey

Method Detail

getSnapshotId

@Stability(value=Experimental)
 @Nullable
default String getSnapshotId()

(experimental) The snapshot ID of the volume to use.

Default: - No snapshot will be used

getDeleteOnTermination

@Stability(value=Experimental)
 @Nullable
default Boolean getDeleteOnTermination()

(experimental) 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(value=Experimental)
 @Nullable
default Number getIops()

(experimental) The number of I/O operations per second (IOPS) to provision for the volume.

Must only be set for {@link volumeType}: {@link 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

getVolumeType

@Stability(value=Experimental)
 @Nullable
default EbsDeviceVolumeType getVolumeType()

(experimental) The EBS volume type.

Default: EbsDeviceVolumeType.GP2

Specified by:

getVolumeType in interface EbsDeviceOptionsBase

See Also:

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

builder

@Stability(value=Experimental)
static EbsDeviceProps.Builder builder()

Specified by:

builder in interface EbsDeviceOptions

Specified by:

builder in interface EbsDeviceOptionsBase

Specified by:

builder in interface EbsDeviceSnapshotOptions

Returns:

a EbsDeviceProps.Builder of EbsDeviceProps