aws-cdk-lib 2.155.0__py3-none-any.whl → 2.157.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 (66) hide show
  1. aws_cdk/__init__.py +28 -24
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.155.0.jsii.tgz → aws-cdk-lib@2.157.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_acmpca/__init__.py +10 -75
  5. aws_cdk/aws_amplify/__init__.py +106 -0
  6. aws_cdk/aws_apigatewayv2/__init__.py +81 -13
  7. aws_cdk/aws_appintegrations/__init__.py +14 -14
  8. aws_cdk/aws_applicationsignals/__init__.py +750 -1
  9. aws_cdk/aws_appsync/__init__.py +50 -18
  10. aws_cdk/aws_autoscaling/__init__.py +6 -6
  11. aws_cdk/aws_backup/__init__.py +39 -0
  12. aws_cdk/aws_batch/__init__.py +41 -0
  13. aws_cdk/aws_bedrock/__init__.py +1528 -91
  14. aws_cdk/aws_chatbot/__init__.py +6 -6
  15. aws_cdk/aws_cloudformation/__init__.py +22 -22
  16. aws_cdk/aws_cloudfront/__init__.py +650 -57
  17. aws_cdk/aws_cloudfront/experimental/__init__.py +30 -3
  18. aws_cdk/aws_cloudfront_origins/__init__.py +2034 -91
  19. aws_cdk/aws_codebuild/__init__.py +1 -1
  20. aws_cdk/aws_datasync/__init__.py +40 -29
  21. aws_cdk/aws_docdb/__init__.py +78 -6
  22. aws_cdk/aws_ec2/__init__.py +397 -75
  23. aws_cdk/aws_ecs/__init__.py +271 -101
  24. aws_cdk/aws_ecs_patterns/__init__.py +129 -11
  25. aws_cdk/aws_eks/__init__.py +40 -4
  26. aws_cdk/aws_elasticloadbalancingv2/__init__.py +26 -50
  27. aws_cdk/aws_entityresolution/__init__.py +117 -4
  28. aws_cdk/aws_events/__init__.py +40 -14
  29. aws_cdk/aws_events_targets/__init__.py +357 -0
  30. aws_cdk/aws_glue/__init__.py +0 -8
  31. aws_cdk/aws_groundstation/__init__.py +27 -16
  32. aws_cdk/aws_guardduty/__init__.py +26 -14
  33. aws_cdk/aws_iam/__init__.py +7 -8
  34. aws_cdk/aws_iotfleetwise/__init__.py +108 -0
  35. aws_cdk/aws_kms/__init__.py +53 -10
  36. aws_cdk/aws_lambda/__init__.py +147 -17
  37. aws_cdk/aws_lambda_nodejs/__init__.py +30 -3
  38. aws_cdk/aws_macie/__init__.py +4 -4
  39. aws_cdk/aws_medialive/__init__.py +348 -0
  40. aws_cdk/aws_mediapackagev2/__init__.py +38 -38
  41. aws_cdk/aws_neptune/__init__.py +14 -8
  42. aws_cdk/aws_opensearchservice/__init__.py +194 -0
  43. aws_cdk/aws_pcaconnectorscep/__init__.py +884 -0
  44. aws_cdk/aws_personalize/__init__.py +2 -2
  45. aws_cdk/aws_pipes/__init__.py +22 -22
  46. aws_cdk/aws_qbusiness/__init__.py +675 -6
  47. aws_cdk/aws_quicksight/__init__.py +3285 -0
  48. aws_cdk/aws_rds/__init__.py +24 -0
  49. aws_cdk/aws_s3/__init__.py +13 -14
  50. aws_cdk/aws_sagemaker/__init__.py +1167 -0
  51. aws_cdk/aws_secretsmanager/__init__.py +2 -3
  52. aws_cdk/aws_securityhub/__init__.py +108 -103
  53. aws_cdk/aws_ses/__init__.py +31 -0
  54. aws_cdk/aws_sns/__init__.py +19 -13
  55. aws_cdk/aws_ssm/__init__.py +10 -6
  56. aws_cdk/aws_ssmquicksetup/__init__.py +967 -0
  57. aws_cdk/aws_stepfunctions_tasks/__init__.py +106 -45
  58. aws_cdk/aws_synthetics/__init__.py +13 -0
  59. aws_cdk/cx_api/__init__.py +16 -0
  60. aws_cdk/triggers/__init__.py +30 -3
  61. {aws_cdk_lib-2.155.0.dist-info → aws_cdk_lib-2.157.0.dist-info}/METADATA +1 -1
  62. {aws_cdk_lib-2.155.0.dist-info → aws_cdk_lib-2.157.0.dist-info}/RECORD +66 -64
  63. {aws_cdk_lib-2.155.0.dist-info → aws_cdk_lib-2.157.0.dist-info}/LICENSE +0 -0
  64. {aws_cdk_lib-2.155.0.dist-info → aws_cdk_lib-2.157.0.dist-info}/NOTICE +0 -0
  65. {aws_cdk_lib-2.155.0.dist-info → aws_cdk_lib-2.157.0.dist-info}/WHEEL +0 -0
  66. {aws_cdk_lib-2.155.0.dist-info → aws_cdk_lib-2.157.0.dist-info}/top_level.txt +0 -0
@@ -10832,7 +10832,7 @@ class LinuxArmBuildImage(
10832
10832
  fleet: typing.Optional[IFleet] = None,
10833
10833
  privileged: typing.Optional[builtins.bool] = None,
10834
10834
  ) -> typing.List[builtins.str]:
10835
- '''Validates by checking the BuildEnvironment computeType as aarch64 images only support ComputeType.SMALL and ComputeType.LARGE.
10835
+ '''Validates by checking the BuildEnvironments' images are not Lambda ComputeTypes.
10836
10836
 
10837
10837
  :param build_image: The image used for the builds. Default: LinuxBuildImage.STANDARD_1_0
10838
10838
  :param certificate: The location of the PEM-encoded certificate for the build project. Default: - No external certificate is added to the project
@@ -997,12 +997,12 @@ class CfnLocationEFS(
997
997
  '''
998
998
  :param scope: Scope in which this resource is defined.
999
999
  :param id: Construct identifier for this resource (unique in its scope).
1000
- :param ec2_config: Specifies the subnet and security groups DataSync uses to access your Amazon EFS file system.
1001
- :param access_point_arn: Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to access the Amazon EFS file system.
1002
- :param efs_filesystem_arn: Specifies the ARN for the Amazon EFS file system.
1003
- :param file_system_access_role_arn: Specifies an AWS Identity and Access Management (IAM) role that DataSync assumes when mounting the Amazon EFS file system.
1004
- :param in_transit_encryption: Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it copies data to or from the Amazon EFS file system. If you specify an access point using ``AccessPointArn`` or an IAM role using ``FileSystemAccessRoleArn`` , you must set this parameter to ``TLS1_2`` .
1005
- :param subdirectory: Specifies a mount path for your Amazon EFS file system. This is where DataSync reads or writes data (depending on if this is a source or destination location). By default, DataSync uses the root directory, but you can also include subdirectories. .. epigraph:: You must specify a value with forward slashes (for example, ``/path/to/folder`` ).
1000
+ :param ec2_config: Specifies the subnet and security groups DataSync uses to connect to one of your Amazon EFS file system's `mount targets <https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html>`_ .
1001
+ :param access_point_arn: Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to mount your Amazon EFS file system. For more information, see `Accessing restricted file systems <https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam>`_ .
1002
+ :param efs_filesystem_arn: Specifies the ARN for your Amazon EFS file system.
1003
+ :param file_system_access_role_arn: Specifies an AWS Identity and Access Management (IAM) role that allows DataSync to access your Amazon EFS file system. For information on creating this role, see `Creating a DataSync IAM role for file system access <https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role>`_ .
1004
+ :param in_transit_encryption: Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it transfers data to or from your Amazon EFS file system. If you specify an access point using ``AccessPointArn`` or an IAM role using ``FileSystemAccessRoleArn`` , you must set this parameter to ``TLS1_2`` .
1005
+ :param subdirectory: Specifies a mount path for your Amazon EFS file system. This is where DataSync reads or writes data (depending on if this is a source or destination location) on your file system. By default, DataSync uses the root directory (or `access point <https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html>`_ if you provide one by using ``AccessPointArn`` ). You can also include subdirectories using forward slashes (for example, ``/path/to/folder`` ).
1006
1006
  :param tags: Specifies the key-value pair that represents a tag that you want to add to the resource. The value can be an empty string. This value helps you manage, filter, and search for your resources. We recommend that you create a name tag for your location.
1007
1007
  '''
1008
1008
  if __debug__:
@@ -1085,7 +1085,7 @@ class CfnLocationEFS(
1085
1085
  def ec2_config(
1086
1086
  self,
1087
1087
  ) -> typing.Union[_IResolvable_da3f097b, "CfnLocationEFS.Ec2ConfigProperty"]:
1088
- '''Specifies the subnet and security groups DataSync uses to access your Amazon EFS file system.'''
1088
+ '''Specifies the subnet and security groups DataSync uses to connect to one of your Amazon EFS file system's `mount targets <https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html>`_ .'''
1089
1089
  return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnLocationEFS.Ec2ConfigProperty"], jsii.get(self, "ec2Config"))
1090
1090
 
1091
1091
  @ec2_config.setter
@@ -1101,7 +1101,7 @@ class CfnLocationEFS(
1101
1101
  @builtins.property
1102
1102
  @jsii.member(jsii_name="accessPointArn")
1103
1103
  def access_point_arn(self) -> typing.Optional[builtins.str]:
1104
- '''Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to access the Amazon EFS file system.'''
1104
+ '''Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to mount your Amazon EFS file system.'''
1105
1105
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "accessPointArn"))
1106
1106
 
1107
1107
  @access_point_arn.setter
@@ -1114,7 +1114,7 @@ class CfnLocationEFS(
1114
1114
  @builtins.property
1115
1115
  @jsii.member(jsii_name="efsFilesystemArn")
1116
1116
  def efs_filesystem_arn(self) -> typing.Optional[builtins.str]:
1117
- '''Specifies the ARN for the Amazon EFS file system.'''
1117
+ '''Specifies the ARN for your Amazon EFS file system.'''
1118
1118
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "efsFilesystemArn"))
1119
1119
 
1120
1120
  @efs_filesystem_arn.setter
@@ -1127,7 +1127,7 @@ class CfnLocationEFS(
1127
1127
  @builtins.property
1128
1128
  @jsii.member(jsii_name="fileSystemAccessRoleArn")
1129
1129
  def file_system_access_role_arn(self) -> typing.Optional[builtins.str]:
1130
- '''Specifies an AWS Identity and Access Management (IAM) role that DataSync assumes when mounting the Amazon EFS file system.'''
1130
+ '''Specifies an AWS Identity and Access Management (IAM) role that allows DataSync to access your Amazon EFS file system.'''
1131
1131
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "fileSystemAccessRoleArn"))
1132
1132
 
1133
1133
  @file_system_access_role_arn.setter
@@ -1140,7 +1140,7 @@ class CfnLocationEFS(
1140
1140
  @builtins.property
1141
1141
  @jsii.member(jsii_name="inTransitEncryption")
1142
1142
  def in_transit_encryption(self) -> typing.Optional[builtins.str]:
1143
- '''Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it copies data to or from the Amazon EFS file system.'''
1143
+ '''Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it transfers data to or from your Amazon EFS file system.'''
1144
1144
  return typing.cast(typing.Optional[builtins.str], jsii.get(self, "inTransitEncryption"))
1145
1145
 
1146
1146
  @in_transit_encryption.setter
@@ -1191,7 +1191,7 @@ class CfnLocationEFS(
1191
1191
  security_group_arns: typing.Sequence[builtins.str],
1192
1192
  subnet_arn: builtins.str,
1193
1193
  ) -> None:
1194
- '''The subnet and security groups that AWS DataSync uses to access your Amazon EFS file system.
1194
+ '''The subnet and security groups that AWS DataSync uses to connect to one of your Amazon EFS file system's `mount targets <https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html>`_ .
1195
1195
 
1196
1196
  :param security_group_arns: Specifies the Amazon Resource Names (ARNs) of the security groups associated with an Amazon EFS file system's mount target.
1197
1197
  :param subnet_arn: Specifies the ARN of a subnet where DataSync creates the `network interfaces <https://docs.aws.amazon.com/datasync/latest/userguide/datasync-network.html#required-network-interfaces>`_ for managing traffic during your transfer. The subnet must be located: - In the same virtual private cloud (VPC) as the Amazon EFS file system. - In the same Availability Zone as at least one mount target for the Amazon EFS file system. .. epigraph:: You don't need to specify a subnet that includes a file system mount target.
@@ -1287,12 +1287,12 @@ class CfnLocationEFSProps:
1287
1287
  ) -> None:
1288
1288
  '''Properties for defining a ``CfnLocationEFS``.
1289
1289
 
1290
- :param ec2_config: Specifies the subnet and security groups DataSync uses to access your Amazon EFS file system.
1291
- :param access_point_arn: Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to access the Amazon EFS file system.
1292
- :param efs_filesystem_arn: Specifies the ARN for the Amazon EFS file system.
1293
- :param file_system_access_role_arn: Specifies an AWS Identity and Access Management (IAM) role that DataSync assumes when mounting the Amazon EFS file system.
1294
- :param in_transit_encryption: Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it copies data to or from the Amazon EFS file system. If you specify an access point using ``AccessPointArn`` or an IAM role using ``FileSystemAccessRoleArn`` , you must set this parameter to ``TLS1_2`` .
1295
- :param subdirectory: Specifies a mount path for your Amazon EFS file system. This is where DataSync reads or writes data (depending on if this is a source or destination location). By default, DataSync uses the root directory, but you can also include subdirectories. .. epigraph:: You must specify a value with forward slashes (for example, ``/path/to/folder`` ).
1290
+ :param ec2_config: Specifies the subnet and security groups DataSync uses to connect to one of your Amazon EFS file system's `mount targets <https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html>`_ .
1291
+ :param access_point_arn: Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to mount your Amazon EFS file system. For more information, see `Accessing restricted file systems <https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam>`_ .
1292
+ :param efs_filesystem_arn: Specifies the ARN for your Amazon EFS file system.
1293
+ :param file_system_access_role_arn: Specifies an AWS Identity and Access Management (IAM) role that allows DataSync to access your Amazon EFS file system. For information on creating this role, see `Creating a DataSync IAM role for file system access <https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role>`_ .
1294
+ :param in_transit_encryption: Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it transfers data to or from your Amazon EFS file system. If you specify an access point using ``AccessPointArn`` or an IAM role using ``FileSystemAccessRoleArn`` , you must set this parameter to ``TLS1_2`` .
1295
+ :param subdirectory: Specifies a mount path for your Amazon EFS file system. This is where DataSync reads or writes data (depending on if this is a source or destination location) on your file system. By default, DataSync uses the root directory (or `access point <https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html>`_ if you provide one by using ``AccessPointArn`` ). You can also include subdirectories using forward slashes (for example, ``/path/to/folder`` ).
1296
1296
  :param tags: Specifies the key-value pair that represents a tag that you want to add to the resource. The value can be an empty string. This value helps you manage, filter, and search for your resources. We recommend that you create a name tag for your location.
1297
1297
 
1298
1298
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationefs.html
@@ -1351,7 +1351,7 @@ class CfnLocationEFSProps:
1351
1351
  def ec2_config(
1352
1352
  self,
1353
1353
  ) -> typing.Union[_IResolvable_da3f097b, CfnLocationEFS.Ec2ConfigProperty]:
1354
- '''Specifies the subnet and security groups DataSync uses to access your Amazon EFS file system.
1354
+ '''Specifies the subnet and security groups DataSync uses to connect to one of your Amazon EFS file system's `mount targets <https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html>`_ .
1355
1355
 
1356
1356
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationefs.html#cfn-datasync-locationefs-ec2config
1357
1357
  '''
@@ -1361,7 +1361,9 @@ class CfnLocationEFSProps:
1361
1361
 
1362
1362
  @builtins.property
1363
1363
  def access_point_arn(self) -> typing.Optional[builtins.str]:
1364
- '''Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to access the Amazon EFS file system.
1364
+ '''Specifies the Amazon Resource Name (ARN) of the access point that DataSync uses to mount your Amazon EFS file system.
1365
+
1366
+ For more information, see `Accessing restricted file systems <https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam>`_ .
1365
1367
 
1366
1368
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationefs.html#cfn-datasync-locationefs-accesspointarn
1367
1369
  '''
@@ -1370,7 +1372,7 @@ class CfnLocationEFSProps:
1370
1372
 
1371
1373
  @builtins.property
1372
1374
  def efs_filesystem_arn(self) -> typing.Optional[builtins.str]:
1373
- '''Specifies the ARN for the Amazon EFS file system.
1375
+ '''Specifies the ARN for your Amazon EFS file system.
1374
1376
 
1375
1377
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationefs.html#cfn-datasync-locationefs-efsfilesystemarn
1376
1378
  '''
@@ -1379,7 +1381,9 @@ class CfnLocationEFSProps:
1379
1381
 
1380
1382
  @builtins.property
1381
1383
  def file_system_access_role_arn(self) -> typing.Optional[builtins.str]:
1382
- '''Specifies an AWS Identity and Access Management (IAM) role that DataSync assumes when mounting the Amazon EFS file system.
1384
+ '''Specifies an AWS Identity and Access Management (IAM) role that allows DataSync to access your Amazon EFS file system.
1385
+
1386
+ For information on creating this role, see `Creating a DataSync IAM role for file system access <https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role>`_ .
1383
1387
 
1384
1388
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationefs.html#cfn-datasync-locationefs-filesystemaccessrolearn
1385
1389
  '''
@@ -1388,7 +1392,7 @@ class CfnLocationEFSProps:
1388
1392
 
1389
1393
  @builtins.property
1390
1394
  def in_transit_encryption(self) -> typing.Optional[builtins.str]:
1391
- '''Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it copies data to or from the Amazon EFS file system.
1395
+ '''Specifies whether you want DataSync to use Transport Layer Security (TLS) 1.2 encryption when it transfers data to or from your Amazon EFS file system.
1392
1396
 
1393
1397
  If you specify an access point using ``AccessPointArn`` or an IAM role using ``FileSystemAccessRoleArn`` , you must set this parameter to ``TLS1_2`` .
1394
1398
 
@@ -1401,10 +1405,9 @@ class CfnLocationEFSProps:
1401
1405
  def subdirectory(self) -> typing.Optional[builtins.str]:
1402
1406
  '''Specifies a mount path for your Amazon EFS file system.
1403
1407
 
1404
- This is where DataSync reads or writes data (depending on if this is a source or destination location). By default, DataSync uses the root directory, but you can also include subdirectories.
1405
- .. epigraph::
1408
+ This is where DataSync reads or writes data (depending on if this is a source or destination location) on your file system.
1406
1409
 
1407
- You must specify a value with forward slashes (for example, ``/path/to/folder`` ).
1410
+ By default, DataSync uses the root directory (or `access point <https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html>`_ if you provide one by using ``AccessPointArn`` ). You can also include subdirectories using forward slashes (for example, ``/path/to/folder`` ).
1408
1411
 
1409
1412
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-datasync-locationefs.html#cfn-datasync-locationefs-subdirectory
1410
1413
  '''
@@ -8428,7 +8431,7 @@ class CfnTask(
8428
8431
  ) -> None:
8429
8432
  '''Configures your AWS DataSync task to run on a `schedule <https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html>`_ (at a minimum interval of 1 hour).
8430
8433
 
8431
- :param schedule_expression: Specifies your task schedule by using a cron expression in UTC time. For information about cron expression syntax, see the `*Amazon EventBridge User Guide* <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html>`_ .
8434
+ :param schedule_expression: Specifies your task schedule by using a cron or rate expression. Use cron expressions for task schedules that run on a specific time and day. For example, the following cron expression creates a task schedule that runs at 8 AM on the first Wednesday of every month: ``cron(0 8 * * 3#1)`` Use rate expressions for task schedules that run on a regular interval. For example, the following rate expression creates a task schedule that runs every 12 hours: ``rate(12 hours)`` For information about cron and rate expression syntax, see the `*Amazon EventBridge User Guide* <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html>`_ .
8432
8435
  :param status: Specifies whether to enable or disable your task schedule. Your schedule is enabled by default, but there can be situations where you need to disable it. For example, you might need to perform maintenance on a storage system before you can begin a recurring DataSync transfer. DataSync might disable your schedule automatically if your task fails repeatedly with the same error. For more information, see the `*DataSync User Guide* <https://docs.aws.amazon.com/datasync/latest/userguide/task-scheduling.html#pause-task-schedule>`_ .
8433
8436
 
8434
8437
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-taskschedule.html
@@ -8457,9 +8460,17 @@ class CfnTask(
8457
8460
 
8458
8461
  @builtins.property
8459
8462
  def schedule_expression(self) -> typing.Optional[builtins.str]:
8460
- '''Specifies your task schedule by using a cron expression in UTC time.
8463
+ '''Specifies your task schedule by using a cron or rate expression.
8464
+
8465
+ Use cron expressions for task schedules that run on a specific time and day. For example, the following cron expression creates a task schedule that runs at 8 AM on the first Wednesday of every month:
8466
+
8467
+ ``cron(0 8 * * 3#1)``
8468
+
8469
+ Use rate expressions for task schedules that run on a regular interval. For example, the following rate expression creates a task schedule that runs every 12 hours:
8470
+
8471
+ ``rate(12 hours)``
8461
8472
 
8462
- For information about cron expression syntax, see the `*Amazon EventBridge User Guide* <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-cron-expressions.html>`_ .
8473
+ For information about cron and rate expression syntax, see the `*Amazon EventBridge User Guide* <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-scheduled-rule-pattern.html>`_ .
8463
8474
 
8464
8475
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-datasync-task-taskschedule.html#cfn-datasync-task-taskschedule-scheduleexpression
8465
8476
  '''
@@ -283,6 +283,26 @@ cluster = docdb.DatabaseCluster(self, "Database",
283
283
  ca_certificate=docdb.CaCertificate.RDS_CA_RSA4096_G1
284
284
  )
285
285
  ```
286
+
287
+ ## Storage Type
288
+
289
+ You can specify [storage type](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-storage-configs.html) for the cluster.
290
+
291
+ ```python
292
+ # vpc: ec2.Vpc
293
+
294
+
295
+ cluster = docdb.DatabaseCluster(self, "Database",
296
+ master_user=docdb.Login(
297
+ username="myuser"
298
+ ),
299
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.MEMORY5, ec2.InstanceSize.LARGE),
300
+ vpc=vpc,
301
+ storage_type=docdb.StorageType.IOPT1
302
+ )
303
+ ```
304
+
305
+ **Note**: `StorageType.IOPT1` is supported starting with engine version 5.0.0.
286
306
  '''
287
307
  from pkgutil import extend_path
288
308
  __path__ = extend_path(__path__, __name__)
@@ -3460,6 +3480,7 @@ class DatabaseClusterAttributes:
3460
3480
  "security_group": "securityGroup",
3461
3481
  "security_group_removal_policy": "securityGroupRemovalPolicy",
3462
3482
  "storage_encrypted": "storageEncrypted",
3483
+ "storage_type": "storageType",
3463
3484
  "vpc_subnets": "vpcSubnets",
3464
3485
  },
3465
3486
  )
@@ -3492,6 +3513,7 @@ class DatabaseClusterProps:
3492
3513
  security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
3493
3514
  security_group_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
3494
3515
  storage_encrypted: typing.Optional[builtins.bool] = None,
3516
+ storage_type: typing.Optional["StorageType"] = None,
3495
3517
  vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
3496
3518
  ) -> None:
3497
3519
  '''Properties for a new database cluster.
@@ -3507,7 +3529,7 @@ class DatabaseClusterProps:
3507
3529
  :param db_cluster_name: An optional identifier for the cluster. Default: - A name is automatically generated.
3508
3530
  :param deletion_protection: Specifies whether this cluster can be deleted. If deletionProtection is enabled, the cluster cannot be deleted unless it is modified and deletionProtection is disabled. deletionProtection protects clusters from being accidentally deleted. Default: - false
3509
3531
  :param enable_performance_insights: A value that indicates whether to enable Performance Insights for the instances in the DB Cluster. Default: - false
3510
- :param engine_version: What version of the database to start. Default: - The default engine version.
3532
+ :param engine_version: What version of the database to start. Default: - the latest major version
3511
3533
  :param export_audit_logs_to_cloud_watch: Whether the audit logs should be exported to CloudWatch. Note that you also have to configure the audit log export in the Cluster's Parameter Group. Default: false
3512
3534
  :param export_profiler_logs_to_cloud_watch: Whether the profiler logs should be exported to CloudWatch. Note that you also have to configure the profiler log export in the Cluster's Parameter Group. Default: false
3513
3535
  :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Default: - ``dbClusterName`` is used with the word "Instance" appended. If ``dbClusterName`` is not provided, the identifier is automatically generated.
@@ -3521,6 +3543,7 @@ class DatabaseClusterProps:
3521
3543
  :param security_group: Security group. Default: a new security group is created.
3522
3544
  :param security_group_removal_policy: The removal policy to apply to the cluster's security group. Cannot be set to ``SNAPSHOT``. Default: - ``RemovalPolicy.DESTROY`` when ``removalPolicy`` is set to ``SNAPSHOT``, ``removalPolicy`` otherwise.
3523
3545
  :param storage_encrypted: Whether to enable storage encryption. Default: true
3546
+ :param storage_type: The storage type of the DocDB cluster. I/O-optimized storage is supported starting with engine version 5.0.0. Default: StorageType.STANDARD
3524
3547
  :param vpc_subnets: Where to place the instances within the VPC. Default: private subnets
3525
3548
 
3526
3549
  :exampleMetadata: infused
@@ -3539,7 +3562,7 @@ class DatabaseClusterProps:
3539
3562
  subnet_type=ec2.SubnetType.PUBLIC
3540
3563
  ),
3541
3564
  vpc=vpc,
3542
- ca_certificate=docdb.CaCertificate.RDS_CA_RSA4096_G1
3565
+ removal_policy=RemovalPolicy.SNAPSHOT
3543
3566
  )
3544
3567
  '''
3545
3568
  if isinstance(master_user, dict):
@@ -3575,6 +3598,7 @@ class DatabaseClusterProps:
3575
3598
  check_type(argname="argument security_group", value=security_group, expected_type=type_hints["security_group"])
3576
3599
  check_type(argname="argument security_group_removal_policy", value=security_group_removal_policy, expected_type=type_hints["security_group_removal_policy"])
3577
3600
  check_type(argname="argument storage_encrypted", value=storage_encrypted, expected_type=type_hints["storage_encrypted"])
3601
+ check_type(argname="argument storage_type", value=storage_type, expected_type=type_hints["storage_type"])
3578
3602
  check_type(argname="argument vpc_subnets", value=vpc_subnets, expected_type=type_hints["vpc_subnets"])
3579
3603
  self._values: typing.Dict[builtins.str, typing.Any] = {
3580
3604
  "instance_type": instance_type,
@@ -3625,6 +3649,8 @@ class DatabaseClusterProps:
3625
3649
  self._values["security_group_removal_policy"] = security_group_removal_policy
3626
3650
  if storage_encrypted is not None:
3627
3651
  self._values["storage_encrypted"] = storage_encrypted
3652
+ if storage_type is not None:
3653
+ self._values["storage_type"] = storage_type
3628
3654
  if vpc_subnets is not None:
3629
3655
  self._values["vpc_subnets"] = vpc_subnets
3630
3656
 
@@ -3747,7 +3773,7 @@ class DatabaseClusterProps:
3747
3773
  def engine_version(self) -> typing.Optional[builtins.str]:
3748
3774
  '''What version of the database to start.
3749
3775
 
3750
- :default: - The default engine version.
3776
+ :default: - the latest major version
3751
3777
  '''
3752
3778
  result = self._values.get("engine_version")
3753
3779
  return typing.cast(typing.Optional[builtins.str], result)
@@ -3908,6 +3934,19 @@ class DatabaseClusterProps:
3908
3934
  result = self._values.get("storage_encrypted")
3909
3935
  return typing.cast(typing.Optional[builtins.bool], result)
3910
3936
 
3937
+ @builtins.property
3938
+ def storage_type(self) -> typing.Optional["StorageType"]:
3939
+ '''The storage type of the DocDB cluster.
3940
+
3941
+ I/O-optimized storage is supported starting with engine version 5.0.0.
3942
+
3943
+ :default: StorageType.STANDARD
3944
+
3945
+ :see: https://docs.aws.amazon.com/documentdb/latest/developerguide/release-notes.html#release-notes.11-21-2023
3946
+ '''
3947
+ result = self._values.get("storage_type")
3948
+ return typing.cast(typing.Optional["StorageType"], result)
3949
+
3911
3950
  @builtins.property
3912
3951
  def vpc_subnets(self) -> typing.Optional[_SubnetSelection_e57d76df]:
3913
3952
  '''Where to place the instances within the VPC.
@@ -4721,7 +4760,7 @@ class Login:
4721
4760
  subnet_type=ec2.SubnetType.PUBLIC
4722
4761
  ),
4723
4762
  vpc=vpc,
4724
- ca_certificate=docdb.CaCertificate.RDS_CA_RSA4096_G1
4763
+ removal_policy=RemovalPolicy.SNAPSHOT
4725
4764
  )
4726
4765
  '''
4727
4766
  if __debug__:
@@ -4884,6 +4923,33 @@ class RotationMultiUserOptions:
4884
4923
  )
4885
4924
 
4886
4925
 
4926
+ @jsii.enum(jsii_type="aws-cdk-lib.aws_docdb.StorageType")
4927
+ class StorageType(enum.Enum):
4928
+ '''The storage type of the DocDB cluster.
4929
+
4930
+ :exampleMetadata: infused
4931
+
4932
+ Example::
4933
+
4934
+ # vpc: ec2.Vpc
4935
+
4936
+
4937
+ cluster = docdb.DatabaseCluster(self, "Database",
4938
+ master_user=docdb.Login(
4939
+ username="myuser"
4940
+ ),
4941
+ instance_type=ec2.InstanceType.of(ec2.InstanceClass.MEMORY5, ec2.InstanceSize.LARGE),
4942
+ vpc=vpc,
4943
+ storage_type=docdb.StorageType.IOPT1
4944
+ )
4945
+ '''
4946
+
4947
+ STANDARD = "STANDARD"
4948
+ '''Standard storage.'''
4949
+ IOPT1 = "IOPT1"
4950
+ '''I/O-optimized storage.'''
4951
+
4952
+
4887
4953
  @jsii.implements(IClusterParameterGroup)
4888
4954
  class ClusterParameterGroup(
4889
4955
  _Resource_45bc6135,
@@ -4997,7 +5063,7 @@ class DatabaseCluster(
4997
5063
  subnet_type=ec2.SubnetType.PUBLIC
4998
5064
  ),
4999
5065
  vpc=vpc,
5000
- ca_certificate=docdb.CaCertificate.RDS_CA_RSA4096_G1
5066
+ removal_policy=RemovalPolicy.SNAPSHOT
5001
5067
  )
5002
5068
  '''
5003
5069
 
@@ -5031,6 +5097,7 @@ class DatabaseCluster(
5031
5097
  security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
5032
5098
  security_group_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
5033
5099
  storage_encrypted: typing.Optional[builtins.bool] = None,
5100
+ storage_type: typing.Optional[StorageType] = None,
5034
5101
  vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
5035
5102
  ) -> None:
5036
5103
  '''
@@ -5047,7 +5114,7 @@ class DatabaseCluster(
5047
5114
  :param db_cluster_name: An optional identifier for the cluster. Default: - A name is automatically generated.
5048
5115
  :param deletion_protection: Specifies whether this cluster can be deleted. If deletionProtection is enabled, the cluster cannot be deleted unless it is modified and deletionProtection is disabled. deletionProtection protects clusters from being accidentally deleted. Default: - false
5049
5116
  :param enable_performance_insights: A value that indicates whether to enable Performance Insights for the instances in the DB Cluster. Default: - false
5050
- :param engine_version: What version of the database to start. Default: - The default engine version.
5117
+ :param engine_version: What version of the database to start. Default: - the latest major version
5051
5118
  :param export_audit_logs_to_cloud_watch: Whether the audit logs should be exported to CloudWatch. Note that you also have to configure the audit log export in the Cluster's Parameter Group. Default: false
5052
5119
  :param export_profiler_logs_to_cloud_watch: Whether the profiler logs should be exported to CloudWatch. Note that you also have to configure the profiler log export in the Cluster's Parameter Group. Default: false
5053
5120
  :param instance_identifier_base: Base identifier for instances. Every replica is named by appending the replica number to this string, 1-based. Default: - ``dbClusterName`` is used with the word "Instance" appended. If ``dbClusterName`` is not provided, the identifier is automatically generated.
@@ -5061,6 +5128,7 @@ class DatabaseCluster(
5061
5128
  :param security_group: Security group. Default: a new security group is created.
5062
5129
  :param security_group_removal_policy: The removal policy to apply to the cluster's security group. Cannot be set to ``SNAPSHOT``. Default: - ``RemovalPolicy.DESTROY`` when ``removalPolicy`` is set to ``SNAPSHOT``, ``removalPolicy`` otherwise.
5063
5130
  :param storage_encrypted: Whether to enable storage encryption. Default: true
5131
+ :param storage_type: The storage type of the DocDB cluster. I/O-optimized storage is supported starting with engine version 5.0.0. Default: StorageType.STANDARD
5064
5132
  :param vpc_subnets: Where to place the instances within the VPC. Default: private subnets
5065
5133
  '''
5066
5134
  if __debug__:
@@ -5093,6 +5161,7 @@ class DatabaseCluster(
5093
5161
  security_group=security_group,
5094
5162
  security_group_removal_policy=security_group_removal_policy,
5095
5163
  storage_encrypted=storage_encrypted,
5164
+ storage_type=storage_type,
5096
5165
  vpc_subnets=vpc_subnets,
5097
5166
  )
5098
5167
 
@@ -5461,6 +5530,7 @@ __all__ = [
5461
5530
  "IDatabaseInstance",
5462
5531
  "Login",
5463
5532
  "RotationMultiUserOptions",
5533
+ "StorageType",
5464
5534
  ]
5465
5535
 
5466
5536
  publication.publish()
@@ -6051,6 +6121,7 @@ def _typecheckingstub__bb24ec128a97ca07df15f55d4e96dda851d4300951806a7a3d7f391cc
6051
6121
  security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
6052
6122
  security_group_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
6053
6123
  storage_encrypted: typing.Optional[builtins.bool] = None,
6124
+ storage_type: typing.Optional[StorageType] = None,
6054
6125
  vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
6055
6126
  ) -> None:
6056
6127
  """Type checking stubs"""
@@ -6179,6 +6250,7 @@ def _typecheckingstub__3fef762ebf4d69195051e79f76d91c6d9e93e2a84a6c1e71f7b4a0b8c
6179
6250
  security_group: typing.Optional[_ISecurityGroup_acf8a799] = None,
6180
6251
  security_group_removal_policy: typing.Optional[_RemovalPolicy_9f93c814] = None,
6181
6252
  storage_encrypted: typing.Optional[builtins.bool] = None,
6253
+ storage_type: typing.Optional[StorageType] = None,
6182
6254
  vpc_subnets: typing.Optional[typing.Union[_SubnetSelection_e57d76df, typing.Dict[builtins.str, typing.Any]]] = None,
6183
6255
  ) -> None:
6184
6256
  """Type checking stubs"""