aws-cdk-lib.aws_ec2.VolumeProps

VolumeProps Struct

Properties of an EBS Volume.

Source

aws-ec2/lib/volume.ts

Type last changed

v2.201.0 · 13 Jun 2025

Example

new ec2.Volume(this, 'Volume', {
  availabilityZone: 'us-east-1a',
  size: Size.gibibytes(125),
  volumeType: ec2.EbsDeviceVolumeType.GP3,
  throughput: 125,
});

Properties

autoEnableIobooleanauto_enable_ioboolautoEnableIoBooleanAutoEnableIoboolAutoEnableIo*bool= false#

Indicates whether the volume is auto-enabled for I/O operations.

notes

By default, Amazon EBS disables I/O to the volume from attached EC2 instances when it determines that a volume's data is potentially inconsistent. If the consistency of the volume is not a concern, and you prefer that the volume be made available immediately if it's impaired, you can configure the volume to automatically enable I/O.

availabilityZonestringavailability_zonestravailabilityZoneStringAvailabilityZonestringAvailabilityZone*stringrequired#

The Availability Zone in which to create the volume.

enableMultiAttachbooleanenable_multi_attachboolenableMultiAttachBooleanEnableMultiAttachboolEnableMultiAttach*bool= false#

Indicates whether Amazon EBS Multi-Attach is enabled.

See Considerations and limitations for the constraints of multi-attach.

encryptedbooleanencryptedboolencryptedBooleanEncryptedboolEncrypted*bool= false#

Specifies whether the volume should be encrypted.

notes

The effect of setting the encryption state to true depends on the volume origin (new or from a snapshot), starting encryption state, ownership, and whether encryption by default is enabled. For more information, see Encryption by Default in the Amazon Elastic Compute Cloud User Guide.

Encrypted Amazon EBS volumes must be attached to instances that support Amazon EBS encryption. For more information, see Supported Instance Types.

encryptionKeyIKeyencryption_keyIKeyencryptionKeyIKeyEncryptionKeyIKeyEncryptionKeyIKey= The default KMS key for the acco…#

The customer-managed encryption key that is used to encrypt the Volume.

notes · default

The encrypted property must be true if this is provided.

Note: If using an aws-kms.IKey created from a aws-kms.Key.fromKeyArn() here, then the KMS key must have the following in its Key policy; otherwise, the Volume will fail to create.

{
  "Effect": "Allow",
  "Principal": { "AWS": "<arn for your account-user> ex: arn:aws:iam::00000000000:root" },
  "Resource": "*",
  "Action": [
    "kms:DescribeKey",
    "kms:GenerateDataKeyWithoutPlainText",
  ],
  "Condition": {
    "StringEquals": {
      "kms:ViaService": "ec2.<Region>.amazonaws.com", (eg: ec2.us-east-1.amazonaws.com)
      "kms:CallerAccount": "0000000000" (your account ID)
    }
  }
}

Default: The default KMS key for the account, region, and EC2 service is used.

iopsnumberiopsint | floatiopsNumberIopsdoubleIops*float64= None -- Required for io1 and io2…#

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

notes · default

The maximum ratio is 50 IOPS/GiB for PROVISIONED_IOPS_SSD, and 500 IOPS/GiB for both PROVISIONED_IOPS_SSD_IO2 and GENERAL_PURPOSE_SSD_GP3. See https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html for more information.

This parameter is valid only for PROVISIONED_IOPS_SSD, PROVISIONED_IOPS_SSD_IO2 and GENERAL_PURPOSE_SSD_GP3 volumes.

Default: None -- Required for io1 and io2 volumes. The default for gp3 volumes is 3,000 IOPS if omitted.

removalPolicyRemovalPolicyremoval_policyRemovalPolicyremovalPolicyRemovalPolicyRemovalPolicyRemovalPolicyRemovalPolicyRemovalPolicy= RemovalPolicy.RETAIN#

Policy to apply when the volume is removed from the stack.

sizeSizesizeSizesizeSizeSizeSizeSizeSize= If you're creating the volume fr…#

The size of the volume, in GiBs.

You must specify either a snapshot ID or a volume size. See https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ec2-volume.html for details on the allowable size for each type of volume.

default

Default: If you're creating the volume from a snapshot and don't specify a volume size, the default is the snapshot size.

snapshotIdstringsnapshot_idstrsnapshotIdStringSnapshotIdstringSnapshotId*string= The EBS volume is not created fr…#

The snapshot from which to create the volume.

You must specify either a snapshot ID or a volume size.

default

Default: The EBS volume is not created from a snapshot.

throughputnumberthroughputint | floatthroughputNumberThroughputdoubleThroughput*float64= 125 MiB/s. Only valid on gp3 vol…#

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

default

Default: 125 MiB/s. Only valid on gp3 volumes.

volumeInitializationRateSizevolume_initialization_rateSizevolumeInitializationRateSizeVolumeInitializationRateSizeVolumeInitializationRateSize= undefined - The volume initializ…#

Specifies the Amazon EBS Provisioned Rate for Volume Initialization (volume initialization rate), 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.

volumeNamestringvolume_namestrvolumeNameStringVolumeNamestringVolumeName*string= The physical name will be alloca…#

The value of the physicalName property of this resource.

default

Default: The physical name will be allocated by CloudFormation at deployment time

volumeTypeEbsDeviceVolumeTypevolume_typeEbsDeviceVolumeTypevolumeTypeEbsDeviceVolumeTypeVolumeTypeEbsDeviceVolumeTypeVolumeTypeEbsDeviceVolumeType= `EbsDeviceVolumeType.GENERAL_PUR…#

The type of the volume;

what type of storage to use to form the EBS Volume.

default

Default: EbsDeviceVolumeType.GENERAL_PURPOSE_SSD

Used as props by

• Volume