software.amazon.awscdk.services.ec2

Interface EbsDeviceProps

All Superinterfaces:

EbsDeviceOptions, EbsDeviceOptionsBase, EbsDeviceSnapshotOptions

All Known Implementing Classes:

EbsDeviceProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.58.0 (build f8ba112)",
           date="2022-05-13T01:13:32.807Z")
public interface EbsDeviceProps
extends 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")
         .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 java.lang.Boolean	getDeleteOnTermination() Indicates whether to delete the volume when the instance is terminated.
default java.lang.Number	getIops() The number of I/O operations per second (IOPS) to provision for the volume.
default java.lang.String	getSnapshotId() The snapshot ID of the volume to use.
default EbsDeviceVolumeType	getVolumeType() 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

default java.lang.String getSnapshotId()

The snapshot ID of the volume to use.

Default: - No snapshot will be used

getDeleteOnTermination

default java.lang.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

default java.lang.Number getIops()

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

default EbsDeviceVolumeType getVolumeType()

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

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