aws-cdk-lib 2.203.1__py3-none-any.whl → 2.205.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.


This version of aws-cdk-lib might be problematic. Click here for more details.

Files changed (62) hide show
  1. aws_cdk/__init__.py +208 -92
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.203.1.jsii.tgz → aws-cdk-lib@2.205.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_aiops/__init__.py +89 -39
  5. aws_cdk/aws_apigateway/__init__.py +164 -0
  6. aws_cdk/aws_apigatewayv2/__init__.py +412 -0
  7. aws_cdk/aws_applicationautoscaling/__init__.py +2 -2
  8. aws_cdk/aws_arczonalshift/__init__.py +4 -1
  9. aws_cdk/aws_b2bi/__init__.py +32 -16
  10. aws_cdk/aws_bedrock/__init__.py +198 -10
  11. aws_cdk/aws_cassandra/__init__.py +156 -0
  12. aws_cdk/aws_certificatemanager/__init__.py +28 -0
  13. aws_cdk/aws_chatbot/__init__.py +28 -0
  14. aws_cdk/aws_cloudformation/__init__.py +74 -72
  15. aws_cdk/aws_cloudfront/__init__.py +1273 -485
  16. aws_cdk/aws_cloudfront/experimental/__init__.py +32 -0
  17. aws_cdk/aws_cloudfront_origins/__init__.py +26 -21
  18. aws_cdk/aws_cloudwatch/__init__.py +278 -23
  19. aws_cdk/aws_codebuild/__init__.py +300 -36
  20. aws_cdk/aws_datasync/__init__.py +2 -2
  21. aws_cdk/aws_docdb/__init__.py +78 -0
  22. aws_cdk/aws_dynamodb/__init__.py +523 -37
  23. aws_cdk/aws_ec2/__init__.py +126 -30
  24. aws_cdk/aws_ecs/__init__.py +64 -19
  25. aws_cdk/aws_elasticloadbalancingv2/__init__.py +724 -0
  26. aws_cdk/aws_elasticsearch/__init__.py +260 -0
  27. aws_cdk/aws_emrserverless/__init__.py +5 -5
  28. aws_cdk/aws_events/__init__.py +58 -3
  29. aws_cdk/aws_events_targets/__init__.py +7 -2
  30. aws_cdk/aws_evs/__init__.py +7 -7
  31. aws_cdk/aws_fsx/__init__.py +138 -78
  32. aws_cdk/aws_gamelift/__init__.py +19 -0
  33. aws_cdk/aws_glue/__init__.py +3 -3
  34. aws_cdk/aws_iot/__init__.py +1 -1
  35. aws_cdk/aws_kinesis/__init__.py +391 -13
  36. aws_cdk/aws_kinesisfirehose/__init__.py +128 -1
  37. aws_cdk/aws_lambda/__init__.py +144 -0
  38. aws_cdk/aws_lex/__init__.py +36 -19
  39. aws_cdk/aws_logs/__init__.py +58 -0
  40. aws_cdk/aws_neptune/__init__.py +12 -12
  41. aws_cdk/aws_odb/__init__.py +4049 -0
  42. aws_cdk/aws_omics/__init__.py +1 -1
  43. aws_cdk/aws_opensearchservice/__init__.py +260 -0
  44. aws_cdk/aws_qbusiness/__init__.py +471 -4
  45. aws_cdk/aws_quicksight/__init__.py +185 -16
  46. aws_cdk/aws_rds/__init__.py +553 -17
  47. aws_cdk/aws_redshiftserverless/__init__.py +72 -45
  48. aws_cdk/aws_route53/__init__.py +41 -19
  49. aws_cdk/aws_s3tables/__init__.py +1005 -0
  50. aws_cdk/aws_sagemaker/__init__.py +20 -0
  51. aws_cdk/aws_scheduler/__init__.py +210 -0
  52. aws_cdk/aws_sns/__init__.py +164 -0
  53. aws_cdk/aws_sqs/__init__.py +164 -0
  54. aws_cdk/aws_stepfunctions/__init__.py +288 -0
  55. aws_cdk/aws_synthetics/__init__.py +159 -37
  56. aws_cdk/aws_transfer/__init__.py +23 -1
  57. {aws_cdk_lib-2.203.1.dist-info → aws_cdk_lib-2.205.0.dist-info}/METADATA +2 -2
  58. {aws_cdk_lib-2.203.1.dist-info → aws_cdk_lib-2.205.0.dist-info}/RECORD +62 -61
  59. {aws_cdk_lib-2.203.1.dist-info → aws_cdk_lib-2.205.0.dist-info}/LICENSE +0 -0
  60. {aws_cdk_lib-2.203.1.dist-info → aws_cdk_lib-2.205.0.dist-info}/NOTICE +0 -0
  61. {aws_cdk_lib-2.203.1.dist-info → aws_cdk_lib-2.205.0.dist-info}/WHEEL +0 -0
  62. {aws_cdk_lib-2.203.1.dist-info → aws_cdk_lib-2.205.0.dist-info}/top_level.txt +0 -0
@@ -1169,15 +1169,15 @@ class CfnFileSystem(
1169
1169
  :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.
1170
1170
  :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>`_ .
1171
1171
  :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.
1172
- :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
1173
- :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``
1174
- :param ontap_configuration: The ONTAP configuration properties of the FSx for ONTAP file system that you are creating.
1175
- :param open_zfs_configuration: The Amazon FSx for OpenZFS configuration properties for the file system that you are creating.
1172
+ :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 If this ID isn't specified, the Amazon FSx-managed key for your account is used. For more information, see `Encrypt <https://docs.aws.amazon.com//kms/latest/APIReference/API_Encrypt.html>`_ in the *AWS Key Management Service API Reference* .
1173
+ :param lustre_configuration: The Lustre configuration for the file system being created. This configuration is required if the ``FileSystemType`` is set to ``LUSTRE`` . .. epigraph:: The following parameters are not supported when creating Lustre file systems with a data repository association. - ``AutoImportPolicy`` - ``ExportPath`` - ``ImportedChunkSize`` - ``ImportPath``
1174
+ :param ontap_configuration: The ONTAP configuration properties of the FSx for ONTAP file system that you are creating. This configuration is required if the ``FileSystemType`` is set to ``ONTAP`` .
1175
+ :param open_zfs_configuration: The Amazon FSx for OpenZFS configuration properties for the file system that you are creating. This configuration is required if the ``FileSystemType`` is set to ``OPENZFS`` .
1176
1176
  :param security_group_ids: A list of IDs specifying the security groups to apply to all network interfaces created for file system access. This list isn't returned in later requests to describe the file system. .. epigraph:: You must specify a security group if you are creating a Multi-AZ FSx for ONTAP file system in a VPC subnet that has been shared with you.
1177
1177
  :param storage_capacity: Sets the storage capacity of the file system that you're creating. ``StorageCapacity`` is required if you are creating a new file system. It is not required if you are creating a file system by restoring a backup. *FSx for Lustre file systems* - The amount of storage capacity that you can configure depends on the value that you set for ``StorageType`` and the Lustre ``DeploymentType`` , as follows: - For ``SCRATCH_2`` , ``PERSISTENT_2`` and ``PERSISTENT_1`` deployment types using SSD storage type, the valid values are 1200 GiB, 2400 GiB, and increments of 2400 GiB. - For ``PERSISTENT_1`` HDD file systems, valid values are increments of 6000 GiB for 12 MB/s/TiB file systems and increments of 1800 GiB for 40 MB/s/TiB file systems. - For ``SCRATCH_1`` deployment type, valid values are 1200 GiB, 2400 GiB, and increments of 3600 GiB. *FSx for ONTAP file systems* - The amount of SSD storage capacity that you can configure depends on the value of the ``HAPairs`` property. The minimum value is calculated as 1,024 GiB * HAPairs and the maximum is calculated as 524,288 GiB * HAPairs, up to a maximum amount of SSD storage capacity of 1,048,576 GiB (1 pebibyte). *FSx for OpenZFS file systems* - The amount of storage capacity that you can configure is from 64 GiB up to 524,288 GiB (512 TiB). If you are creating a file system from a backup, you can specify a storage capacity equal to or greater than the original file system's storage capacity. *FSx for Windows File Server file systems* - The amount of storage capacity that you can configure depends on the value that you set for ``StorageType`` as follows: - For SSD storage, valid values are 32 GiB-65,536 GiB (64 TiB). - For HDD storage, valid values are 2000 GiB-65,536 GiB (64 TiB).
1178
1178
  :param storage_type: Sets the storage class for the file system that you're creating. Valid values are ``SSD`` , ``HDD`` , and ``INTELLIGENT_TIERING`` . - Set to ``SSD`` to use solid state drive storage. SSD is supported on all Windows, Lustre, ONTAP, and OpenZFS deployment types. - Set to ``HDD`` to use hard disk drive storage, which is supported on ``SINGLE_AZ_2`` and ``MULTI_AZ_1`` Windows file system deployment types, and on ``PERSISTENT_1`` Lustre file system deployment types. - Set to ``INTELLIGENT_TIERING`` to use fully elastic, intelligently-tiered storage. Intelligent-Tiering is only available for OpenZFS file systems with the Multi-AZ deployment type and for Lustre file systems with the Persistent_2 deployment type. Default value is ``SSD`` . For more information, see `Storage type options <https://docs.aws.amazon.com/fsx/latest/WindowsGuide/optimize-fsx-costs.html#storage-type-options>`_ in the *FSx for Windows File Server User Guide* , `FSx for Lustre storage classes <https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-storage-classes>`_ in the *FSx for Lustre User Guide* , and `Working with Intelligent-Tiering <https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/performance-intelligent-tiering>`_ in the *Amazon FSx for OpenZFS User Guide* .
1179
1179
  :param tags: The tags to associate with the file system. For more information, see `Tagging your Amazon FSx resources <https://docs.aws.amazon.com/fsx/latest/LustreGuide/tag-resources.html>`_ in the *Amazon FSx for Lustre User Guide* .
1180
- :param windows_configuration: The configuration object for the Microsoft Windows file system you are creating. This value is required if ``FileSystemType`` is set to ``WINDOWS`` .
1180
+ :param windows_configuration: The configuration object for the Microsoft Windows file system you are creating. This configuration is required if ``FileSystemType`` is set to ``WINDOWS`` .
1181
1181
  '''
1182
1182
  if __debug__:
1183
1183
  type_hints = typing.get_type_hints(_typecheckingstub__2d13764c3dcb8d96799af4fa191d042ff4511c33cfd1aecbf235dded3234d3c5)
@@ -1685,9 +1685,10 @@ class CfnFileSystem(
1685
1685
  size_gib: typing.Optional[jsii.Number] = None,
1686
1686
  sizing_mode: typing.Optional[builtins.str] = None,
1687
1687
  ) -> None:
1688
- '''
1689
- :param size_gib:
1690
- :param sizing_mode:
1688
+ '''The configuration for the optional provisioned SSD read cache on Amazon FSx for Lustre file systems that use the Intelligent-Tiering storage class.
1689
+
1690
+ :param size_gib: Required if ``SizingMode`` is set to ``USER_PROVISIONED`` . Specifies the size of the file system's SSD read cache, in gibibytes (GiB).
1691
+ :param sizing_mode: Specifies how the provisioned SSD read cache is sized, as follows:. - Set to ``NO_CACHE`` if you do not want to use an SSD read cache with your Intelligent-Tiering file system. - Set to ``USER_PROVISIONED`` to specify the exact size of your SSD read cache. - Set to ``PROPORTIONAL_TO_THROUGHPUT_CAPACITY`` to have your SSD read cache automatically sized based on your throughput capacity.
1691
1692
 
1692
1693
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-datareadcacheconfiguration.html
1693
1694
  :exampleMetadata: fixture=_generated
@@ -1715,7 +1716,10 @@ class CfnFileSystem(
1715
1716
 
1716
1717
  @builtins.property
1717
1718
  def size_gib(self) -> typing.Optional[jsii.Number]:
1718
- '''
1719
+ '''Required if ``SizingMode`` is set to ``USER_PROVISIONED`` .
1720
+
1721
+ Specifies the size of the file system's SSD read cache, in gibibytes (GiB).
1722
+
1719
1723
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-datareadcacheconfiguration.html#cfn-fsx-filesystem-datareadcacheconfiguration-sizegib
1720
1724
  '''
1721
1725
  result = self._values.get("size_gib")
@@ -1723,7 +1727,12 @@ class CfnFileSystem(
1723
1727
 
1724
1728
  @builtins.property
1725
1729
  def sizing_mode(self) -> typing.Optional[builtins.str]:
1726
- '''
1730
+ '''Specifies how the provisioned SSD read cache is sized, as follows:.
1731
+
1732
+ - Set to ``NO_CACHE`` if you do not want to use an SSD read cache with your Intelligent-Tiering file system.
1733
+ - Set to ``USER_PROVISIONED`` to specify the exact size of your SSD read cache.
1734
+ - Set to ``PROPORTIONAL_TO_THROUGHPUT_CAPACITY`` to have your SSD read cache automatically sized based on your throughput capacity.
1735
+
1727
1736
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-datareadcacheconfiguration.html#cfn-fsx-filesystem-datareadcacheconfiguration-sizingmode
1728
1737
  '''
1729
1738
  result = self._values.get("sizing_mode")
@@ -1866,16 +1875,16 @@ class CfnFileSystem(
1866
1875
  :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* .
1867
1876
  :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.
1868
1877
  :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* .
1869
- :param data_read_cache_configuration:
1878
+ :param data_read_cache_configuration: Specifies the optional provisioned SSD read cache on FSx for Lustre file systems that use the Intelligent-Tiering storage class. Required when ``StorageType`` is set to ``INTELLIGENT_TIERING`` .
1870
1879
  :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 the SSD and Intelligent-Tiering storage classes. 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 `Deployment and storage class options for FSx for Lustre file systems <https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html>`_ 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`` )
1871
1880
  :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`` .
1872
- :param efa_enabled:
1881
+ :param efa_enabled: (Optional) Specifies whether Elastic Fabric Adapter (EFA) and GPUDirect Storage (GDS) support is enabled for the Amazon FSx for Lustre file system. (Default = ``false`` )
1873
1882
  :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.
1874
1883
  :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.
1875
1884
  :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.
1876
- :param metadata_configuration:
1885
+ :param metadata_configuration: The Lustre metadata performance configuration for the creation of an FSx for Lustre file system using a ``PERSISTENT_2`` deployment type.
1877
1886
  :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.
1878
- :param throughput_capacity:
1887
+ :param throughput_capacity: Specifies the throughput of an FSx for Lustre file system using the Intelligent-Tiering storage class, measured in megabytes per second (MBps). Valid values are 4000 MBps or multiples of 4000 MBps. You pay for the amount of throughput that you provision.
1879
1888
  :param weekly_maintenance_start_time: The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday. For example, ``1:05:00`` specifies maintenance at 5 AM Monday.
1880
1889
 
1881
1890
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-lustreconfiguration.html
@@ -2042,7 +2051,10 @@ class CfnFileSystem(
2042
2051
  def data_read_cache_configuration(
2043
2052
  self,
2044
2053
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnFileSystem.DataReadCacheConfigurationProperty"]]:
2045
- '''
2054
+ '''Specifies the optional provisioned SSD read cache on FSx for Lustre file systems that use the Intelligent-Tiering storage class.
2055
+
2056
+ Required when ``StorageType`` is set to ``INTELLIGENT_TIERING`` .
2057
+
2046
2058
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-lustreconfiguration.html#cfn-fsx-filesystem-lustreconfiguration-datareadcacheconfiguration
2047
2059
  '''
2048
2060
  result = self._values.get("data_read_cache_configuration")
@@ -2087,7 +2099,10 @@ class CfnFileSystem(
2087
2099
  def efa_enabled(
2088
2100
  self,
2089
2101
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
2090
- '''
2102
+ '''(Optional) Specifies whether Elastic Fabric Adapter (EFA) and GPUDirect Storage (GDS) support is enabled for the Amazon FSx for Lustre file system.
2103
+
2104
+ (Default = ``false`` )
2105
+
2091
2106
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-lustreconfiguration.html#cfn-fsx-filesystem-lustreconfiguration-efaenabled
2092
2107
  '''
2093
2108
  result = self._values.get("efa_enabled")
@@ -2143,7 +2158,8 @@ class CfnFileSystem(
2143
2158
  def metadata_configuration(
2144
2159
  self,
2145
2160
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnFileSystem.MetadataConfigurationProperty"]]:
2146
- '''
2161
+ '''The Lustre metadata performance configuration for the creation of an FSx for Lustre file system using a ``PERSISTENT_2`` deployment type.
2162
+
2147
2163
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-lustreconfiguration.html#cfn-fsx-filesystem-lustreconfiguration-metadataconfiguration
2148
2164
  '''
2149
2165
  result = self._values.get("metadata_configuration")
@@ -2168,7 +2184,10 @@ class CfnFileSystem(
2168
2184
 
2169
2185
  @builtins.property
2170
2186
  def throughput_capacity(self) -> typing.Optional[jsii.Number]:
2171
- '''
2187
+ '''Specifies the throughput of an FSx for Lustre file system using the Intelligent-Tiering storage class, measured in megabytes per second (MBps).
2188
+
2189
+ Valid values are 4000 MBps or multiples of 4000 MBps. You pay for the amount of throughput that you provision.
2190
+
2172
2191
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-lustreconfiguration.html#cfn-fsx-filesystem-lustreconfiguration-throughputcapacity
2173
2192
  '''
2174
2193
  result = self._values.get("throughput_capacity")
@@ -2208,9 +2227,10 @@ class CfnFileSystem(
2208
2227
  iops: typing.Optional[jsii.Number] = None,
2209
2228
  mode: typing.Optional[builtins.str] = None,
2210
2229
  ) -> None:
2211
- '''
2212
- :param iops:
2213
- :param mode:
2230
+ '''The configuration that allows you to specify the performance of metadata operations for an FSx for Lustre file system.
2231
+
2232
+ :param iops: The number of Metadata IOPS provisioned for the file system.
2233
+ :param mode: Specifies whether the file system is using the AUTOMATIC setting of metadata IOPS or if it is using a USER_PROVISIONED value.
2214
2234
 
2215
2235
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-metadataconfiguration.html
2216
2236
  :exampleMetadata: fixture=_generated
@@ -2238,7 +2258,8 @@ class CfnFileSystem(
2238
2258
 
2239
2259
  @builtins.property
2240
2260
  def iops(self) -> typing.Optional[jsii.Number]:
2241
- '''
2261
+ '''The number of Metadata IOPS provisioned for the file system.
2262
+
2242
2263
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-metadataconfiguration.html#cfn-fsx-filesystem-metadataconfiguration-iops
2243
2264
  '''
2244
2265
  result = self._values.get("iops")
@@ -2246,7 +2267,8 @@ class CfnFileSystem(
2246
2267
 
2247
2268
  @builtins.property
2248
2269
  def mode(self) -> typing.Optional[builtins.str]:
2249
- '''
2270
+ '''Specifies whether the file system is using the AUTOMATIC setting of metadata IOPS or if it is using a USER_PROVISIONED value.
2271
+
2250
2272
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-metadataconfiguration.html#cfn-fsx-filesystem-metadataconfiguration-mode
2251
2273
  '''
2252
2274
  result = self._values.get("mode")
@@ -2667,7 +2689,7 @@ class CfnFileSystem(
2667
2689
  :param read_cache_configuration: Specifies the optional provisioned SSD read cache on file systems that use the Intelligent-Tiering storage class.
2668
2690
  :param root_volume_configuration: The configuration Amazon FSx uses when creating the root value of the Amazon FSx for OpenZFS file system. All volumes are children of the root volume.
2669
2691
  :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.
2670
- :param throughput_capacity: Specifies the throughput of an Amazon FSx for OpenZFS file system, measured in megabytes per second (MBps). Valid values depend on the ``DeploymentType`` that you choose, as follows: - For ``MULTI_AZ_1`` and ``SINGLE_AZ_2`` , valid values are 160, 320, 640, 1280, 2560, 3840, 5120, 7680, or 10240 MBps. - For ``SINGLE_AZ_1`` , valid values are 64, 128, 256, 512, 1024, 2048, 3072, or 4096 MBps. You pay for additional throughput capacity that you provision.
2692
+ :param throughput_capacity: Specifies the throughput of an Amazon FSx for OpenZFS file system, measured in megabytes per second (MBps). Required if you are creating a new file system. Valid values depend on the ``DeploymentType`` that you choose, as follows: - For ``MULTI_AZ_1`` and ``SINGLE_AZ_2`` , valid values are 160, 320, 640, 1280, 2560, 3840, 5120, 7680, or 10240 MBps. - For ``SINGLE_AZ_1`` , valid values are 64, 128, 256, 512, 1024, 2048, 3072, or 4096 MBps. You pay for additional throughput capacity that you provision.
2671
2693
  :param weekly_maintenance_start_time: The preferred start time to perform weekly maintenance, formatted d:HH:MM in the UTC time zone, where d is the weekday number, from 1 through 7, beginning with Monday and ending with Sunday. For example, ``1:05:00`` specifies maintenance at 5 AM Monday.
2672
2694
 
2673
2695
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-filesystem-openzfsconfiguration.html
@@ -2917,6 +2939,8 @@ class CfnFileSystem(
2917
2939
  def throughput_capacity(self) -> typing.Optional[jsii.Number]:
2918
2940
  '''Specifies the throughput of an Amazon FSx for OpenZFS file system, measured in megabytes per second (MBps).
2919
2941
 
2942
+ Required if you are creating a new file system.
2943
+
2920
2944
  Valid values depend on the ``DeploymentType`` that you choose, as follows:
2921
2945
 
2922
2946
  - For ``MULTI_AZ_1`` and ``SINGLE_AZ_2`` , valid values are 160, 320, 640, 1280, 2560, 3840, 5120, 7680, or 10240 MBps.
@@ -3773,15 +3797,15 @@ class CfnFileSystemProps:
3773
3797
  :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.
3774
3798
  :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>`_ .
3775
3799
  :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.
3776
- :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
3777
- :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``
3778
- :param ontap_configuration: The ONTAP configuration properties of the FSx for ONTAP file system that you are creating.
3779
- :param open_zfs_configuration: The Amazon FSx for OpenZFS configuration properties for the file system that you are creating.
3800
+ :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 If this ID isn't specified, the Amazon FSx-managed key for your account is used. For more information, see `Encrypt <https://docs.aws.amazon.com//kms/latest/APIReference/API_Encrypt.html>`_ in the *AWS Key Management Service API Reference* .
3801
+ :param lustre_configuration: The Lustre configuration for the file system being created. This configuration is required if the ``FileSystemType`` is set to ``LUSTRE`` . .. epigraph:: The following parameters are not supported when creating Lustre file systems with a data repository association. - ``AutoImportPolicy`` - ``ExportPath`` - ``ImportedChunkSize`` - ``ImportPath``
3802
+ :param ontap_configuration: The ONTAP configuration properties of the FSx for ONTAP file system that you are creating. This configuration is required if the ``FileSystemType`` is set to ``ONTAP`` .
3803
+ :param open_zfs_configuration: The Amazon FSx for OpenZFS configuration properties for the file system that you are creating. This configuration is required if the ``FileSystemType`` is set to ``OPENZFS`` .
3780
3804
  :param security_group_ids: A list of IDs specifying the security groups to apply to all network interfaces created for file system access. This list isn't returned in later requests to describe the file system. .. epigraph:: You must specify a security group if you are creating a Multi-AZ FSx for ONTAP file system in a VPC subnet that has been shared with you.
3781
3805
  :param storage_capacity: Sets the storage capacity of the file system that you're creating. ``StorageCapacity`` is required if you are creating a new file system. It is not required if you are creating a file system by restoring a backup. *FSx for Lustre file systems* - The amount of storage capacity that you can configure depends on the value that you set for ``StorageType`` and the Lustre ``DeploymentType`` , as follows: - For ``SCRATCH_2`` , ``PERSISTENT_2`` and ``PERSISTENT_1`` deployment types using SSD storage type, the valid values are 1200 GiB, 2400 GiB, and increments of 2400 GiB. - For ``PERSISTENT_1`` HDD file systems, valid values are increments of 6000 GiB for 12 MB/s/TiB file systems and increments of 1800 GiB for 40 MB/s/TiB file systems. - For ``SCRATCH_1`` deployment type, valid values are 1200 GiB, 2400 GiB, and increments of 3600 GiB. *FSx for ONTAP file systems* - The amount of SSD storage capacity that you can configure depends on the value of the ``HAPairs`` property. The minimum value is calculated as 1,024 GiB * HAPairs and the maximum is calculated as 524,288 GiB * HAPairs, up to a maximum amount of SSD storage capacity of 1,048,576 GiB (1 pebibyte). *FSx for OpenZFS file systems* - The amount of storage capacity that you can configure is from 64 GiB up to 524,288 GiB (512 TiB). If you are creating a file system from a backup, you can specify a storage capacity equal to or greater than the original file system's storage capacity. *FSx for Windows File Server file systems* - The amount of storage capacity that you can configure depends on the value that you set for ``StorageType`` as follows: - For SSD storage, valid values are 32 GiB-65,536 GiB (64 TiB). - For HDD storage, valid values are 2000 GiB-65,536 GiB (64 TiB).
3782
3806
  :param storage_type: Sets the storage class for the file system that you're creating. Valid values are ``SSD`` , ``HDD`` , and ``INTELLIGENT_TIERING`` . - Set to ``SSD`` to use solid state drive storage. SSD is supported on all Windows, Lustre, ONTAP, and OpenZFS deployment types. - Set to ``HDD`` to use hard disk drive storage, which is supported on ``SINGLE_AZ_2`` and ``MULTI_AZ_1`` Windows file system deployment types, and on ``PERSISTENT_1`` Lustre file system deployment types. - Set to ``INTELLIGENT_TIERING`` to use fully elastic, intelligently-tiered storage. Intelligent-Tiering is only available for OpenZFS file systems with the Multi-AZ deployment type and for Lustre file systems with the Persistent_2 deployment type. Default value is ``SSD`` . For more information, see `Storage type options <https://docs.aws.amazon.com/fsx/latest/WindowsGuide/optimize-fsx-costs.html#storage-type-options>`_ in the *FSx for Windows File Server User Guide* , `FSx for Lustre storage classes <https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html#lustre-storage-classes>`_ in the *FSx for Lustre User Guide* , and `Working with Intelligent-Tiering <https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/performance-intelligent-tiering>`_ in the *Amazon FSx for OpenZFS User Guide* .
3783
3807
  :param tags: The tags to associate with the file system. For more information, see `Tagging your Amazon FSx resources <https://docs.aws.amazon.com/fsx/latest/LustreGuide/tag-resources.html>`_ in the *Amazon FSx for Lustre User Guide* .
3784
- :param windows_configuration: The configuration object for the Microsoft Windows file system you are creating. This value is required if ``FileSystemType`` is set to ``WINDOWS`` .
3808
+ :param windows_configuration: The configuration object for the Microsoft Windows file system you are creating. This configuration is required if ``FileSystemType`` is set to ``WINDOWS`` .
3785
3809
 
3786
3810
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-filesystem.html
3787
3811
  :exampleMetadata: fixture=_generated
@@ -4035,6 +4059,8 @@ class CfnFileSystemProps:
4035
4059
  - Amazon FSx for OpenZFS
4036
4060
  - Amazon FSx for Windows File Server
4037
4061
 
4062
+ If this ID isn't specified, the Amazon FSx-managed key for your account is used. For more information, see `Encrypt <https://docs.aws.amazon.com//kms/latest/APIReference/API_Encrypt.html>`_ in the *AWS Key Management Service API Reference* .
4063
+
4038
4064
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-filesystem.html#cfn-fsx-filesystem-kmskeyid
4039
4065
  '''
4040
4066
  result = self._values.get("kms_key_id")
@@ -4046,6 +4072,7 @@ class CfnFileSystemProps:
4046
4072
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnFileSystem.LustreConfigurationProperty]]:
4047
4073
  '''The Lustre configuration for the file system being created.
4048
4074
 
4075
+ This configuration is required if the ``FileSystemType`` is set to ``LUSTRE`` .
4049
4076
  .. epigraph::
4050
4077
 
4051
4078
  The following parameters are not supported when creating Lustre file systems with a data repository association.
@@ -4066,6 +4093,8 @@ class CfnFileSystemProps:
4066
4093
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnFileSystem.OntapConfigurationProperty]]:
4067
4094
  '''The ONTAP configuration properties of the FSx for ONTAP file system that you are creating.
4068
4095
 
4096
+ This configuration is required if the ``FileSystemType`` is set to ``ONTAP`` .
4097
+
4069
4098
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-filesystem.html#cfn-fsx-filesystem-ontapconfiguration
4070
4099
  '''
4071
4100
  result = self._values.get("ontap_configuration")
@@ -4077,6 +4106,8 @@ class CfnFileSystemProps:
4077
4106
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnFileSystem.OpenZFSConfigurationProperty]]:
4078
4107
  '''The Amazon FSx for OpenZFS configuration properties for the file system that you are creating.
4079
4108
 
4109
+ This configuration is required if the ``FileSystemType`` is set to ``OPENZFS`` .
4110
+
4080
4111
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-filesystem.html#cfn-fsx-filesystem-openzfsconfiguration
4081
4112
  '''
4082
4113
  result = self._values.get("open_zfs_configuration")
@@ -4156,7 +4187,7 @@ class CfnFileSystemProps:
4156
4187
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnFileSystem.WindowsConfigurationProperty]]:
4157
4188
  '''The configuration object for the Microsoft Windows file system you are creating.
4158
4189
 
4159
- This value is required if ``FileSystemType`` is set to ``WINDOWS`` .
4190
+ This configuration is required if ``FileSystemType`` is set to ``WINDOWS`` .
4160
4191
 
4161
4192
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-filesystem.html#cfn-fsx-filesystem-windowsconfiguration
4162
4193
  '''
@@ -4181,7 +4212,7 @@ class CfnS3AccessPointAttachment(
4181
4212
  metaclass=jsii.JSIIMeta,
4182
4213
  jsii_type="aws-cdk-lib.aws_fsx.CfnS3AccessPointAttachment",
4183
4214
  ):
4184
- '''Resource type definition for AWS::FSx::S3AccessPointAttachment.
4215
+ '''An S3 access point attached to an Amazon FSx volume.
4185
4216
 
4186
4217
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-s3accesspointattachment.html
4187
4218
  :cloudformationResource: AWS::FSx::S3AccessPointAttachment
@@ -4239,10 +4270,10 @@ class CfnS3AccessPointAttachment(
4239
4270
  '''
4240
4271
  :param scope: Scope in which this resource is defined.
4241
4272
  :param id: Construct identifier for this resource (unique in its scope).
4242
- :param name: The Name of the S3AccessPointAttachment.
4243
- :param open_zfs_configuration:
4244
- :param type:
4245
- :param s3_access_point:
4273
+ :param name: The name of the S3 access point attachment; also used for the name of the S3 access point.
4274
+ :param open_zfs_configuration: The OpenZFSConfiguration of the S3 access point attachment.
4275
+ :param type: The type of Amazon FSx volume that the S3 access point is attached to.
4276
+ :param s3_access_point: The S3 access point configuration of the S3 access point attachment.
4246
4277
  '''
4247
4278
  if __debug__:
4248
4279
  type_hints = typing.get_type_hints(_typecheckingstub__f51e0b107c6c6ca8bc284dbcf4013f6c7bcdd088cb084476fdf615b4d8ae257e)
@@ -4290,7 +4321,8 @@ class CfnS3AccessPointAttachment(
4290
4321
  @builtins.property
4291
4322
  @jsii.member(jsii_name="attrS3AccessPointAlias")
4292
4323
  def attr_s3_access_point_alias(self) -> builtins.str:
4293
- '''
4324
+ '''The S3 access point's alias.
4325
+
4294
4326
  :cloudformationAttribute: S3AccessPoint.Alias
4295
4327
  '''
4296
4328
  return typing.cast(builtins.str, jsii.get(self, "attrS3AccessPointAlias"))
@@ -4298,7 +4330,8 @@ class CfnS3AccessPointAttachment(
4298
4330
  @builtins.property
4299
4331
  @jsii.member(jsii_name="attrS3AccessPointResourceArn")
4300
4332
  def attr_s3_access_point_resource_arn(self) -> builtins.str:
4301
- '''
4333
+ '''The S3 access point's ARN.
4334
+
4302
4335
  :cloudformationAttribute: S3AccessPoint.ResourceARN
4303
4336
  '''
4304
4337
  return typing.cast(builtins.str, jsii.get(self, "attrS3AccessPointResourceArn"))
@@ -4311,7 +4344,7 @@ class CfnS3AccessPointAttachment(
4311
4344
  @builtins.property
4312
4345
  @jsii.member(jsii_name="name")
4313
4346
  def name(self) -> builtins.str:
4314
- '''The Name of the S3AccessPointAttachment.'''
4347
+ '''The name of the S3 access point attachment;'''
4315
4348
  return typing.cast(builtins.str, jsii.get(self, "name"))
4316
4349
 
4317
4350
  @name.setter
@@ -4326,6 +4359,7 @@ class CfnS3AccessPointAttachment(
4326
4359
  def open_zfs_configuration(
4327
4360
  self,
4328
4361
  ) -> typing.Union[_IResolvable_da3f097b, "CfnS3AccessPointAttachment.S3AccessPointOpenZFSConfigurationProperty"]:
4362
+ '''The OpenZFSConfiguration of the S3 access point attachment.'''
4329
4363
  return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnS3AccessPointAttachment.S3AccessPointOpenZFSConfigurationProperty"], jsii.get(self, "openZfsConfiguration"))
4330
4364
 
4331
4365
  @open_zfs_configuration.setter
@@ -4341,6 +4375,7 @@ class CfnS3AccessPointAttachment(
4341
4375
  @builtins.property
4342
4376
  @jsii.member(jsii_name="type")
4343
4377
  def type(self) -> builtins.str:
4378
+ '''The type of Amazon FSx volume that the S3 access point is attached to.'''
4344
4379
  return typing.cast(builtins.str, jsii.get(self, "type"))
4345
4380
 
4346
4381
  @type.setter
@@ -4355,6 +4390,7 @@ class CfnS3AccessPointAttachment(
4355
4390
  def s3_access_point(
4356
4391
  self,
4357
4392
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnS3AccessPointAttachment.S3AccessPointProperty"]]:
4393
+ '''The S3 access point configuration of the S3 access point attachment.'''
4358
4394
  return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnS3AccessPointAttachment.S3AccessPointProperty"]], jsii.get(self, "s3AccessPoint"))
4359
4395
 
4360
4396
  @s3_access_point.setter
@@ -4374,8 +4410,9 @@ class CfnS3AccessPointAttachment(
4374
4410
  )
4375
4411
  class FileSystemGIDProperty:
4376
4412
  def __init__(self, *, gid: jsii.Number) -> None:
4377
- '''
4378
- :param gid:
4413
+ '''The GID of the file system user.
4414
+
4415
+ :param gid: The GID of the file system user.
4379
4416
 
4380
4417
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-filesystemgid.html
4381
4418
  :exampleMetadata: fixture=_generated
@@ -4399,7 +4436,8 @@ class CfnS3AccessPointAttachment(
4399
4436
 
4400
4437
  @builtins.property
4401
4438
  def gid(self) -> jsii.Number:
4402
- '''
4439
+ '''The GID of the file system user.
4440
+
4403
4441
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-filesystemgid.html#cfn-fsx-s3accesspointattachment-filesystemgid-gid
4404
4442
  '''
4405
4443
  result = self._values.get("gid")
@@ -4429,9 +4467,10 @@ class CfnS3AccessPointAttachment(
4429
4467
  posix_user: typing.Union[_IResolvable_da3f097b, typing.Union["CfnS3AccessPointAttachment.OpenZFSPosixFileSystemUserProperty", typing.Dict[builtins.str, typing.Any]]],
4430
4468
  type: builtins.str,
4431
4469
  ) -> None:
4432
- '''
4433
- :param posix_user:
4434
- :param type:
4470
+ '''Specifies the file system user identity that will be used for authorizing all file access requests that are made using the S3 access point.
4471
+
4472
+ :param posix_user: Specifies the UID and GIDs of the file system POSIX user.
4473
+ :param type: Specifies the FSx for OpenZFS user identity type, accepts only ``POSIX`` .
4435
4474
 
4436
4475
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-openzfsfilesystemidentity.html
4437
4476
  :exampleMetadata: fixture=_generated
@@ -4468,7 +4507,8 @@ class CfnS3AccessPointAttachment(
4468
4507
  def posix_user(
4469
4508
  self,
4470
4509
  ) -> typing.Union[_IResolvable_da3f097b, "CfnS3AccessPointAttachment.OpenZFSPosixFileSystemUserProperty"]:
4471
- '''
4510
+ '''Specifies the UID and GIDs of the file system POSIX user.
4511
+
4472
4512
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-openzfsfilesystemidentity.html#cfn-fsx-s3accesspointattachment-openzfsfilesystemidentity-posixuser
4473
4513
  '''
4474
4514
  result = self._values.get("posix_user")
@@ -4477,7 +4517,8 @@ class CfnS3AccessPointAttachment(
4477
4517
 
4478
4518
  @builtins.property
4479
4519
  def type(self) -> builtins.str:
4480
- '''
4520
+ '''Specifies the FSx for OpenZFS user identity type, accepts only ``POSIX`` .
4521
+
4481
4522
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-openzfsfilesystemidentity.html#cfn-fsx-s3accesspointattachment-openzfsfilesystemidentity-type
4482
4523
  '''
4483
4524
  result = self._values.get("type")
@@ -4508,10 +4549,11 @@ class CfnS3AccessPointAttachment(
4508
4549
  uid: jsii.Number,
4509
4550
  secondary_gids: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnS3AccessPointAttachment.FileSystemGIDProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
4510
4551
  ) -> None:
4511
- '''
4512
- :param gid:
4513
- :param uid:
4514
- :param secondary_gids:
4552
+ '''The FSx for OpenZFS file system user that is used for authorizing all file access requests that are made using the S3 access point.
4553
+
4554
+ :param gid: The GID of the file system user.
4555
+ :param uid: The UID of the file system user.
4556
+ :param secondary_gids: The list of secondary GIDs for the file system user.
4515
4557
 
4516
4558
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-openzfsposixfilesystemuser.html
4517
4559
  :exampleMetadata: fixture=_generated
@@ -4546,7 +4588,8 @@ class CfnS3AccessPointAttachment(
4546
4588
 
4547
4589
  @builtins.property
4548
4590
  def gid(self) -> jsii.Number:
4549
- '''
4591
+ '''The GID of the file system user.
4592
+
4550
4593
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-openzfsposixfilesystemuser.html#cfn-fsx-s3accesspointattachment-openzfsposixfilesystemuser-gid
4551
4594
  '''
4552
4595
  result = self._values.get("gid")
@@ -4555,7 +4598,8 @@ class CfnS3AccessPointAttachment(
4555
4598
 
4556
4599
  @builtins.property
4557
4600
  def uid(self) -> jsii.Number:
4558
- '''
4601
+ '''The UID of the file system user.
4602
+
4559
4603
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-openzfsposixfilesystemuser.html#cfn-fsx-s3accesspointattachment-openzfsposixfilesystemuser-uid
4560
4604
  '''
4561
4605
  result = self._values.get("uid")
@@ -4566,7 +4610,8 @@ class CfnS3AccessPointAttachment(
4566
4610
  def secondary_gids(
4567
4611
  self,
4568
4612
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnS3AccessPointAttachment.FileSystemGIDProperty"]]]]:
4569
- '''
4613
+ '''The list of secondary GIDs for the file system user.
4614
+
4570
4615
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-openzfsposixfilesystemuser.html#cfn-fsx-s3accesspointattachment-openzfsposixfilesystemuser-secondarygids
4571
4616
  '''
4572
4617
  result = self._values.get("secondary_gids")
@@ -4598,9 +4643,10 @@ class CfnS3AccessPointAttachment(
4598
4643
  file_system_identity: typing.Union[_IResolvable_da3f097b, typing.Union["CfnS3AccessPointAttachment.OpenZFSFileSystemIdentityProperty", typing.Dict[builtins.str, typing.Any]]],
4599
4644
  volume_id: builtins.str,
4600
4645
  ) -> None:
4601
- '''
4602
- :param file_system_identity:
4603
- :param volume_id:
4646
+ '''Describes the FSx for OpenZFS attachment configuration of an S3 access point attachment.
4647
+
4648
+ :param file_system_identity: The file system identity used to authorize file access requests made using the S3 access point.
4649
+ :param volume_id: The ID of the FSx for OpenZFS volume that the S3 access point is attached to.
4604
4650
 
4605
4651
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspointopenzfsconfiguration.html
4606
4652
  :exampleMetadata: fixture=_generated
@@ -4640,7 +4686,8 @@ class CfnS3AccessPointAttachment(
4640
4686
  def file_system_identity(
4641
4687
  self,
4642
4688
  ) -> typing.Union[_IResolvable_da3f097b, "CfnS3AccessPointAttachment.OpenZFSFileSystemIdentityProperty"]:
4643
- '''
4689
+ '''The file system identity used to authorize file access requests made using the S3 access point.
4690
+
4644
4691
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspointopenzfsconfiguration.html#cfn-fsx-s3accesspointattachment-s3accesspointopenzfsconfiguration-filesystemidentity
4645
4692
  '''
4646
4693
  result = self._values.get("file_system_identity")
@@ -4649,7 +4696,8 @@ class CfnS3AccessPointAttachment(
4649
4696
 
4650
4697
  @builtins.property
4651
4698
  def volume_id(self) -> builtins.str:
4652
- '''
4699
+ '''The ID of the FSx for OpenZFS volume that the S3 access point is attached to.
4700
+
4653
4701
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspointopenzfsconfiguration.html#cfn-fsx-s3accesspointattachment-s3accesspointopenzfsconfiguration-volumeid
4654
4702
  '''
4655
4703
  result = self._values.get("volume_id")
@@ -4686,11 +4734,12 @@ class CfnS3AccessPointAttachment(
4686
4734
  resource_arn: typing.Optional[builtins.str] = None,
4687
4735
  vpc_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnS3AccessPointAttachment.S3AccessPointVpcConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
4688
4736
  ) -> None:
4689
- '''
4690
- :param alias:
4691
- :param policy:
4692
- :param resource_arn:
4693
- :param vpc_configuration:
4737
+ '''Describes the S3 access point configuration of the S3 access point attachment.
4738
+
4739
+ :param alias: The S3 access point's alias.
4740
+ :param policy: The S3 access point's policy.
4741
+ :param resource_arn: The S3 access point's ARN.
4742
+ :param vpc_configuration: The S3 access point's virtual private cloud (VPC) configuration.
4694
4743
 
4695
4744
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspoint.html
4696
4745
  :exampleMetadata: fixture=_generated
@@ -4730,7 +4779,8 @@ class CfnS3AccessPointAttachment(
4730
4779
 
4731
4780
  @builtins.property
4732
4781
  def alias(self) -> typing.Optional[builtins.str]:
4733
- '''
4782
+ '''The S3 access point's alias.
4783
+
4734
4784
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspoint.html#cfn-fsx-s3accesspointattachment-s3accesspoint-alias
4735
4785
  '''
4736
4786
  result = self._values.get("alias")
@@ -4738,7 +4788,8 @@ class CfnS3AccessPointAttachment(
4738
4788
 
4739
4789
  @builtins.property
4740
4790
  def policy(self) -> typing.Any:
4741
- '''
4791
+ '''The S3 access point's policy.
4792
+
4742
4793
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspoint.html#cfn-fsx-s3accesspointattachment-s3accesspoint-policy
4743
4794
  '''
4744
4795
  result = self._values.get("policy")
@@ -4746,7 +4797,8 @@ class CfnS3AccessPointAttachment(
4746
4797
 
4747
4798
  @builtins.property
4748
4799
  def resource_arn(self) -> typing.Optional[builtins.str]:
4749
- '''
4800
+ '''The S3 access point's ARN.
4801
+
4750
4802
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspoint.html#cfn-fsx-s3accesspointattachment-s3accesspoint-resourcearn
4751
4803
  '''
4752
4804
  result = self._values.get("resource_arn")
@@ -4756,7 +4808,8 @@ class CfnS3AccessPointAttachment(
4756
4808
  def vpc_configuration(
4757
4809
  self,
4758
4810
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnS3AccessPointAttachment.S3AccessPointVpcConfigurationProperty"]]:
4759
- '''
4811
+ '''The S3 access point's virtual private cloud (VPC) configuration.
4812
+
4760
4813
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspoint.html#cfn-fsx-s3accesspointattachment-s3accesspoint-vpcconfiguration
4761
4814
  '''
4762
4815
  result = self._values.get("vpc_configuration")
@@ -4780,8 +4833,9 @@ class CfnS3AccessPointAttachment(
4780
4833
  )
4781
4834
  class S3AccessPointVpcConfigurationProperty:
4782
4835
  def __init__(self, *, vpc_id: builtins.str) -> None:
4783
- '''
4784
- :param vpc_id:
4836
+ '''If included, Amazon S3 restricts access to this access point to requests from the specified virtual private cloud (VPC).
4837
+
4838
+ :param vpc_id: Specifies the virtual private cloud (VPC) for the S3 access point VPC configuration, if one exists.
4785
4839
 
4786
4840
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspointvpcconfiguration.html
4787
4841
  :exampleMetadata: fixture=_generated
@@ -4805,7 +4859,8 @@ class CfnS3AccessPointAttachment(
4805
4859
 
4806
4860
  @builtins.property
4807
4861
  def vpc_id(self) -> builtins.str:
4808
- '''
4862
+ '''Specifies the virtual private cloud (VPC) for the S3 access point VPC configuration, if one exists.
4863
+
4809
4864
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-fsx-s3accesspointattachment-s3accesspointvpcconfiguration.html#cfn-fsx-s3accesspointattachment-s3accesspointvpcconfiguration-vpcid
4810
4865
  '''
4811
4866
  result = self._values.get("vpc_id")
@@ -4845,10 +4900,10 @@ class CfnS3AccessPointAttachmentProps:
4845
4900
  ) -> None:
4846
4901
  '''Properties for defining a ``CfnS3AccessPointAttachment``.
4847
4902
 
4848
- :param name: The Name of the S3AccessPointAttachment.
4849
- :param open_zfs_configuration:
4850
- :param type:
4851
- :param s3_access_point:
4903
+ :param name: The name of the S3 access point attachment; also used for the name of the S3 access point.
4904
+ :param open_zfs_configuration: The OpenZFSConfiguration of the S3 access point attachment.
4905
+ :param type: The type of Amazon FSx volume that the S3 access point is attached to.
4906
+ :param s3_access_point: The S3 access point configuration of the S3 access point attachment.
4852
4907
 
4853
4908
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-s3accesspointattachment.html
4854
4909
  :exampleMetadata: fixture=_generated
@@ -4907,7 +4962,9 @@ class CfnS3AccessPointAttachmentProps:
4907
4962
 
4908
4963
  @builtins.property
4909
4964
  def name(self) -> builtins.str:
4910
- '''The Name of the S3AccessPointAttachment.
4965
+ '''The name of the S3 access point attachment;
4966
+
4967
+ also used for the name of the S3 access point.
4911
4968
 
4912
4969
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-s3accesspointattachment.html#cfn-fsx-s3accesspointattachment-name
4913
4970
  '''
@@ -4919,7 +4976,8 @@ class CfnS3AccessPointAttachmentProps:
4919
4976
  def open_zfs_configuration(
4920
4977
  self,
4921
4978
  ) -> typing.Union[_IResolvable_da3f097b, CfnS3AccessPointAttachment.S3AccessPointOpenZFSConfigurationProperty]:
4922
- '''
4979
+ '''The OpenZFSConfiguration of the S3 access point attachment.
4980
+
4923
4981
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-s3accesspointattachment.html#cfn-fsx-s3accesspointattachment-openzfsconfiguration
4924
4982
  '''
4925
4983
  result = self._values.get("open_zfs_configuration")
@@ -4928,7 +4986,8 @@ class CfnS3AccessPointAttachmentProps:
4928
4986
 
4929
4987
  @builtins.property
4930
4988
  def type(self) -> builtins.str:
4931
- '''
4989
+ '''The type of Amazon FSx volume that the S3 access point is attached to.
4990
+
4932
4991
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-s3accesspointattachment.html#cfn-fsx-s3accesspointattachment-type
4933
4992
  '''
4934
4993
  result = self._values.get("type")
@@ -4939,7 +4998,8 @@ class CfnS3AccessPointAttachmentProps:
4939
4998
  def s3_access_point(
4940
4999
  self,
4941
5000
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnS3AccessPointAttachment.S3AccessPointProperty]]:
4942
- '''
5001
+ '''The S3 access point configuration of the S3 access point attachment.
5002
+
4943
5003
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-fsx-s3accesspointattachment.html#cfn-fsx-s3accesspointattachment-s3accesspoint
4944
5004
  '''
4945
5005
  result = self._values.get("s3_access_point")