aws-cdk-lib.aws_autoscaling.EbsDeviceProps

interface EbsDeviceProps

LanguageType name
.NETAmazon.CDK.AWS.AutoScaling.EbsDeviceProps
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsautoscaling#EbsDeviceProps
Javasoftware.amazon.awscdk.services.autoscaling.EbsDeviceProps
Pythonaws_cdk.aws_autoscaling.EbsDeviceProps
TypeScript (source)aws-cdk-lib » aws_autoscaling » EbsDeviceProps

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 { aws_autoscaling as autoscaling } from 'aws-cdk-lib';
const ebsDeviceProps: autoscaling.EbsDeviceProps = {
  deleteOnTermination: false,
  iops: 123,
  snapshotId: 'snapshotId',
  throughput: 123,
  volumeSize: 123,
  volumeType: autoscaling.EbsDeviceVolumeType.STANDARD,
};

Properties

NameTypeDescription
deleteOnTermination?booleanIndicates whether to delete the volume when the instance is terminated.
iops?numberThe number of I/O operations per second (IOPS) to provision for the volume.
snapshotId?stringThe snapshot ID of the volume to use.
throughput?numberThe throughput that the volume supports, in MiB/s Takes a minimum of 125 and maximum of 1000.
volumeSize?numberThe volume size, in Gibibytes (GiB).
volumeType?EbsDeviceVolumeTypeThe EBS volume type.

deleteOnTermination?

Type: boolean (optional, default: true for Amazon EC2 Auto Scaling, false otherwise (e.g. EBS))

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


iops?

Type: number (optional, default: none, required for EbsDeviceVolumeType.IO1)

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.

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


snapshotId?

Type: string (optional, default: No snapshot will be used)

The snapshot ID of the volume to use.


throughput?

Type: number (optional, default: 125 MiB/s. Only valid on gp3 volumes.)

The throughput that the volume supports, in MiB/s Takes a minimum of 125 and maximum of 1000.

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


volumeSize?

Type: number (optional, default: 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.


volumeType?

Type: EbsDeviceVolumeType (optional, default: EbsDeviceVolumeType.GP2)

The EBS volume type.

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