aws-cdk-lib 2.154.1__py3-none-any.whl → 2.155.0__py3-none-any.whl

aws_cdk/aws_ec2/__init__.py

@@ -1721,6 +1721,32 @@ ec2.Instance(self, "Instance",
 )
 ```
 
+To specify the throughput value for `gp3` volumes, use the `throughput` property:
+
+```python
+# vpc: ec2.Vpc
+# instance_type: ec2.InstanceType
+# machine_image: ec2.IMachineImage
+
+
+ec2.Instance(self, "Instance",
+    vpc=vpc,
+    instance_type=instance_type,
+    machine_image=machine_image,
+
+    # ...
+
+    block_devices=[ec2.BlockDevice(
+        device_name="/dev/sda1",
+        volume=ec2.BlockDeviceVolume.ebs(100,
+            volume_type=ec2.EbsDeviceVolumeType.GP3,
+            throughput=250
+        )
+    )
+    ]
+)
+```
+
 #### EBS Optimized Instances
 
 An Amazon EBS–optimized instance uses an optimized configuration stack and provides additional, dedicated capacity for Amazon EBS I/O. This optimization provides the best performance for your EBS volumes by minimizing contention between Amazon EBS I/O and other traffic from your instance.
@@ -1992,6 +2018,25 @@ Note to set `mapPublicIpOnLaunch` to true in the `subnetConfiguration`.
 
 Additionally, IPv6 support varies by instance type. Most instance types have IPv6 support with exception of m1-m3, c1, g2, and t1.micro. A full list can be found here: https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI.
 
+#### Specifying the IPv6 Address
+
+If you want to specify [the number of IPv6 addresses](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/MultipleIP.html#assign-multiple-ipv6) to assign to the instance, you can use the `ipv6AddresseCount` property:
+
+```python
+# dual stack VPC
+# vpc: ec2.Vpc
+
+
+instance = ec2.Instance(self, "MyInstance",
+    instance_type=ec2.InstanceType.of(ec2.InstanceClass.M5, ec2.InstanceSize.LARGE),
+    machine_image=ec2.MachineImage.latest_amazon_linux2(),
+    vpc=vpc,
+    vpc_subnets=ec2.SubnetSelection(subnet_type=ec2.SubnetType.PUBLIC),
+    # Assign 2 IPv6 addresses to the instance
+    ipv6_address_count=2
+)
+```
+
 ### Credit configuration modes for burstable instances
 
 You can set the [credit configuration mode](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-credits-baseline-concepts.html) for burstable instances (T2, T3, T3a and T4g instance types):
@@ -5343,10 +5388,10 @@ class BlockDeviceVolume(
         
             block_devices=[ec2.BlockDevice(
                 device_name="/dev/sda1",
-                volume=ec2.BlockDeviceVolume.ebs(50)
-            ), ec2.BlockDevice(
-                device_name="/dev/sdm",
-                volume=ec2.BlockDeviceVolume.ebs(100)
+                volume=ec2.BlockDeviceVolume.ebs(100,
+                    volume_type=ec2.EbsDeviceVolumeType.GP3,
+                    throughput=250
+                )
             )
             ]
         )
@@ -5377,6 +5422,7 @@ class BlockDeviceVolume(
         kms_key: typing.Optional[_IKey_5f11635f] = None,
         delete_on_termination: typing.Optional[builtins.bool] = None,
         iops: typing.Optional[jsii.Number] = None,
+        throughput: typing.Optional[jsii.Number] = None,
         volume_type: typing.Optional["EbsDeviceVolumeType"] = None,
     ) -> "BlockDeviceVolume":
         '''Creates a new Elastic Block Storage device.
@@ -5386,6 +5432,7 @@ class BlockDeviceVolume(
         :param kms_key: The ARN of the AWS Key Management Service (AWS KMS) CMK used for encryption. You have to ensure that the KMS CMK has the correct permissions to be used by the service launching the ec2 instances. Default: - If encrypted is true, the default aws/ebs KMS key will be used.
         :param delete_on_termination: Indicates whether to delete the volume when the instance is terminated. Default: - true for Amazon EC2 Auto Scaling, false otherwise (e.g. EBS)
         :param iops: 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``
+        :param throughput: The throughput to provision for a ``gp3`` volume. Valid Range: Minimum value of 125. Maximum value of 1000. ``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.
         :param volume_type: The EBS volume type. Default: ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD`` or ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD_GP3`` if ``@aws-cdk/aws-ec2:ebsDefaultGp3Volume`` is enabled.
         '''
         if __debug__:
@@ -5396,6 +5443,7 @@ class BlockDeviceVolume(
             kms_key=kms_key,
             delete_on_termination=delete_on_termination,
             iops=iops,
+            throughput=throughput,
             volume_type=volume_type,
         )
 
@@ -5410,6 +5458,7 @@ class BlockDeviceVolume(
         volume_size: typing.Optional[jsii.Number] = None,
         delete_on_termination: typing.Optional[builtins.bool] = None,
         iops: typing.Optional[jsii.Number] = None,
+        throughput: typing.Optional[jsii.Number] = None,
         volume_type: typing.Optional["EbsDeviceVolumeType"] = None,
     ) -> "BlockDeviceVolume":
         '''Creates a new Elastic Block Storage device from an existing snapshot.
@@ -5418,6 +5467,7 @@ class BlockDeviceVolume(
         :param volume_size: The volume size, in Gibibytes (GiB). If you specify volumeSize, it must be equal or greater than the size of the snapshot. Default: - The snapshot size
         :param delete_on_termination: Indicates whether to delete the volume when the instance is terminated. Default: - true for Amazon EC2 Auto Scaling, false otherwise (e.g. EBS)
         :param iops: 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``
+        :param throughput: The throughput to provision for a ``gp3`` volume. Valid Range: Minimum value of 125. Maximum value of 1000. ``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.
         :param volume_type: The EBS volume type. Default: ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD`` or ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD_GP3`` if ``@aws-cdk/aws-ec2:ebsDefaultGp3Volume`` is enabled.
         '''
         if __debug__:
@@ -5427,6 +5477,7 @@ class BlockDeviceVolume(
             volume_size=volume_size,
             delete_on_termination=delete_on_termination,
             iops=iops,
+            throughput=throughput,
             volume_type=volume_type,
         )
 
@@ -20273,7 +20324,7 @@ class CfnInstance(
         ) -> None:
             '''Specifies input parameter values for an SSM document in AWS Systems Manager .
 
-            ``AssociationParameter`` is a property of the `Amazon EC2 Instance SsmAssociation <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-ssmassociations.html>`_ property.
+            ``AssociationParameter`` is a property of the `SsmAssociation <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-ssmassociation.html>`_ property type.
 
             :param key: The name of an input parameter that is in the associated SSM document.
             :param value: The value of an input parameter.
@@ -20646,7 +20697,7 @@ class CfnInstance(
         ) -> None:
             '''Specifies a block device for an EBS volume.
 
-            ``Ebs`` is a property of the `Amazon EC2 BlockDeviceMapping <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-blockdev-mapping.html>`_ property.
+            ``Ebs`` is a property of the `BlockDeviceMapping <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-blockdevicemapping.html>`_ property type.
             .. epigraph::
 
                After the instance is running, you can modify only the ``DeleteOnTermination`` parameters for the attached volumes without interrupting the instance. Modifying any other parameter results in instance `replacement <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement>`_ .
@@ -21916,9 +21967,9 @@ class CfnInstance(
             code: typing.Optional[builtins.str] = None,
             name: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''The current state of the instance.
+            '''Describes the current state of an instance.
 
-            :param code: The state of the instance as a 16-bit unsigned integer.
+            :param code: The state of the instance as a 16-bit unsigned integer. The high byte is all of the bits between 2^8 and (2^16)-1, which equals decimal values between 256 and 65,535. These numerical values are used for internal purposes and should be ignored. The low byte is all of the bits between 2^0 and (2^8)-1, which equals decimal values between 0 and 255. The valid values for instance-state-code will all be in the range of the low byte and they are: - ``0`` : ``pending`` - ``16`` : ``running`` - ``32`` : ``shutting-down`` - ``48`` : ``terminated`` - ``64`` : ``stopping`` - ``80`` : ``stopped`` You can ignore the high byte value by zeroing out all of the bits above 2^8 or 256 in decimal.
             :param name: The current state of the instance.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-state.html
@@ -21949,6 +22000,21 @@ class CfnInstance(
         def code(self) -> typing.Optional[builtins.str]:
             '''The state of the instance as a 16-bit unsigned integer.
 
+            The high byte is all of the bits between 2^8 and (2^16)-1, which equals decimal values between 256 and 65,535. These numerical values are used for internal purposes and should be ignored.
+
+            The low byte is all of the bits between 2^0 and (2^8)-1, which equals decimal values between 0 and 255.
+
+            The valid values for instance-state-code will all be in the range of the low byte and they are:
+
+            - ``0`` : ``pending``
+            - ``16`` : ``running``
+            - ``32`` : ``shutting-down``
+            - ``48`` : ``terminated``
+            - ``64`` : ``stopping``
+            - ``80`` : ``stopped``
+
+            You can ignore the high byte value by zeroing out all of the bits above 2^8 or 256 in decimal.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance-state.html#cfn-ec2-instance-state-code
             '''
             result = self._values.get("code")
@@ -66128,6 +66194,7 @@ class DefaultInstanceTenancy(enum.Enum):
     name_mapping={
         "delete_on_termination": "deleteOnTermination",
         "iops": "iops",
+        "throughput": "throughput",
         "volume_type": "volumeType",
     },
 )
@@ -66137,12 +66204,14 @@ class EbsDeviceOptionsBase:
         *,
         delete_on_termination: typing.Optional[builtins.bool] = None,
         iops: typing.Optional[jsii.Number] = None,
+        throughput: typing.Optional[jsii.Number] = None,
         volume_type: typing.Optional["EbsDeviceVolumeType"] = None,
     ) -> None:
         '''Base block device options for an EBS volume.
 
         :param delete_on_termination: Indicates whether to delete the volume when the instance is terminated. Default: - true for Amazon EC2 Auto Scaling, false otherwise (e.g. EBS)
         :param iops: 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``
+        :param throughput: The throughput to provision for a ``gp3`` volume. Valid Range: Minimum value of 125. Maximum value of 1000. ``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.
         :param volume_type: The EBS volume type. Default: ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD`` or ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD_GP3`` if ``@aws-cdk/aws-ec2:ebsDefaultGp3Volume`` is enabled.
 
         :exampleMetadata: fixture=_generated
@@ -66156,6 +66225,7 @@ class EbsDeviceOptionsBase:
             ebs_device_options_base = ec2.EbsDeviceOptionsBase(
                 delete_on_termination=False,
                 iops=123,
+                throughput=123,
                 volume_type=ec2.EbsDeviceVolumeType.STANDARD
             )
         '''
@@ -66163,12 +66233,15 @@ class EbsDeviceOptionsBase:
             type_hints = typing.get_type_hints(_typecheckingstub__0d06a3c480f0a868f3c69b22935c359322b1d9337591dc27bb141d518434f062)
             check_type(argname="argument delete_on_termination", value=delete_on_termination, expected_type=type_hints["delete_on_termination"])
             check_type(argname="argument iops", value=iops, expected_type=type_hints["iops"])
+            check_type(argname="argument throughput", value=throughput, expected_type=type_hints["throughput"])
             check_type(argname="argument volume_type", value=volume_type, expected_type=type_hints["volume_type"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
         if delete_on_termination is not None:
             self._values["delete_on_termination"] = delete_on_termination
         if iops is not None:
             self._values["iops"] = iops
+        if throughput is not None:
+            self._values["throughput"] = throughput
         if volume_type is not None:
             self._values["volume_type"] = volume_type
 
@@ -66197,6 +66270,22 @@ class EbsDeviceOptionsBase:
         result = self._values.get("iops")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def throughput(self) -> typing.Optional[jsii.Number]:
+        '''The throughput to provision for a ``gp3`` volume.
+
+        Valid Range: Minimum value of 125. Maximum value of 1000.
+
+        ``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.
+
+        :see: https://docs.aws.amazon.com/ebs/latest/userguide/general-purpose.html#gp3-performance
+        '''
+        result = self._values.get("throughput")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def volume_type(self) -> typing.Optional["EbsDeviceVolumeType"]:
         '''The EBS volume type.
@@ -66229,6 +66318,7 @@ class EbsDeviceOptionsBase:
     name_mapping={
         "delete_on_termination": "deleteOnTermination",
         "iops": "iops",
+        "throughput": "throughput",
         "volume_type": "volumeType",
         "volume_size": "volumeSize",
     },
@@ -66239,6 +66329,7 @@ class EbsDeviceSnapshotOptions(EbsDeviceOptionsBase):
         *,
         delete_on_termination: typing.Optional[builtins.bool] = None,
         iops: typing.Optional[jsii.Number] = None,
+        throughput: typing.Optional[jsii.Number] = None,
         volume_type: typing.Optional["EbsDeviceVolumeType"] = None,
         volume_size: typing.Optional[jsii.Number] = None,
     ) -> None:
@@ -66246,6 +66337,7 @@ class EbsDeviceSnapshotOptions(EbsDeviceOptionsBase):
 
         :param delete_on_termination: Indicates whether to delete the volume when the instance is terminated. Default: - true for Amazon EC2 Auto Scaling, false otherwise (e.g. EBS)
         :param iops: 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``
+        :param throughput: The throughput to provision for a ``gp3`` volume. Valid Range: Minimum value of 125. Maximum value of 1000. ``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.
         :param volume_type: The EBS volume type. Default: ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD`` or ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD_GP3`` if ``@aws-cdk/aws-ec2:ebsDefaultGp3Volume`` is enabled.
         :param volume_size: The volume size, in Gibibytes (GiB). If you specify volumeSize, it must be equal or greater than the size of the snapshot. Default: - The snapshot size
 
@@ -66260,6 +66352,7 @@ class EbsDeviceSnapshotOptions(EbsDeviceOptionsBase):
             ebs_device_snapshot_options = ec2.EbsDeviceSnapshotOptions(
                 delete_on_termination=False,
                 iops=123,
+                throughput=123,
                 volume_size=123,
                 volume_type=ec2.EbsDeviceVolumeType.STANDARD
             )
@@ -66268,6 +66361,7 @@ class EbsDeviceSnapshotOptions(EbsDeviceOptionsBase):
             type_hints = typing.get_type_hints(_typecheckingstub__4602c5be3c93ca5d255adf8aa3a652b8c7898310f96514ecd6fc09f7d5935370)
             check_type(argname="argument delete_on_termination", value=delete_on_termination, expected_type=type_hints["delete_on_termination"])
             check_type(argname="argument iops", value=iops, expected_type=type_hints["iops"])
+            check_type(argname="argument throughput", value=throughput, expected_type=type_hints["throughput"])
             check_type(argname="argument volume_type", value=volume_type, expected_type=type_hints["volume_type"])
             check_type(argname="argument volume_size", value=volume_size, expected_type=type_hints["volume_size"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
@@ -66275,6 +66369,8 @@ class EbsDeviceSnapshotOptions(EbsDeviceOptionsBase):
             self._values["delete_on_termination"] = delete_on_termination
         if iops is not None:
             self._values["iops"] = iops
+        if throughput is not None:
+            self._values["throughput"] = throughput
         if volume_type is not None:
             self._values["volume_type"] = volume_type
         if volume_size is not None:
@@ -66305,6 +66401,22 @@ class EbsDeviceSnapshotOptions(EbsDeviceOptionsBase):
         result = self._values.get("iops")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def throughput(self) -> typing.Optional[jsii.Number]:
+        '''The throughput to provision for a ``gp3`` volume.
+
+        Valid Range: Minimum value of 125. Maximum value of 1000.
+
+        ``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.
+
+        :see: https://docs.aws.amazon.com/ebs/latest/userguide/general-purpose.html#gp3-performance
+        '''
+        result = self._values.get("throughput")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def volume_type(self) -> typing.Optional["EbsDeviceVolumeType"]:
         '''The EBS volume type.
@@ -66351,21 +66463,25 @@ class EbsDeviceVolumeType(enum.Enum):
     Example::
 
         # vpc: ec2.Vpc
+        # instance_type: ec2.InstanceType
+        # machine_image: ec2.IMachineImage
         
         
-        instance = ec2.Instance(self, "Instance",
-            instance_type=ec2.InstanceType.of(ec2.InstanceClass.M5, ec2.InstanceSize.XLARGE),
-            machine_image=ec2.AmazonLinuxImage(),
+        ec2.Instance(self, "Instance",
             vpc=vpc,
-            hibernation_enabled=True,
+            instance_type=instance_type,
+            machine_image=machine_image,
+        
+            # ...
+        
             block_devices=[ec2.BlockDevice(
-                device_name="/dev/xvda",
-                volume=ec2.BlockDeviceVolume.ebs(30,
+                device_name="/dev/sda1",
+                volume=ec2.BlockDeviceVolume.ebs(100,
                     volume_type=ec2.EbsDeviceVolumeType.GP3,
-                    encrypted=True,
-                    delete_on_termination=True
+                    throughput=250
                 )
-            )]
+            )
+            ]
         )
     '''
 
@@ -72319,6 +72435,7 @@ class Instance(
         init_options: typing.Optional[typing.Union[ApplyCloudFormationInitOptions, typing.Dict[builtins.str, typing.Any]]] = None,
         instance_initiated_shutdown_behavior: typing.Optional["InstanceInitiatedShutdownBehavior"] = None,
         instance_name: typing.Optional[builtins.str] = None,
+        ipv6_address_count: typing.Optional[jsii.Number] = None,
         key_name: typing.Optional[builtins.str] = None,
         key_pair: typing.Optional[IKeyPair] = None,
         placement_group: typing.Optional[IPlacementGroup] = None,
@@ -72342,7 +72459,7 @@ class Instance(
         :param vpc: VPC to launch the instance in.
         :param allow_all_ipv6_outbound: Whether the instance could initiate IPv6 connections to anywhere by default. This property is only used when you do not provide a security group. Default: false
         :param allow_all_outbound: Whether the instance could initiate connections to anywhere by default. This property is only used when you do not provide a security group. Default: true
-        :param associate_public_ip_address: Whether to associate a public IP address to the primary network interface attached to this instance. Default: - public IP address is automatically assigned based on default behavior
+        :param associate_public_ip_address: Whether to associate a public IP address to the primary network interface attached to this instance. You cannot specify this property and ``ipv6AddressCount`` at the same time. Default: - public IP address is automatically assigned based on default behavior
         :param availability_zone: In which AZ to place the instance within the VPC. Default: - Random zone.
         :param block_devices: Specifies how block devices are exposed to the instance. You can specify virtual devices and EBS volumes. Each instance that is launched has an associated root device volume, either an Amazon EBS volume or an instance store volume. You can use block device mappings to specify additional EBS volumes or instance store volumes to attach to an instance when it is launched. Default: - Uses the block device mapping of the AMI
         :param credit_specification: Specifying the CPU credit type for burstable EC2 instance types (T2, T3, T3a, etc). The unlimited CPU credit option is not supported for T3 instances with a dedicated host. Default: - T2 instances are standard, while T3, T4g, and T3a instances are unlimited.
@@ -72354,6 +72471,7 @@ class Instance(
         :param init_options: Use the given options for applying CloudFormation Init. Describes the configsets to use and the timeout to wait Default: - default options
         :param instance_initiated_shutdown_behavior: Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown). Default: InstanceInitiatedShutdownBehavior.STOP
         :param instance_name: The name of the instance. Default: - CDK generated name
+        :param ipv6_address_count: The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet. You cannot specify this property and ``associatePublicIpAddress`` at the same time. Default: - For instances associated with an IPv6 subnet, use 1; otherwise, use 0.
         :param key_name: (deprecated) Name of SSH keypair to grant access to instance. Default: - No SSH access will be possible.
         :param key_pair: The SSH keypair to grant access to the instance. Default: - No SSH access will be possible.
         :param placement_group: The placement group that you want to launch the instance into. Default: - no placement group will be used for this instance.
@@ -72391,6 +72509,7 @@ class Instance(
             init_options=init_options,
             instance_initiated_shutdown_behavior=instance_initiated_shutdown_behavior,
             instance_name=instance_name,
+            ipv6_address_count=ipv6_address_count,
             key_name=key_name,
             key_pair=key_pair,
             placement_group=placement_group,
@@ -73197,6 +73316,7 @@ class InstanceInitiatedShutdownBehavior(enum.Enum):
         "init_options": "initOptions",
         "instance_initiated_shutdown_behavior": "instanceInitiatedShutdownBehavior",
         "instance_name": "instanceName",
+        "ipv6_address_count": "ipv6AddressCount",
         "key_name": "keyName",
         "key_pair": "keyPair",
         "placement_group": "placementGroup",
@@ -73234,6 +73354,7 @@ class InstanceProps:
         init_options: typing.Optional[typing.Union[ApplyCloudFormationInitOptions, typing.Dict[builtins.str, typing.Any]]] = None,
         instance_initiated_shutdown_behavior: typing.Optional[InstanceInitiatedShutdownBehavior] = None,
         instance_name: typing.Optional[builtins.str] = None,
+        ipv6_address_count: typing.Optional[jsii.Number] = None,
         key_name: typing.Optional[builtins.str] = None,
         key_pair: typing.Optional[IKeyPair] = None,
         placement_group: typing.Optional[IPlacementGroup] = None,
@@ -73256,7 +73377,7 @@ class InstanceProps:
         :param vpc: VPC to launch the instance in.
         :param allow_all_ipv6_outbound: Whether the instance could initiate IPv6 connections to anywhere by default. This property is only used when you do not provide a security group. Default: false
         :param allow_all_outbound: Whether the instance could initiate connections to anywhere by default. This property is only used when you do not provide a security group. Default: true
-        :param associate_public_ip_address: Whether to associate a public IP address to the primary network interface attached to this instance. Default: - public IP address is automatically assigned based on default behavior
+        :param associate_public_ip_address: Whether to associate a public IP address to the primary network interface attached to this instance. You cannot specify this property and ``ipv6AddressCount`` at the same time. Default: - public IP address is automatically assigned based on default behavior
         :param availability_zone: In which AZ to place the instance within the VPC. Default: - Random zone.
         :param block_devices: Specifies how block devices are exposed to the instance. You can specify virtual devices and EBS volumes. Each instance that is launched has an associated root device volume, either an Amazon EBS volume or an instance store volume. You can use block device mappings to specify additional EBS volumes or instance store volumes to attach to an instance when it is launched. Default: - Uses the block device mapping of the AMI
         :param credit_specification: Specifying the CPU credit type for burstable EC2 instance types (T2, T3, T3a, etc). The unlimited CPU credit option is not supported for T3 instances with a dedicated host. Default: - T2 instances are standard, while T3, T4g, and T3a instances are unlimited.
@@ -73268,6 +73389,7 @@ class InstanceProps:
         :param init_options: Use the given options for applying CloudFormation Init. Describes the configsets to use and the timeout to wait Default: - default options
         :param instance_initiated_shutdown_behavior: Indicates whether an instance stops or terminates when you initiate shutdown from the instance (using the operating system command for system shutdown). Default: InstanceInitiatedShutdownBehavior.STOP
         :param instance_name: The name of the instance. Default: - CDK generated name
+        :param ipv6_address_count: The number of IPv6 addresses to associate with the primary network interface. Amazon EC2 chooses the IPv6 addresses from the range of your subnet. You cannot specify this property and ``associatePublicIpAddress`` at the same time. Default: - For instances associated with an IPv6 subnet, use 1; otherwise, use 0.
         :param key_name: (deprecated) Name of SSH keypair to grant access to instance. Default: - No SSH access will be possible.
         :param key_pair: The SSH keypair to grant access to the instance. Default: - No SSH access will be possible.
         :param placement_group: The placement group that you want to launch the instance into. Default: - no placement group will be used for this instance.
@@ -73325,6 +73447,7 @@ class InstanceProps:
             check_type(argname="argument init_options", value=init_options, expected_type=type_hints["init_options"])
             check_type(argname="argument instance_initiated_shutdown_behavior", value=instance_initiated_shutdown_behavior, expected_type=type_hints["instance_initiated_shutdown_behavior"])
             check_type(argname="argument instance_name", value=instance_name, expected_type=type_hints["instance_name"])
+            check_type(argname="argument ipv6_address_count", value=ipv6_address_count, expected_type=type_hints["ipv6_address_count"])
             check_type(argname="argument key_name", value=key_name, expected_type=type_hints["key_name"])
             check_type(argname="argument key_pair", value=key_pair, expected_type=type_hints["key_pair"])
             check_type(argname="argument placement_group", value=placement_group, expected_type=type_hints["placement_group"])
@@ -73372,6 +73495,8 @@ class InstanceProps:
             self._values["instance_initiated_shutdown_behavior"] = instance_initiated_shutdown_behavior
         if instance_name is not None:
             self._values["instance_name"] = instance_name
+        if ipv6_address_count is not None:
+            self._values["ipv6_address_count"] = ipv6_address_count
         if key_name is not None:
             self._values["key_name"] = key_name
         if key_pair is not None:
@@ -73448,6 +73573,8 @@ class InstanceProps:
     def associate_public_ip_address(self) -> typing.Optional[builtins.bool]:
         '''Whether to associate a public IP address to the primary network interface attached to this instance.
 
+        You cannot specify this property and ``ipv6AddressCount`` at the same time.
+
         :default: - public IP address is automatically assigned based on default behavior
         '''
         result = self._values.get("associate_public_ip_address")
@@ -73585,6 +73712,19 @@ class InstanceProps:
         result = self._values.get("instance_name")
         return typing.cast(typing.Optional[builtins.str], result)
 
+    @builtins.property
+    def ipv6_address_count(self) -> typing.Optional[jsii.Number]:
+        '''The number of IPv6 addresses to associate with the primary network interface.
+
+        Amazon EC2 chooses the IPv6 addresses from the range of your subnet.
+
+        You cannot specify this property and ``associatePublicIpAddress`` at the same time.
+
+        :default: - For instances associated with an IPv6 subnet, use 1; otherwise, use 0.
+        '''
+        result = self._values.get("ipv6_address_count")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def key_name(self) -> typing.Optional[builtins.str]:
         '''(deprecated) Name of SSH keypair to grant access to instance.
@@ -84664,16 +84804,18 @@ class SubnetType(enum.Enum):
 
         # vpc: ec2.Vpc
         
-        cluster = rds.DatabaseCluster(self, "Database",
-            engine=rds.DatabaseClusterEngine.aurora_mysql(
-                version=rds.AuroraMysqlEngineVersion.VER_3_03_0
+        
+        cluster = docdb.DatabaseCluster(self, "Database",
+            master_user=docdb.Login(
+                username="myuser"
             ),
-            instances=2,
-            instance_props=rds.InstanceProps(
-                instance_type=ec2.InstanceType.of(ec2.InstanceClass.BURSTABLE3, ec2.InstanceSize.SMALL),
-                vpc_subnets=ec2.SubnetSelection(subnet_type=ec2.SubnetType.PUBLIC),
-                vpc=vpc
-            )
+            instance_type=ec2.InstanceType.of(ec2.InstanceClass.MEMORY5, ec2.InstanceSize.LARGE),
+            vpc_subnets=ec2.SubnetSelection(
+                subnet_type=ec2.SubnetType.PUBLIC
+            ),
+            vpc=vpc,
+            removal_policy=RemovalPolicy.SNAPSHOT,
+            instance_removal_policy=RemovalPolicy.RETAIN
         )
     '''
 
@@ -90388,6 +90530,7 @@ class DestinationOptions(S3DestinationOptions):
     name_mapping={
         "delete_on_termination": "deleteOnTermination",
         "iops": "iops",
+        "throughput": "throughput",
         "volume_type": "volumeType",
         "encrypted": "encrypted",
         "kms_key": "kmsKey",
@@ -90399,6 +90542,7 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
         *,
         delete_on_termination: typing.Optional[builtins.bool] = None,
         iops: typing.Optional[jsii.Number] = None,
+        throughput: typing.Optional[jsii.Number] = None,
         volume_type: typing.Optional[EbsDeviceVolumeType] = None,
         encrypted: typing.Optional[builtins.bool] = None,
         kms_key: typing.Optional[_IKey_5f11635f] = None,
@@ -90407,6 +90551,7 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
 
         :param delete_on_termination: Indicates whether to delete the volume when the instance is terminated. Default: - true for Amazon EC2 Auto Scaling, false otherwise (e.g. EBS)
         :param iops: 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``
+        :param throughput: The throughput to provision for a ``gp3`` volume. Valid Range: Minimum value of 125. Maximum value of 1000. ``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.
         :param volume_type: The EBS volume type. Default: ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD`` or ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD_GP3`` if ``@aws-cdk/aws-ec2:ebsDefaultGp3Volume`` is enabled.
         :param encrypted: Specifies whether the EBS volume is encrypted. Encrypted EBS volumes can only be attached to instances that support Amazon EBS encryption Default: false
         :param kms_key: The ARN of the AWS Key Management Service (AWS KMS) CMK used for encryption. You have to ensure that the KMS CMK has the correct permissions to be used by the service launching the ec2 instances. Default: - If encrypted is true, the default aws/ebs KMS key will be used.
@@ -90415,15 +90560,11 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
 
         Example::
 
-            from aws_cdk.aws_kms import Key
-            
             # vpc: ec2.Vpc
             # instance_type: ec2.InstanceType
             # machine_image: ec2.IMachineImage
             
             
-            kms_key = Key(self, "KmsKey")
-            
             ec2.Instance(self, "Instance",
                 vpc=vpc,
                 instance_type=instance_type,
@@ -90433,9 +90574,9 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
             
                 block_devices=[ec2.BlockDevice(
                     device_name="/dev/sda1",
-                    volume=ec2.BlockDeviceVolume.ebs(50,
-                        encrypted=True,
-                        kms_key=kms_key
+                    volume=ec2.BlockDeviceVolume.ebs(100,
+                        volume_type=ec2.EbsDeviceVolumeType.GP3,
+                        throughput=250
                     )
                 )
                 ]
@@ -90445,6 +90586,7 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
             type_hints = typing.get_type_hints(_typecheckingstub__9009756b359157c5d2b270f95428640becaa73def15e04ee91f0eceba0702608)
             check_type(argname="argument delete_on_termination", value=delete_on_termination, expected_type=type_hints["delete_on_termination"])
             check_type(argname="argument iops", value=iops, expected_type=type_hints["iops"])
+            check_type(argname="argument throughput", value=throughput, expected_type=type_hints["throughput"])
             check_type(argname="argument volume_type", value=volume_type, expected_type=type_hints["volume_type"])
             check_type(argname="argument encrypted", value=encrypted, expected_type=type_hints["encrypted"])
             check_type(argname="argument kms_key", value=kms_key, expected_type=type_hints["kms_key"])
@@ -90453,6 +90595,8 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
             self._values["delete_on_termination"] = delete_on_termination
         if iops is not None:
             self._values["iops"] = iops
+        if throughput is not None:
+            self._values["throughput"] = throughput
         if volume_type is not None:
             self._values["volume_type"] = volume_type
         if encrypted is not None:
@@ -90485,6 +90629,22 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
         result = self._values.get("iops")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def throughput(self) -> typing.Optional[jsii.Number]:
+        '''The throughput to provision for a ``gp3`` volume.
+
+        Valid Range: Minimum value of 125. Maximum value of 1000.
+
+        ``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.
+
+        :see: https://docs.aws.amazon.com/ebs/latest/userguide/general-purpose.html#gp3-performance
+        '''
+        result = self._values.get("throughput")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def volume_type(self) -> typing.Optional[EbsDeviceVolumeType]:
         '''The EBS volume type.
@@ -90543,6 +90703,7 @@ class EbsDeviceOptions(EbsDeviceOptionsBase):
     name_mapping={
         "delete_on_termination": "deleteOnTermination",
         "iops": "iops",
+        "throughput": "throughput",
         "volume_type": "volumeType",
         "volume_size": "volumeSize",
         "encrypted": "encrypted",
@@ -90556,6 +90717,7 @@ class EbsDeviceProps(EbsDeviceSnapshotOptions, EbsDeviceOptions):
         *,
         delete_on_termination: typing.Optional[builtins.bool] = None,
         iops: typing.Optional[jsii.Number] = None,
+        throughput: typing.Optional[jsii.Number] = None,
         volume_type: typing.Optional[EbsDeviceVolumeType] = None,
         volume_size: typing.Optional[jsii.Number] = None,
         encrypted: typing.Optional[builtins.bool] = None,
@@ -90566,6 +90728,7 @@ class EbsDeviceProps(EbsDeviceSnapshotOptions, EbsDeviceOptions):
 
         :param delete_on_termination: Indicates whether to delete the volume when the instance is terminated. Default: - true for Amazon EC2 Auto Scaling, false otherwise (e.g. EBS)
         :param iops: 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``
+        :param throughput: The throughput to provision for a ``gp3`` volume. Valid Range: Minimum value of 125. Maximum value of 1000. ``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.
         :param volume_type: The EBS volume type. Default: ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD`` or ``EbsDeviceVolumeType.GENERAL_PURPOSE_SSD_GP3`` if ``@aws-cdk/aws-ec2:ebsDefaultGp3Volume`` is enabled.
         :param volume_size: The volume size, in Gibibytes (GiB). If you specify volumeSize, it must be equal or greater than the size of the snapshot. Default: - The snapshot size
         :param encrypted: Specifies whether the EBS volume is encrypted. Encrypted EBS volumes can only be attached to instances that support Amazon EBS encryption Default: false
@@ -90589,6 +90752,7 @@ class EbsDeviceProps(EbsDeviceSnapshotOptions, EbsDeviceOptions):
                 iops=123,
                 kms_key=key,
                 snapshot_id="snapshotId",
+                throughput=123,
                 volume_size=123,
                 volume_type=ec2.EbsDeviceVolumeType.STANDARD
             )
@@ -90597,6 +90761,7 @@ class EbsDeviceProps(EbsDeviceSnapshotOptions, EbsDeviceOptions):
             type_hints = typing.get_type_hints(_typecheckingstub__9a0ea3e2bab0709f4d926738afbd8d5ecbd17847b51fb29600f577de41f87b90)
             check_type(argname="argument delete_on_termination", value=delete_on_termination, expected_type=type_hints["delete_on_termination"])
             check_type(argname="argument iops", value=iops, expected_type=type_hints["iops"])
+            check_type(argname="argument throughput", value=throughput, expected_type=type_hints["throughput"])
             check_type(argname="argument volume_type", value=volume_type, expected_type=type_hints["volume_type"])
             check_type(argname="argument volume_size", value=volume_size, expected_type=type_hints["volume_size"])
             check_type(argname="argument encrypted", value=encrypted, expected_type=type_hints["encrypted"])
@@ -90607,6 +90772,8 @@ class EbsDeviceProps(EbsDeviceSnapshotOptions, EbsDeviceOptions):
             self._values["delete_on_termination"] = delete_on_termination
         if iops is not None:
             self._values["iops"] = iops
+        if throughput is not None:
+            self._values["throughput"] = throughput
         if volume_type is not None:
             self._values["volume_type"] = volume_type
         if volume_size is not None:
@@ -90643,6 +90810,22 @@ class EbsDeviceProps(EbsDeviceSnapshotOptions, EbsDeviceOptions):
         result = self._values.get("iops")
         return typing.cast(typing.Optional[jsii.Number], result)
 
+    @builtins.property
+    def throughput(self) -> typing.Optional[jsii.Number]:
+        '''The throughput to provision for a ``gp3`` volume.
+
+        Valid Range: Minimum value of 125. Maximum value of 1000.
+
+        ``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.
+
+        :see: https://docs.aws.amazon.com/ebs/latest/userguide/general-purpose.html#gp3-performance
+        '''
+        result = self._values.get("throughput")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def volume_type(self) -> typing.Optional[EbsDeviceVolumeType]:
         '''The EBS volume type.
@@ -95142,6 +95325,7 @@ def _typecheckingstub__e34634be08d573bd7d4eca032a2a66e619c889f2b51e62608777ae0db
     kms_key: typing.Optional[_IKey_5f11635f] = None,
     delete_on_termination: typing.Optional[builtins.bool] = None,
     iops: typing.Optional[jsii.Number] = None,
+    throughput: typing.Optional[jsii.Number] = None,
     volume_type: typing.Optional[EbsDeviceVolumeType] = None,
 ) -> None:
     """Type checking stubs"""
@@ -95153,6 +95337,7 @@ def _typecheckingstub__ce9e60bc1da1c6f1d133c0cfaad0c5984d2f7a428c12f02640d8f31c6
     volume_size: typing.Optional[jsii.Number] = None,
     delete_on_termination: typing.Optional[builtins.bool] = None,
     iops: typing.Optional[jsii.Number] = None,
+    throughput: typing.Optional[jsii.Number] = None,
     volume_type: typing.Optional[EbsDeviceVolumeType] = None,
 ) -> None:
     """Type checking stubs"""
@@ -104074,6 +104259,7 @@ def _typecheckingstub__0d06a3c480f0a868f3c69b22935c359322b1d9337591dc27bb141d518
     *,
     delete_on_termination: typing.Optional[builtins.bool] = None,
     iops: typing.Optional[jsii.Number] = None,
+    throughput: typing.Optional[jsii.Number] = None,
     volume_type: typing.Optional[EbsDeviceVolumeType] = None,
 ) -> None:
     """Type checking stubs"""
@@ -104083,6 +104269,7 @@ def _typecheckingstub__4602c5be3c93ca5d255adf8aa3a652b8c7898310f96514ecd6fc09f7d
     *,
     delete_on_termination: typing.Optional[builtins.bool] = None,
     iops: typing.Optional[jsii.Number] = None,
+    throughput: typing.Optional[jsii.Number] = None,
     volume_type: typing.Optional[EbsDeviceVolumeType] = None,
     volume_size: typing.Optional[jsii.Number] = None,
 ) -> None:
@@ -104816,6 +105003,7 @@ def _typecheckingstub__5fdf31f5ae2497c7efcb56df558011698f38dc19cff28ca7a78a08a6d
     init_options: typing.Optional[typing.Union[ApplyCloudFormationInitOptions, typing.Dict[builtins.str, typing.Any]]] = None,
     instance_initiated_shutdown_behavior: typing.Optional[InstanceInitiatedShutdownBehavior] = None,
     instance_name: typing.Optional[builtins.str] = None,
+    ipv6_address_count: typing.Optional[jsii.Number] = None,
     key_name: typing.Optional[builtins.str] = None,
     key_pair: typing.Optional[IKeyPair] = None,
     placement_group: typing.Optional[IPlacementGroup] = None,
@@ -104885,6 +105073,7 @@ def _typecheckingstub__2d4dc63c6e6ee3ddc68d5dd204d8ac5ef1f1dec37a7b84d636225df1c
     init_options: typing.Optional[typing.Union[ApplyCloudFormationInitOptions, typing.Dict[builtins.str, typing.Any]]] = None,
     instance_initiated_shutdown_behavior: typing.Optional[InstanceInitiatedShutdownBehavior] = None,
     instance_name: typing.Optional[builtins.str] = None,
+    ipv6_address_count: typing.Optional[jsii.Number] = None,
     key_name: typing.Optional[builtins.str] = None,
     key_pair: typing.Optional[IKeyPair] = None,
     placement_group: typing.Optional[IPlacementGroup] = None,
@@ -106607,6 +106796,7 @@ def _typecheckingstub__9009756b359157c5d2b270f95428640becaa73def15e04ee91f0eceba
     *,
     delete_on_termination: typing.Optional[builtins.bool] = None,
     iops: typing.Optional[jsii.Number] = None,
+    throughput: typing.Optional[jsii.Number] = None,
     volume_type: typing.Optional[EbsDeviceVolumeType] = None,
     encrypted: typing.Optional[builtins.bool] = None,
     kms_key: typing.Optional[_IKey_5f11635f] = None,
@@ -106618,6 +106808,7 @@ def _typecheckingstub__9a0ea3e2bab0709f4d926738afbd8d5ecbd17847b51fb29600f577de4
     *,
     delete_on_termination: typing.Optional[builtins.bool] = None,
     iops: typing.Optional[jsii.Number] = None,
+    throughput: typing.Optional[jsii.Number] = None,
     volume_type: typing.Optional[EbsDeviceVolumeType] = None,
     volume_size: typing.Optional[jsii.Number] = None,
     encrypted: typing.Optional[builtins.bool] = None,