aws-cdk-lib 2.146.0__py3-none-any.whl → 2.147.1__py3-none-any.whl

aws_cdk/aws_fsx/__init__.py

@@ -930,6 +930,10 @@ class CfnFileSystem(
                 export_path="exportPath",
                 imported_file_chunk_size=123,
                 import_path="importPath",
+                metadata_configuration=fsx.CfnFileSystem.MetadataConfigurationProperty(
+                    iops=123,
+                    mode="mode"
+                ),
                 per_unit_storage_throughput=123,
                 weekly_maintenance_start_time="weeklyMaintenanceStartTime"
             ),
@@ -1055,7 +1059,7 @@ class CfnFileSystem(
         :param file_system_type: The type of Amazon FSx file system, which can be ``LUSTRE`` , ``WINDOWS`` , ``ONTAP`` , or ``OPENZFS`` .
         :param subnet_ids: Specifies the IDs of the subnets that the file system will be accessible from. For Windows and ONTAP ``MULTI_AZ_1`` deployment types,provide exactly two subnet IDs, one for the preferred file server and one for the standby file server. You specify one of these subnets as the preferred subnet using the ``WindowsConfiguration > PreferredSubnetID`` or ``OntapConfiguration > PreferredSubnetID`` properties. For more information about Multi-AZ file system configuration, see `Availability and durability: Single-AZ and Multi-AZ file systems <https://docs.aws.amazon.com/fsx/latest/WindowsGuide/high-availability-multiAZ.html>`_ in the *Amazon FSx for Windows User Guide* and `Availability and durability <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/high-availability-multiAZ.html>`_ in the *Amazon FSx for ONTAP User Guide* . For Windows ``SINGLE_AZ_1`` and ``SINGLE_AZ_2`` and all Lustre deployment types, provide exactly one subnet ID. The file server is launched in that subnet's Availability Zone.
         :param backup_id: The ID of the file system backup that you are using to create a file system. For more information, see `CreateFileSystemFromBackup <https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystemFromBackup.html>`_ .
-        :param file_system_type_version: (Optional) For FSx for Lustre file systems, sets the Lustre version for the file system that you're creating. Valid values are ``2.10`` , ``2.12`` , and ``2.15`` : - 2.10 is supported by the Scratch and Persistent_1 Lustre deployment types. - 2.12 and 2.15 are supported by all Lustre deployment types. ``2.12`` or ``2.15`` is required when setting FSx for Lustre ``DeploymentType`` to ``PERSISTENT_2`` . Default value = ``2.10`` , except when ``DeploymentType`` is set to ``PERSISTENT_2`` , then the default is ``2.12`` . .. epigraph:: If you set ``FileSystemTypeVersion`` to ``2.10`` for a ``PERSISTENT_2`` Lustre deployment type, the ``CreateFileSystem`` operation fails.
+        :param file_system_type_version: For FSx for Lustre file systems, sets the Lustre version for the file system that you're creating. Valid values are ``2.10`` , ``2.12`` , and ``2.15`` : - ``2.10`` is supported by the Scratch and Persistent_1 Lustre deployment types. - ``2.12`` is supported by all Lustre deployment types, except for ``PERSISTENT_2`` with a metadata configuration mode. - ``2.15`` is supported by all Lustre deployment types and is recommended for all new file systems. Default value is ``2.10`` , except for the following deployments: - Default value is ``2.12`` when ``DeploymentType`` is set to ``PERSISTENT_2`` without a metadata configuration mode. - Default value is ``2.15`` when ``DeploymentType`` is set to ``PERSISTENT_2`` with a metadata configuration mode.
         :param kms_key_id: The ID of the AWS Key Management Service ( AWS KMS ) key used to encrypt Amazon FSx file system data. Used as follows with Amazon FSx file system types: - Amazon FSx for Lustre ``PERSISTENT_1`` and ``PERSISTENT_2`` deployment types only. ``SCRATCH_1`` and ``SCRATCH_2`` types are encrypted using the Amazon FSx service AWS KMS key for your account. - Amazon FSx for NetApp ONTAP - Amazon FSx for OpenZFS - Amazon FSx for Windows File Server
         :param lustre_configuration: The Lustre configuration for the file system being created. .. epigraph:: The following parameters are not supported when creating Lustre file systems with a data repository association. - ``AutoImportPolicy`` - ``ExportPath`` - ``ImportedChunkSize`` - ``ImportPath``
         :param ontap_configuration: The ONTAP configuration properties of the FSx for ONTAP file system that you are creating.
@@ -1225,7 +1229,7 @@ class CfnFileSystem(
     @builtins.property
     @jsii.member(jsii_name="fileSystemTypeVersion")
     def file_system_type_version(self) -> typing.Optional[builtins.str]:
-        '''(Optional) For FSx for Lustre file systems, sets the Lustre version for the file system that you're creating.'''
+        '''For FSx for Lustre file systems, sets the Lustre version for the file system that you're creating.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "fileSystemTypeVersion"))
 
     @file_system_type_version.setter
@@ -1653,6 +1657,7 @@ class CfnFileSystem(
             "export_path": "exportPath",
             "imported_file_chunk_size": "importedFileChunkSize",
             "import_path": "importPath",
+            "metadata_configuration": "metadataConfiguration",
             "per_unit_storage_throughput": "perUnitStorageThroughput",
             "weekly_maintenance_start_time": "weeklyMaintenanceStartTime",
         },
@@ -1671,6 +1676,7 @@ class CfnFileSystem(
             export_path: typing.Optional[builtins.str] = None,
             imported_file_chunk_size: typing.Optional[jsii.Number] = None,
             import_path: typing.Optional[builtins.str] = None,
+            metadata_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnFileSystem.MetadataConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             per_unit_storage_throughput: typing.Optional[jsii.Number] = None,
             weekly_maintenance_start_time: typing.Optional[builtins.str] = None,
         ) -> None:
@@ -1681,11 +1687,12 @@ class CfnFileSystem(
             :param copy_tags_to_backups: (Optional) Not available for use with file systems that are linked to a data repository. A boolean flag indicating whether tags for the file system should be copied to backups. The default value is false. If ``CopyTagsToBackups`` is set to true, all file system tags are copied to all automatic and user-initiated backups when the user doesn't specify any backup-specific tags. If ``CopyTagsToBackups`` is set to true and you specify one or more backup tags, only the specified tags are copied to backups. If you specify one or more tags when creating a user-initiated backup, no tags are copied from the file system, regardless of this value. (Default = ``false`` ) For more information, see `Working with backups <https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-backups-fsx.html>`_ in the *Amazon FSx for Lustre User Guide* .
             :param daily_automatic_backup_start_time: A recurring daily time, in the format ``HH:MM`` . ``HH`` is the zero-padded hour of the day (0-23), and ``MM`` is the zero-padded minute of the hour. For example, ``05:00`` specifies 5 AM daily.
             :param data_compression_type: Sets the data compression configuration for the file system. ``DataCompressionType`` can have the following values:. - ``NONE`` - (Default) Data compression is turned off when the file system is created. - ``LZ4`` - Data compression is turned on with the LZ4 algorithm. For more information, see `Lustre data compression <https://docs.aws.amazon.com/fsx/latest/LustreGuide/data-compression.html>`_ in the *Amazon FSx for Lustre User Guide* .
-            :param deployment_type: (Optional) Choose ``SCRATCH_1`` and ``SCRATCH_2`` deployment types when you need temporary storage and shorter-term processing of data. The ``SCRATCH_2`` deployment type provides in-transit encryption of data and higher burst throughput capacity than ``SCRATCH_1`` . Choose ``PERSISTENT_1`` for longer-term storage and for throughput-focused workloads that aren’t latency-sensitive. ``PERSISTENT_1`` supports encryption of data in transit, and is available in all AWS Regions in which FSx for Lustre is available. Choose ``PERSISTENT_2`` for longer-term storage and for latency-sensitive workloads that require the highest levels of IOPS/throughput. ``PERSISTENT_2`` supports SSD storage, and offers higher ``PerUnitStorageThroughput`` (up to 1000 MB/s/TiB). ``PERSISTENT_2`` is available in a limited number of AWS Regions . For more information, and an up-to-date list of AWS Regions in which ``PERSISTENT_2`` is available, see `File system deployment options for FSx for Lustre <https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-deployment-types>`_ in the *Amazon FSx for Lustre User Guide* . .. epigraph:: If you choose ``PERSISTENT_2`` , and you set ``FileSystemTypeVersion`` to ``2.10`` , the ``CreateFileSystem`` operation fails. Encryption of data in transit is automatically turned on when you access ``SCRATCH_2`` , ``PERSISTENT_1`` and ``PERSISTENT_2`` file systems from Amazon EC2 instances that support automatic encryption in the AWS Regions where they are available. For more information about encryption in transit for FSx for Lustre file systems, see `Encrypting data in transit <https://docs.aws.amazon.com/fsx/latest/LustreGuide/encryption-in-transit-fsxl.html>`_ in the *Amazon FSx for Lustre User Guide* . (Default = ``SCRATCH_1`` )
+            :param deployment_type: (Optional) Choose ``SCRATCH_1`` and ``SCRATCH_2`` deployment types when you need temporary storage and shorter-term processing of data. The ``SCRATCH_2`` deployment type provides in-transit encryption of data and higher burst throughput capacity than ``SCRATCH_1`` . Choose ``PERSISTENT_1`` for longer-term storage and for throughput-focused workloads that aren’t latency-sensitive. ``PERSISTENT_1`` supports encryption of data in transit, and is available in all AWS Regions in which FSx for Lustre is available. Choose ``PERSISTENT_2`` for longer-term storage and for latency-sensitive workloads that require the highest levels of IOPS/throughput. ``PERSISTENT_2`` supports SSD storage, and offers higher ``PerUnitStorageThroughput`` (up to 1000 MB/s/TiB). You can optionally specify a metadata configuration mode for ``PERSISTENT_2`` which supports increasing metadata performance. ``PERSISTENT_2`` is available in a limited number of AWS Regions . For more information, and an up-to-date list of AWS Regions in which ``PERSISTENT_2`` is available, see `File system deployment options for FSx for Lustre <https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-deployment-types>`_ in the *Amazon FSx for Lustre User Guide* . .. epigraph:: If you choose ``PERSISTENT_2`` , and you set ``FileSystemTypeVersion`` to ``2.10`` , the ``CreateFileSystem`` operation fails. Encryption of data in transit is automatically turned on when you access ``SCRATCH_2`` , ``PERSISTENT_1`` , and ``PERSISTENT_2`` file systems from Amazon EC2 instances that support automatic encryption in the AWS Regions where they are available. For more information about encryption in transit for FSx for Lustre file systems, see `Encrypting data in transit <https://docs.aws.amazon.com/fsx/latest/LustreGuide/encryption-in-transit-fsxl.html>`_ in the *Amazon FSx for Lustre User Guide* . (Default = ``SCRATCH_1`` )
             :param drive_cache_type: The type of drive cache used by ``PERSISTENT_1`` file systems that are provisioned with HDD storage devices. This parameter is required when storage type is HDD. Set this property to ``READ`` to improve the performance for frequently accessed files by caching up to 20% of the total storage capacity of the file system. This parameter is required when ``StorageType`` is set to ``HDD`` and ``DeploymentType`` is ``PERSISTENT_1`` .
             :param export_path: (Optional) Specifies the path in the Amazon S3 bucket where the root of your Amazon FSx file system is exported. The path must use the same Amazon S3 bucket as specified in ImportPath. You can provide an optional prefix to which new and changed data is to be exported from your Amazon FSx for Lustre file system. If an ``ExportPath`` value is not provided, Amazon FSx sets a default export path, ``s3://import-bucket/FSxLustre[creation-timestamp]`` . The timestamp is in UTC format, for example ``s3://import-bucket/FSxLustre20181105T222312Z`` . The Amazon S3 export bucket must be the same as the import bucket specified by ``ImportPath`` . If you specify only a bucket name, such as ``s3://import-bucket`` , you get a 1:1 mapping of file system objects to S3 bucket objects. This mapping means that the input data in S3 is overwritten on export. If you provide a custom prefix in the export path, such as ``s3://import-bucket/[custom-optional-prefix]`` , Amazon FSx exports the contents of your file system to that export prefix in the Amazon S3 bucket. .. epigraph:: This parameter is not supported for file systems with a data repository association.
             :param imported_file_chunk_size: (Optional) For files imported from a data repository, this value determines the stripe count and maximum amount of data per file (in MiB) stored on a single physical disk. The maximum number of disks that a single file can be striped across is limited by the total number of disks that make up the file system. The default chunk size is 1,024 MiB (1 GiB) and can go as high as 512,000 MiB (500 GiB). Amazon S3 objects have a maximum size of 5 TB. .. epigraph:: This parameter is not supported for Lustre file systems with a data repository association.
             :param import_path: (Optional) The path to the Amazon S3 bucket (including the optional prefix) that you're using as the data repository for your Amazon FSx for Lustre file system. The root of your FSx for Lustre file system will be mapped to the root of the Amazon S3 bucket you select. An example is ``s3://import-bucket/optional-prefix`` . If you specify a prefix after the Amazon S3 bucket name, only object keys with that prefix are loaded into the file system. .. epigraph:: This parameter is not supported for Lustre file systems with a data repository association.
+            :param metadata_configuration: 
             :param per_unit_storage_throughput: Required with ``PERSISTENT_1`` and ``PERSISTENT_2`` deployment types, provisions the amount of read and write throughput for each 1 tebibyte (TiB) of file system storage capacity, in MB/s/TiB. File system throughput capacity is calculated by multiplying file system storage capacity (TiB) by the ``PerUnitStorageThroughput`` (MB/s/TiB). For a 2.4-TiB file system, provisioning 50 MB/s/TiB of ``PerUnitStorageThroughput`` yields 120 MB/s of file system throughput. You pay for the amount of throughput that you provision. Valid values: - For ``PERSISTENT_1`` SSD storage: 50, 100, 200 MB/s/TiB. - For ``PERSISTENT_1`` HDD storage: 12, 40 MB/s/TiB. - For ``PERSISTENT_2`` SSD storage: 125, 250, 500, 1000 MB/s/TiB.
             :param weekly_maintenance_start_time: A recurring weekly time, in the format ``D:HH:MM`` . ``D`` is the day of the week, for which 1 represents Monday and 7 represents Sunday. For further details, see `the ISO-8601 spec as described on Wikipedia <https://docs.aws.amazon.com/https://en.wikipedia.org/wiki/ISO_week_date>`_ . ``HH`` is the zero-padded hour of the day (0-23), and ``MM`` is the zero-padded minute of the hour. For example, ``1:05:00`` specifies maintenance at 5 AM Monday.
 
@@ -1709,6 +1716,10 @@ class CfnFileSystem(
                     export_path="exportPath",
                     imported_file_chunk_size=123,
                     import_path="importPath",
+                    metadata_configuration=fsx.CfnFileSystem.MetadataConfigurationProperty(
+                        iops=123,
+                        mode="mode"
+                    ),
                     per_unit_storage_throughput=123,
                     weekly_maintenance_start_time="weeklyMaintenanceStartTime"
                 )
@@ -1725,6 +1736,7 @@ class CfnFileSystem(
                 check_type(argname="argument export_path", value=export_path, expected_type=type_hints["export_path"])
                 check_type(argname="argument imported_file_chunk_size", value=imported_file_chunk_size, expected_type=type_hints["imported_file_chunk_size"])
                 check_type(argname="argument import_path", value=import_path, expected_type=type_hints["import_path"])
+                check_type(argname="argument metadata_configuration", value=metadata_configuration, expected_type=type_hints["metadata_configuration"])
                 check_type(argname="argument per_unit_storage_throughput", value=per_unit_storage_throughput, expected_type=type_hints["per_unit_storage_throughput"])
                 check_type(argname="argument weekly_maintenance_start_time", value=weekly_maintenance_start_time, expected_type=type_hints["weekly_maintenance_start_time"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
@@ -1748,6 +1760,8 @@ class CfnFileSystem(
                 self._values["imported_file_chunk_size"] = imported_file_chunk_size
             if import_path is not None:
                 self._values["import_path"] = import_path
+            if metadata_configuration is not None:
+                self._values["metadata_configuration"] = metadata_configuration
             if per_unit_storage_throughput is not None:
                 self._values["per_unit_storage_throughput"] = per_unit_storage_throughput
             if weekly_maintenance_start_time is not None:
@@ -1835,12 +1849,12 @@ class CfnFileSystem(
 
             Choose ``PERSISTENT_1`` for longer-term storage and for throughput-focused workloads that aren’t latency-sensitive. ``PERSISTENT_1`` supports encryption of data in transit, and is available in all AWS Regions in which FSx for Lustre is available.
 
-            Choose ``PERSISTENT_2`` for longer-term storage and for latency-sensitive workloads that require the highest levels of IOPS/throughput. ``PERSISTENT_2`` supports SSD storage, and offers higher ``PerUnitStorageThroughput`` (up to 1000 MB/s/TiB). ``PERSISTENT_2`` is available in a limited number of AWS Regions . For more information, and an up-to-date list of AWS Regions in which ``PERSISTENT_2`` is available, see `File system deployment options for FSx for Lustre <https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-deployment-types>`_ in the *Amazon FSx for Lustre User Guide* .
+            Choose ``PERSISTENT_2`` for longer-term storage and for latency-sensitive workloads that require the highest levels of IOPS/throughput. ``PERSISTENT_2`` supports SSD storage, and offers higher ``PerUnitStorageThroughput`` (up to 1000 MB/s/TiB). You can optionally specify a metadata configuration mode for ``PERSISTENT_2`` which supports increasing metadata performance. ``PERSISTENT_2`` is available in a limited number of AWS Regions . For more information, and an up-to-date list of AWS Regions in which ``PERSISTENT_2`` is available, see `File system deployment options for FSx for Lustre <https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-deployment-types>`_ in the *Amazon FSx for Lustre User Guide* .
             .. epigraph::
 
                If you choose ``PERSISTENT_2`` , and you set ``FileSystemTypeVersion`` to ``2.10`` , the ``CreateFileSystem`` operation fails.
 
-            Encryption of data in transit is automatically turned on when you access ``SCRATCH_2`` , ``PERSISTENT_1`` and ``PERSISTENT_2`` file systems from Amazon EC2 instances that support automatic encryption in the AWS Regions where they are available. For more information about encryption in transit for FSx for Lustre file systems, see `Encrypting data in transit <https://docs.aws.amazon.com/fsx/latest/LustreGuide/encryption-in-transit-fsxl.html>`_ in the *Amazon FSx for Lustre User Guide* .
+            Encryption of data in transit is automatically turned on when you access ``SCRATCH_2`` , ``PERSISTENT_1`` , and ``PERSISTENT_2`` file systems from Amazon EC2 instances that support automatic encryption in the AWS Regions where they are available. For more information about encryption in transit for FSx for Lustre file systems, see `Encrypting data in transit <https://docs.aws.amazon.com/fsx/latest/LustreGuide/encryption-in-transit-fsxl.html>`_ in the *Amazon FSx for Lustre User Guide* .
 
             (Default = ``SCRATCH_1`` )
 
@@ -1908,6 +1922,16 @@ class CfnFileSystem(
             result = self._values.get("import_path")
             return typing.cast(typing.Optional[builtins.str], result)
 
+        @builtins.property
+        def metadata_configuration(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnFileSystem.MetadataConfigurationProperty"]]:
+            '''
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-lustreconfiguration.html#cfn-fsx-filesystem-lustreconfiguration-metadataconfiguration
+            '''
+            result = self._values.get("metadata_configuration")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnFileSystem.MetadataConfigurationProperty"]], result)
+
         @builtins.property
         def per_unit_storage_throughput(self) -> typing.Optional[jsii.Number]:
             '''Required with ``PERSISTENT_1`` and ``PERSISTENT_2`` deployment types, provisions the amount of read and write throughput for each 1 tebibyte (TiB) of file system storage capacity, in MB/s/TiB.
@@ -1951,6 +1975,73 @@ class CfnFileSystem(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_fsx.CfnFileSystem.MetadataConfigurationProperty",
+        jsii_struct_bases=[],
+        name_mapping={"iops": "iops", "mode": "mode"},
+    )
+    class MetadataConfigurationProperty:
+        def __init__(
+            self,
+            *,
+            iops: typing.Optional[jsii.Number] = None,
+            mode: typing.Optional[builtins.str] = None,
+        ) -> None:
+            '''
+            :param iops: 
+            :param mode: 
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-metadataconfiguration.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_fsx as fsx
+                
+                metadata_configuration_property = fsx.CfnFileSystem.MetadataConfigurationProperty(
+                    iops=123,
+                    mode="mode"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__7aa9a7707baff419117abba7f05ab48bf7b1de77cbcd91feed4ec16f2cb54ffc)
+                check_type(argname="argument iops", value=iops, expected_type=type_hints["iops"])
+                check_type(argname="argument mode", value=mode, expected_type=type_hints["mode"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if iops is not None:
+                self._values["iops"] = iops
+            if mode is not None:
+                self._values["mode"] = mode
+
+        @builtins.property
+        def iops(self) -> typing.Optional[jsii.Number]:
+            '''
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-metadataconfiguration.html#cfn-fsx-filesystem-metadataconfiguration-iops
+            '''
+            result = self._values.get("iops")
+            return typing.cast(typing.Optional[jsii.Number], result)
+
+        @builtins.property
+        def mode(self) -> typing.Optional[builtins.str]:
+            '''
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-metadataconfiguration.html#cfn-fsx-filesystem-metadataconfiguration-mode
+            '''
+            result = self._values.get("mode")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "MetadataConfigurationProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_fsx.CfnFileSystem.NfsExportsProperty",
         jsii_struct_bases=[],
@@ -2054,7 +2145,7 @@ class CfnFileSystem(
             :param disk_iops_configuration: The SSD IOPS configuration for the FSx for ONTAP file system.
             :param endpoint_ip_address_range: (Multi-AZ only) Specifies the IP address range in which the endpoints to access your file system will be created. By default in the Amazon FSx API, Amazon FSx selects an unused IP address range for you from the 198.19.* range. By default in the Amazon FSx console, Amazon FSx chooses the last 64 IP addresses from the VPC’s primary CIDR range to use as the endpoint IP address range for the file system. You can have overlapping endpoint IP addresses for file systems deployed in the same VPC/route tables, as long as they don't overlap with any subnet.
             :param fsx_admin_password: The ONTAP administrative password for the ``fsxadmin`` user with which you administer your file system using the NetApp ONTAP CLI and REST API.
-            :param ha_pairs: Specifies how many high-availability (HA) pairs of file servers will power your file system. Scale-up file systems are powered by 1 HA pair. The default value is 1. FSx for ONTAP scale-out file systems are powered by up to 12 HA pairs. The value of this property affects the values of ``StorageCapacity`` , ``Iops`` , and ``ThroughputCapacity`` . For more information, see `High-availability (HA) pairs <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/HA-pairs.html>`_ in the FSx for ONTAP user guide. Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions: - The value of ``HAPairs`` is less than 1 or greater than 12. - The value of ``HAPairs`` is greater than 1 and the value of ``DeploymentType`` is ``SINGLE_AZ_1`` or ``MULTI_AZ_1`` .
+            :param ha_pairs: Specifies how many high-availability (HA) pairs of file servers will power your file system. Scale-up file systems are powered by 1 HA pair. The default value is 1. FSx for ONTAP scale-out file systems are powered by up to 12 HA pairs. The value of this property affects the values of ``StorageCapacity`` , ``Iops`` , and ``ThroughputCapacity`` . For more information, see `High-availability (HA) pairs <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/administering-file-systems.html#HA-pairs>`_ in the FSx for ONTAP user guide. Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions: - The value of ``HAPairs`` is less than 1 or greater than 12. - The value of ``HAPairs`` is greater than 1 and the value of ``DeploymentType`` is ``SINGLE_AZ_1`` or ``MULTI_AZ_1`` .
             :param preferred_subnet_id: Required when ``DeploymentType`` is set to ``MULTI_AZ_1`` . This specifies the subnet in which you want the preferred file server to be located.
             :param route_table_ids: (Multi-AZ only) Specifies the route tables in which Amazon FSx creates the rules for routing traffic to the correct file server. You should specify all virtual private cloud (VPC) route tables associated with the subnets in which your clients are located. By default, Amazon FSx selects your VPC's default route table. .. epigraph:: Amazon FSx manages these route tables for Multi-AZ file systems using tag-based authentication. These route tables are tagged with ``Key: AmazonFSx; Value: ManagedByAmazonFSx`` . When creating FSx for ONTAP Multi-AZ file systems using AWS CloudFormation we recommend that you add the ``Key: AmazonFSx; Value: ManagedByAmazonFSx`` tag manually.
             :param throughput_capacity: Sets the throughput capacity for the file system that you're creating in megabytes per second (MBps). For more information, see `Managing throughput capacity <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-throughput-capacity.html>`_ in the FSx for ONTAP User Guide. Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions: - The value of ``ThroughputCapacity`` and ``ThroughputCapacityPerHAPair`` are not the same value. - The value of ``ThroughputCapacity`` when divided by the value of ``HAPairs`` is outside of the valid range for ``ThroughputCapacity`` .
@@ -2203,7 +2294,7 @@ class CfnFileSystem(
         def ha_pairs(self) -> typing.Optional[jsii.Number]:
             '''Specifies how many high-availability (HA) pairs of file servers will power your file system.
 
-            Scale-up file systems are powered by 1 HA pair. The default value is 1. FSx for ONTAP scale-out file systems are powered by up to 12 HA pairs. The value of this property affects the values of ``StorageCapacity`` , ``Iops`` , and ``ThroughputCapacity`` . For more information, see `High-availability (HA) pairs <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/HA-pairs.html>`_ in the FSx for ONTAP user guide.
+            Scale-up file systems are powered by 1 HA pair. The default value is 1. FSx for ONTAP scale-out file systems are powered by up to 12 HA pairs. The value of this property affects the values of ``StorageCapacity`` , ``Iops`` , and ``ThroughputCapacity`` . For more information, see `High-availability (HA) pairs <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/administering-file-systems.html#HA-pairs>`_ in the FSx for ONTAP user guide.
 
             Amazon FSx responds with an HTTP status code 400 (Bad Request) for the following conditions:
 
@@ -3375,7 +3466,7 @@ class CfnFileSystemProps:
         :param file_system_type: The type of Amazon FSx file system, which can be ``LUSTRE`` , ``WINDOWS`` , ``ONTAP`` , or ``OPENZFS`` .
         :param subnet_ids: Specifies the IDs of the subnets that the file system will be accessible from. For Windows and ONTAP ``MULTI_AZ_1`` deployment types,provide exactly two subnet IDs, one for the preferred file server and one for the standby file server. You specify one of these subnets as the preferred subnet using the ``WindowsConfiguration > PreferredSubnetID`` or ``OntapConfiguration > PreferredSubnetID`` properties. For more information about Multi-AZ file system configuration, see `Availability and durability: Single-AZ and Multi-AZ file systems <https://docs.aws.amazon.com/fsx/latest/WindowsGuide/high-availability-multiAZ.html>`_ in the *Amazon FSx for Windows User Guide* and `Availability and durability <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/high-availability-multiAZ.html>`_ in the *Amazon FSx for ONTAP User Guide* . For Windows ``SINGLE_AZ_1`` and ``SINGLE_AZ_2`` and all Lustre deployment types, provide exactly one subnet ID. The file server is launched in that subnet's Availability Zone.
         :param backup_id: The ID of the file system backup that you are using to create a file system. For more information, see `CreateFileSystemFromBackup <https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystemFromBackup.html>`_ .
-        :param file_system_type_version: (Optional) For FSx for Lustre file systems, sets the Lustre version for the file system that you're creating. Valid values are ``2.10`` , ``2.12`` , and ``2.15`` : - 2.10 is supported by the Scratch and Persistent_1 Lustre deployment types. - 2.12 and 2.15 are supported by all Lustre deployment types. ``2.12`` or ``2.15`` is required when setting FSx for Lustre ``DeploymentType`` to ``PERSISTENT_2`` . Default value = ``2.10`` , except when ``DeploymentType`` is set to ``PERSISTENT_2`` , then the default is ``2.12`` . .. epigraph:: If you set ``FileSystemTypeVersion`` to ``2.10`` for a ``PERSISTENT_2`` Lustre deployment type, the ``CreateFileSystem`` operation fails.
+        :param file_system_type_version: For FSx for Lustre file systems, sets the Lustre version for the file system that you're creating. Valid values are ``2.10`` , ``2.12`` , and ``2.15`` : - ``2.10`` is supported by the Scratch and Persistent_1 Lustre deployment types. - ``2.12`` is supported by all Lustre deployment types, except for ``PERSISTENT_2`` with a metadata configuration mode. - ``2.15`` is supported by all Lustre deployment types and is recommended for all new file systems. Default value is ``2.10`` , except for the following deployments: - Default value is ``2.12`` when ``DeploymentType`` is set to ``PERSISTENT_2`` without a metadata configuration mode. - Default value is ``2.15`` when ``DeploymentType`` is set to ``PERSISTENT_2`` with a metadata configuration mode.
         :param kms_key_id: The ID of the AWS Key Management Service ( AWS KMS ) key used to encrypt Amazon FSx file system data. Used as follows with Amazon FSx file system types: - Amazon FSx for Lustre ``PERSISTENT_1`` and ``PERSISTENT_2`` deployment types only. ``SCRATCH_1`` and ``SCRATCH_2`` types are encrypted using the Amazon FSx service AWS KMS key for your account. - Amazon FSx for NetApp ONTAP - Amazon FSx for OpenZFS - Amazon FSx for Windows File Server
         :param lustre_configuration: The Lustre configuration for the file system being created. .. epigraph:: The following parameters are not supported when creating Lustre file systems with a data repository association. - ``AutoImportPolicy`` - ``ExportPath`` - ``ImportedChunkSize`` - ``ImportPath``
         :param ontap_configuration: The ONTAP configuration properties of the FSx for ONTAP file system that you are creating.
@@ -3414,6 +3505,10 @@ class CfnFileSystemProps:
                     export_path="exportPath",
                     imported_file_chunk_size=123,
                     import_path="importPath",
+                    metadata_configuration=fsx.CfnFileSystem.MetadataConfigurationProperty(
+                        iops=123,
+                        mode="mode"
+                    ),
                     per_unit_storage_throughput=123,
                     weekly_maintenance_start_time="weeklyMaintenanceStartTime"
                 ),
@@ -3592,17 +3687,18 @@ class CfnFileSystemProps:
 
     @builtins.property
     def file_system_type_version(self) -> typing.Optional[builtins.str]:
-        '''(Optional) For FSx for Lustre file systems, sets the Lustre version for the file system that you're creating.
+        '''For FSx for Lustre file systems, sets the Lustre version for the file system that you're creating.
 
         Valid values are ``2.10`` , ``2.12`` , and ``2.15`` :
 
-        - 2.10 is supported by the Scratch and Persistent_1 Lustre deployment types.
-        - 2.12 and 2.15 are supported by all Lustre deployment types. ``2.12`` or ``2.15`` is required when setting FSx for Lustre ``DeploymentType`` to ``PERSISTENT_2`` .
+        - ``2.10`` is supported by the Scratch and Persistent_1 Lustre deployment types.
+        - ``2.12`` is supported by all Lustre deployment types, except for ``PERSISTENT_2`` with a metadata configuration mode.
+        - ``2.15`` is supported by all Lustre deployment types and is recommended for all new file systems.
 
-        Default value = ``2.10`` , except when ``DeploymentType`` is set to ``PERSISTENT_2`` , then the default is ``2.12`` .
-        .. epigraph::
+        Default value is ``2.10`` , except for the following deployments:
 
-           If you set ``FileSystemTypeVersion`` to ``2.10`` for a ``PERSISTENT_2`` Lustre deployment type, the ``CreateFileSystem`` operation fails.
+        - Default value is ``2.12`` when ``DeploymentType`` is set to ``PERSISTENT_2`` without a metadata configuration mode.
+        - Default value is ``2.15`` when ``DeploymentType`` is set to ``PERSISTENT_2`` with a metadata configuration mode.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-filesystem.html#cfn-fsx-filesystem-filesystemtypeversion
         '''
@@ -5304,15 +5400,15 @@ class CfnVolume(
             :param aggregate_configuration: Used to specify the configuration options for an FSx for ONTAP volume's storage aggregate or aggregates.
             :param copy_tags_to_backups: A boolean flag indicating whether tags for the volume should be copied to backups. This value defaults to false. If it's set to true, all tags for the volume are copied to all automatic and user-initiated backups where the user doesn't specify tags. If this value is true, and you specify one or more tags, only the specified tags are copied to backups. If you specify one or more tags when creating a user-initiated backup, no tags are copied from the volume, regardless of this value.
             :param junction_path: Specifies the location in the SVM's namespace where the volume is mounted. This parameter is required. The ``JunctionPath`` must have a leading forward slash, such as ``/vol3`` .
-            :param ontap_volume_type: Specifies the type of volume you are creating. Valid values are the following:. - ``RW`` specifies a read/write volume. ``RW`` is the default. - ``DP`` specifies a data-protection volume. A ``DP`` volume is read-only and can be used as the destination of a NetApp SnapMirror relationship. For more information, see `Volume types <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-types>`_ in the Amazon FSx for NetApp ONTAP User Guide.
-            :param security_style: Specifies the security style for the volume. If a volume's security style is not specified, it is automatically set to the root volume's security style. The security style determines the type of permissions that FSx for ONTAP uses to control data access. For more information, see `Volume security style <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-security-style>`_ in the *Amazon FSx for NetApp ONTAP User Guide* . Specify one of the following values: - ``UNIX`` if the file system is managed by a UNIX administrator, the majority of users are NFS clients, and an application accessing the data uses a UNIX user as the service account. - ``NTFS`` if the file system is managed by a Windows administrator, the majority of users are SMB clients, and an application accessing the data uses a Windows user as the service account. - ``MIXED`` This is an advanced setting. For more information, see the topic `What the security styles and their effects are <https://docs.aws.amazon.com/https://docs.netapp.com/us-en/ontap/nfs-admin/security-styles-their-effects-concept.html>`_ in the NetApp Documentation Center. For more information, see `Volume security style <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-security-style.html>`_ in the FSx for ONTAP User Guide.
+            :param ontap_volume_type: Specifies the type of volume you are creating. Valid values are the following:. - ``RW`` specifies a read/write volume. ``RW`` is the default. - ``DP`` specifies a data-protection volume. A ``DP`` volume is read-only and can be used as the destination of a NetApp SnapMirror relationship. For more information, see `Volume types <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-volumes.html#volume-types>`_ in the Amazon FSx for NetApp ONTAP User Guide.
+            :param security_style: Specifies the security style for the volume. If a volume's security style is not specified, it is automatically set to the root volume's security style. The security style determines the type of permissions that FSx for ONTAP uses to control data access. Specify one of the following values: - ``UNIX`` if the file system is managed by a UNIX administrator, the majority of users are NFS clients, and an application accessing the data uses a UNIX user as the service account. - ``NTFS`` if the file system is managed by a Windows administrator, the majority of users are SMB clients, and an application accessing the data uses a Windows user as the service account. - ``MIXED`` This is an advanced setting. For more information, see the topic `What the security styles and their effects are <https://docs.aws.amazon.com/https://docs.netapp.com/us-en/ontap/nfs-admin/security-styles-their-effects-concept.html>`_ in the NetApp Documentation Center. For more information, see `Volume security style <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-volumes.html#volume-security-style>`_ in the FSx for ONTAP User Guide.
             :param size_in_bytes: Specifies the configured size of the volume, in bytes.
             :param size_in_megabytes: Use ``SizeInBytes`` instead. Specifies the size of the volume, in megabytes (MB), that you are creating.
             :param snaplock_configuration: The SnapLock configuration object for an FSx for ONTAP SnapLock volume.
             :param snapshot_policy: Specifies the snapshot policy for the volume. There are three built-in snapshot policies:. - ``default`` : This is the default policy. A maximum of six hourly snapshots taken five minutes past the hour. A maximum of two daily snapshots taken Monday through Saturday at 10 minutes after midnight. A maximum of two weekly snapshots taken every Sunday at 15 minutes after midnight. - ``default-1weekly`` : This policy is the same as the ``default`` policy except that it only retains one snapshot from the weekly schedule. - ``none`` : This policy does not take any snapshots. This policy can be assigned to volumes to prevent automatic snapshots from being taken. You can also provide the name of a custom policy that you created with the ONTAP CLI or REST API. For more information, see `Snapshot policies <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/snapshots-ontap.html#snapshot-policies>`_ in the Amazon FSx for NetApp ONTAP User Guide.
             :param storage_efficiency_enabled: Set to true to enable deduplication, compression, and compaction storage efficiency features on the volume, or set to false to disable them. ``StorageEfficiencyEnabled`` is required when creating a ``RW`` volume ( ``OntapVolumeType`` set to ``RW`` ).
             :param tiering_policy: Describes the data tiering policy for an ONTAP volume. When enabled, Amazon FSx for ONTAP's intelligent tiering automatically transitions a volume's data between the file system's primary storage and capacity pool storage based on your access patterns. Valid tiering policies are the following: - ``SNAPSHOT_ONLY`` - (Default value) moves cold snapshots to the capacity pool storage tier. - ``AUTO`` - moves cold user data and snapshots to the capacity pool storage tier based on your access patterns. - ``ALL`` - moves all user data blocks in both the active file system and Snapshot copies to the storage pool tier. - ``NONE`` - keeps a volume's data in the primary storage tier, preventing it from being moved to the capacity pool tier.
-            :param volume_style: Use to specify the style of an ONTAP volume. FSx for ONTAP offers two styles of volumes that you can use for different purposes, FlexVol and FlexGroup volumes. For more information, see `Volume styles <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-styles.html>`_ in the Amazon FSx for NetApp ONTAP User Guide.
+            :param volume_style: Use to specify the style of an ONTAP volume. FSx for ONTAP offers two styles of volumes that you can use for different purposes, FlexVol and FlexGroup volumes. For more information, see `Volume styles <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-volumes.html#volume-styles>`_ in the Amazon FSx for NetApp ONTAP User Guide.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-volume-ontapconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -5473,7 +5569,7 @@ class CfnVolume(
             - ``RW`` specifies a read/write volume. ``RW`` is the default.
             - ``DP`` specifies a data-protection volume. A ``DP`` volume is read-only and can be used as the destination of a NetApp SnapMirror relationship.
 
-            For more information, see `Volume types <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-types>`_ in the Amazon FSx for NetApp ONTAP User Guide.
+            For more information, see `Volume types <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-volumes.html#volume-types>`_ in the Amazon FSx for NetApp ONTAP User Guide.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-volume-ontapconfiguration.html#cfn-fsx-volume-ontapconfiguration-ontapvolumetype
             '''
@@ -5484,13 +5580,13 @@ class CfnVolume(
         def security_style(self) -> typing.Optional[builtins.str]:
             '''Specifies the security style for the volume.
 
-            If a volume's security style is not specified, it is automatically set to the root volume's security style. The security style determines the type of permissions that FSx for ONTAP uses to control data access. For more information, see `Volume security style <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-security-style>`_ in the *Amazon FSx for NetApp ONTAP User Guide* . Specify one of the following values:
+            If a volume's security style is not specified, it is automatically set to the root volume's security style. The security style determines the type of permissions that FSx for ONTAP uses to control data access. Specify one of the following values:
 
             - ``UNIX`` if the file system is managed by a UNIX administrator, the majority of users are NFS clients, and an application accessing the data uses a UNIX user as the service account.
             - ``NTFS`` if the file system is managed by a Windows administrator, the majority of users are SMB clients, and an application accessing the data uses a Windows user as the service account.
             - ``MIXED`` This is an advanced setting. For more information, see the topic `What the security styles and their effects are <https://docs.aws.amazon.com/https://docs.netapp.com/us-en/ontap/nfs-admin/security-styles-their-effects-concept.html>`_ in the NetApp Documentation Center.
 
-            For more information, see `Volume security style <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-security-style.html>`_ in the FSx for ONTAP User Guide.
+            For more information, see `Volume security style <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-volumes.html#volume-security-style>`_ in the FSx for ONTAP User Guide.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-volume-ontapconfiguration.html#cfn-fsx-volume-ontapconfiguration-securitystyle
             '''
@@ -5580,7 +5676,7 @@ class CfnVolume(
         def volume_style(self) -> typing.Optional[builtins.str]:
             '''Use to specify the style of an ONTAP volume.
 
-            FSx for ONTAP offers two styles of volumes that you can use for different purposes, FlexVol and FlexGroup volumes. For more information, see `Volume styles <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/volume-styles.html>`_ in the Amazon FSx for NetApp ONTAP User Guide.
+            FSx for ONTAP offers two styles of volumes that you can use for different purposes, FlexVol and FlexGroup volumes. For more information, see `Volume styles <https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/managing-volumes.html#volume-styles>`_ in the Amazon FSx for NetApp ONTAP User Guide.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-volume-ontapconfiguration.html#cfn-fsx-volume-ontapconfiguration-volumestyle
             '''
@@ -8172,12 +8268,21 @@ def _typecheckingstub__8e1fe808b96f0eb1b8b6ed8eb3d551c8d995fe2c98c9be554bed33160
     export_path: typing.Optional[builtins.str] = None,
     imported_file_chunk_size: typing.Optional[jsii.Number] = None,
     import_path: typing.Optional[builtins.str] = None,
+    metadata_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFileSystem.MetadataConfigurationProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     per_unit_storage_throughput: typing.Optional[jsii.Number] = None,
     weekly_maintenance_start_time: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__7aa9a7707baff419117abba7f05ab48bf7b1de77cbcd91feed4ec16f2cb54ffc(
+    *,
+    iops: typing.Optional[jsii.Number] = None,
+    mode: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__cf7e8e549f94791653e718c0386fce4703f149298e88872cacd000f16d38ec9d(
     *,
     client_configurations: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnFileSystem.ClientConfigurationsProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,

aws_cdk/aws_globalaccelerator/__init__.py

@@ -113,7 +113,8 @@ listener.add_endpoint_group("Group",
 listener.add_endpoint_group("Group",
     endpoints=[
         ga_endpoints.NetworkLoadBalancerEndpoint(nlb,
-            weight=128
+            weight=128,
+            preserve_client_ip=True
         )
     ]
 )

aws_cdk/aws_globalaccelerator_endpoints/__init__.py

@@ -477,16 +477,20 @@ class NetworkLoadBalancerEndpoint(
         self,
         load_balancer: _INetworkLoadBalancer_96e17101,
         *,
+        preserve_client_ip: typing.Optional[builtins.bool] = None,
         weight: typing.Optional[jsii.Number] = None,
     ) -> None:
         '''
         :param load_balancer: -
+        :param preserve_client_ip: Forward the client IP address in an ``X-Forwarded-For`` header. GlobalAccelerator will create Network Interfaces in your VPC in order to preserve the client IP address. Client IP address preservation is supported only in specific AWS Regions. See the GlobalAccelerator Developer Guide for a list. Default: false
         :param weight: Endpoint weight across all endpoints in the group. Must be a value between 0 and 255. Default: 128
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__edacbc82e43081f03b16a95735ec03233b002430b75f4210e6958b2ecdfcde4d)
             check_type(argname="argument load_balancer", value=load_balancer, expected_type=type_hints["load_balancer"])
-        options = NetworkLoadBalancerEndpointProps(weight=weight)
+        options = NetworkLoadBalancerEndpointProps(
+            preserve_client_ip=preserve_client_ip, weight=weight
+        )
 
         jsii.create(self.__class__, self, [load_balancer, options])
 
@@ -508,12 +512,18 @@ class NetworkLoadBalancerEndpoint(
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_globalaccelerator_endpoints.NetworkLoadBalancerEndpointProps",
     jsii_struct_bases=[],
-    name_mapping={"weight": "weight"},
+    name_mapping={"preserve_client_ip": "preserveClientIp", "weight": "weight"},
 )
 class NetworkLoadBalancerEndpointProps:
-    def __init__(self, *, weight: typing.Optional[jsii.Number] = None) -> None:
+    def __init__(
+        self,
+        *,
+        preserve_client_ip: typing.Optional[builtins.bool] = None,
+        weight: typing.Optional[jsii.Number] = None,
+    ) -> None:
         '''Properties for a NetworkLoadBalancerEndpoint.
 
+        :param preserve_client_ip: Forward the client IP address in an ``X-Forwarded-For`` header. GlobalAccelerator will create Network Interfaces in your VPC in order to preserve the client IP address. Client IP address preservation is supported only in specific AWS Regions. See the GlobalAccelerator Developer Guide for a list. Default: false
         :param weight: Endpoint weight across all endpoints in the group. Must be a value between 0 and 255. Default: 128
 
         :exampleMetadata: infused
@@ -527,18 +537,37 @@ class NetworkLoadBalancerEndpointProps:
             listener.add_endpoint_group("Group",
                 endpoints=[
                     ga_endpoints.NetworkLoadBalancerEndpoint(nlb,
-                        weight=128
+                        weight=128,
+                        preserve_client_ip=True
                     )
                 ]
             )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a3059a828313b5b869d2a1ae70c7acf7cf9e4d48942d0394e47efafc648b331f)
+            check_type(argname="argument preserve_client_ip", value=preserve_client_ip, expected_type=type_hints["preserve_client_ip"])
             check_type(argname="argument weight", value=weight, expected_type=type_hints["weight"])
         self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if preserve_client_ip is not None:
+            self._values["preserve_client_ip"] = preserve_client_ip
         if weight is not None:
             self._values["weight"] = weight
 
+    @builtins.property
+    def preserve_client_ip(self) -> typing.Optional[builtins.bool]:
+        '''Forward the client IP address in an ``X-Forwarded-For`` header.
+
+        GlobalAccelerator will create Network Interfaces in your VPC in order
+        to preserve the client IP address.
+
+        Client IP address preservation is supported only in specific AWS Regions.
+        See the GlobalAccelerator Developer Guide for a list.
+
+        :default: false
+        '''
+        result = self._values.get("preserve_client_ip")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     @builtins.property
     def weight(self) -> typing.Optional[jsii.Number]:
         '''Endpoint weight across all endpoints in the group.
@@ -627,6 +656,7 @@ def _typecheckingstub__234a90a888e0bfaab2b608e4e2c1e1a69a9e87121c40a35a442f70275
 def _typecheckingstub__edacbc82e43081f03b16a95735ec03233b002430b75f4210e6958b2ecdfcde4d(
     load_balancer: _INetworkLoadBalancer_96e17101,
     *,
+    preserve_client_ip: typing.Optional[builtins.bool] = None,
     weight: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""
@@ -634,6 +664,7 @@ def _typecheckingstub__edacbc82e43081f03b16a95735ec03233b002430b75f4210e6958b2ec
 
 def _typecheckingstub__a3059a828313b5b869d2a1ae70c7acf7cf9e4d48942d0394e47efafc648b331f(
     *,
+    preserve_client_ip: typing.Optional[builtins.bool] = None,
     weight: typing.Optional[jsii.Number] = None,
 ) -> None:
     """Type checking stubs"""

aws_cdk/aws_glue/__init__.py

@@ -1454,6 +1454,7 @@ class CfnCrawler(
                 )],
                 jdbc_targets=[glue.CfnCrawler.JdbcTargetProperty(
                     connection_name="connectionName",
+                    enable_additional_metadata=["enableAdditionalMetadata"],
                     exclusions=["exclusions"],
                     path="path"
                 )],
@@ -2214,6 +2215,7 @@ class CfnCrawler(
         jsii_struct_bases=[],
         name_mapping={
             "connection_name": "connectionName",
+            "enable_additional_metadata": "enableAdditionalMetadata",
             "exclusions": "exclusions",
             "path": "path",
         },
@@ -2223,12 +2225,14 @@ class CfnCrawler(
             self,
             *,
             connection_name: typing.Optional[builtins.str] = None,
+            enable_additional_metadata: typing.Optional[typing.Sequence[builtins.str]] = None,
             exclusions: typing.Optional[typing.Sequence[builtins.str]] = None,
             path: typing.Optional[builtins.str] = None,
         ) -> None:
             '''Specifies a JDBC data store to crawl.
 
             :param connection_name: The name of the connection to use to connect to the JDBC target.
+            :param enable_additional_metadata: Specify a value of ``RAWTYPES`` or ``COMMENTS`` to enable additional metadata in table responses. ``RAWTYPES`` provides the native-level datatype. ``COMMENTS`` provides comments associated with a column or table in the database. If you do not need additional metadata, keep the field empty.
             :param exclusions: A list of glob patterns used to exclude from the crawl. For more information, see `Catalog Tables with a Crawler <https://docs.aws.amazon.com/glue/latest/dg/add-crawler.html>`_ .
             :param path: The path of the JDBC target.
 
@@ -2243,6 +2247,7 @@ class CfnCrawler(
                 
                 jdbc_target_property = glue.CfnCrawler.JdbcTargetProperty(
                     connection_name="connectionName",
+                    enable_additional_metadata=["enableAdditionalMetadata"],
                     exclusions=["exclusions"],
                     path="path"
                 )
@@ -2250,11 +2255,14 @@ class CfnCrawler(
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__9cb27c7db73a5c6fa3740f2d4726f453641d40911229d3bb39f26c4402516cf6)
                 check_type(argname="argument connection_name", value=connection_name, expected_type=type_hints["connection_name"])
+                check_type(argname="argument enable_additional_metadata", value=enable_additional_metadata, expected_type=type_hints["enable_additional_metadata"])
                 check_type(argname="argument exclusions", value=exclusions, expected_type=type_hints["exclusions"])
                 check_type(argname="argument path", value=path, expected_type=type_hints["path"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
             if connection_name is not None:
                 self._values["connection_name"] = connection_name
+            if enable_additional_metadata is not None:
+                self._values["enable_additional_metadata"] = enable_additional_metadata
             if exclusions is not None:
                 self._values["exclusions"] = exclusions
             if path is not None:
@@ -2269,6 +2277,21 @@ class CfnCrawler(
             result = self._values.get("connection_name")
             return typing.cast(typing.Optional[builtins.str], result)
 
+        @builtins.property
+        def enable_additional_metadata(
+            self,
+        ) -> typing.Optional[typing.List[builtins.str]]:
+            '''Specify a value of ``RAWTYPES`` or ``COMMENTS`` to enable additional metadata in table responses.
+
+            ``RAWTYPES`` provides the native-level datatype. ``COMMENTS`` provides comments associated with a column or table in the database.
+
+            If you do not need additional metadata, keep the field empty.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-glue-crawler-jdbctarget.html#cfn-glue-crawler-jdbctarget-enableadditionalmetadata
+            '''
+            result = self._values.get("enable_additional_metadata")
+            return typing.cast(typing.Optional[typing.List[builtins.str]], result)
+
         @builtins.property
         def exclusions(self) -> typing.Optional[typing.List[builtins.str]]:
             '''A list of glob patterns used to exclude from the crawl.
@@ -2868,6 +2891,7 @@ class CfnCrawler(
                     )],
                     jdbc_targets=[glue.CfnCrawler.JdbcTargetProperty(
                         connection_name="connectionName",
+                        enable_additional_metadata=["enableAdditionalMetadata"],
                         exclusions=["exclusions"],
                         path="path"
                     )],
@@ -3093,6 +3117,7 @@ class CfnCrawlerProps:
                     )],
                     jdbc_targets=[glue.CfnCrawler.JdbcTargetProperty(
                         connection_name="connectionName",
+                        enable_additional_metadata=["enableAdditionalMetadata"],
                         exclusions=["exclusions"],
                         path="path"
                     )],
@@ -15515,6 +15540,7 @@ def _typecheckingstub__fc4d48721f48f2b8be2bdcc36b62b7559b104ac87185a032281e5b09d
 def _typecheckingstub__9cb27c7db73a5c6fa3740f2d4726f453641d40911229d3bb39f26c4402516cf6(
     *,
     connection_name: typing.Optional[builtins.str] = None,
+    enable_additional_metadata: typing.Optional[typing.Sequence[builtins.str]] = None,
     exclusions: typing.Optional[typing.Sequence[builtins.str]] = None,
     path: typing.Optional[builtins.str] = None,
 ) -> None:

aws_cdk/aws_grafana/__init__.py

@@ -158,7 +158,7 @@ class CfnWorkspace(
         :param network_access_control: The configuration settings for network access to your workspace.
         :param notification_destinations: The AWS notification channels that Amazon Managed Grafana can automatically create IAM roles and permissions for, to allow Amazon Managed Grafana to use these channels.
         :param organizational_units: Specifies the organizational units that this workspace is allowed to use data sources from, if this workspace is in an account that is part of an organization.
-        :param organization_role_name: The name of the IAM role that is used to access resources through Organizations .
+        :param organization_role_name: The name of the IAM role that is used to access resources through Organizations.
         :param plugin_admin_enabled: Whether plugin administration is enabled in the workspace. Setting to ``true`` allows workspace admins to install, uninstall, and update plugins from within the Grafana workspace. .. epigraph:: This option is only valid for workspaces that support Grafana version 9 or newer.
         :param role_arn: The IAM role that grants permissions to the AWS resources that the workspace will view data from. This role must already exist.
         :param saml_configuration: If the workspace uses SAML, use this structure to map SAML assertion attributes to workspace user information and define which groups in the assertion attribute are to have the ``Admin`` and ``Editor`` roles in the workspace.
@@ -475,7 +475,7 @@ class CfnWorkspace(
     @builtins.property
     @jsii.member(jsii_name="organizationRoleName")
     def organization_role_name(self) -> typing.Optional[builtins.str]:
-        '''The name of the IAM role that is used to access resources through Organizations .'''
+        '''The name of the IAM role that is used to access resources through Organizations.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "organizationRoleName"))
 
     @organization_role_name.setter
@@ -1238,7 +1238,7 @@ class CfnWorkspaceProps:
         :param network_access_control: The configuration settings for network access to your workspace.
         :param notification_destinations: The AWS notification channels that Amazon Managed Grafana can automatically create IAM roles and permissions for, to allow Amazon Managed Grafana to use these channels.
         :param organizational_units: Specifies the organizational units that this workspace is allowed to use data sources from, if this workspace is in an account that is part of an organization.
-        :param organization_role_name: The name of the IAM role that is used to access resources through Organizations .
+        :param organization_role_name: The name of the IAM role that is used to access resources through Organizations.
         :param plugin_admin_enabled: Whether plugin administration is enabled in the workspace. Setting to ``true`` allows workspace admins to install, uninstall, and update plugins from within the Grafana workspace. .. epigraph:: This option is only valid for workspaces that support Grafana version 9 or newer.
         :param role_arn: The IAM role that grants permissions to the AWS resources that the workspace will view data from. This role must already exist.
         :param saml_configuration: If the workspace uses SAML, use this structure to map SAML assertion attributes to workspace user information and define which groups in the assertion attribute are to have the ``Admin`` and ``Editor`` roles in the workspace.
@@ -1478,7 +1478,7 @@ class CfnWorkspaceProps:
 
     @builtins.property
     def organization_role_name(self) -> typing.Optional[builtins.str]:
-        '''The name of the IAM role that is used to access resources through Organizations .
+        '''The name of the IAM role that is used to access resources through Organizations.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-grafana-workspace.html#cfn-grafana-workspace-organizationrolename
         '''