aws-cdk-lib 2.137.0__py3-none-any.whl → 2.139.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 (73) hide show
  1. aws_cdk/__init__.py +8 -0
  2. aws_cdk/_jsii/__init__.py +1 -1
  3. aws_cdk/_jsii/{aws-cdk-lib@2.137.0.jsii.tgz → aws-cdk-lib@2.139.0.jsii.tgz} +0 -0
  4. aws_cdk/aws_amplify/__init__.py +29 -113
  5. aws_cdk/aws_apigateway/__init__.py +29 -16
  6. aws_cdk/aws_appconfig/__init__.py +315 -77
  7. aws_cdk/aws_appintegrations/__init__.py +55 -6
  8. aws_cdk/aws_apprunner/__init__.py +5 -2
  9. aws_cdk/aws_appsync/__init__.py +400 -13
  10. aws_cdk/aws_aps/__init__.py +64 -47
  11. aws_cdk/aws_autoscaling/__init__.py +62 -60
  12. aws_cdk/aws_b2bi/__init__.py +2 -6
  13. aws_cdk/aws_backup/__init__.py +53 -57
  14. aws_cdk/aws_batch/__init__.py +109 -0
  15. aws_cdk/aws_bcmdataexports/__init__.py +1114 -0
  16. aws_cdk/aws_bedrock/__init__.py +4144 -0
  17. aws_cdk/aws_chatbot/__init__.py +6 -4
  18. aws_cdk/aws_cleanrooms/__init__.py +526 -3
  19. aws_cdk/aws_cleanroomsml/__init__.py +960 -0
  20. aws_cdk/aws_cloudtrail/__init__.py +10 -10
  21. aws_cdk/aws_cloudwatch/__init__.py +244 -8
  22. aws_cdk/aws_codebuild/__init__.py +27 -22
  23. aws_cdk/aws_codeconnections/__init__.py +435 -0
  24. aws_cdk/aws_cognito/__init__.py +175 -79
  25. aws_cdk/aws_datazone/__init__.py +22 -0
  26. aws_cdk/aws_deadline/__init__.py +5394 -0
  27. aws_cdk/aws_dms/__init__.py +2 -4
  28. aws_cdk/aws_ec2/__init__.py +402 -247
  29. aws_cdk/aws_ecr/__init__.py +630 -0
  30. aws_cdk/aws_ecs/__init__.py +361 -20
  31. aws_cdk/aws_efs/__init__.py +594 -2
  32. aws_cdk/aws_elasticache/__init__.py +86 -32
  33. aws_cdk/aws_elasticloadbalancingv2/__init__.py +75 -10
  34. aws_cdk/aws_emr/__init__.py +2 -2
  35. aws_cdk/aws_entityresolution/__init__.py +1982 -773
  36. aws_cdk/aws_events_targets/__init__.py +17 -4
  37. aws_cdk/aws_globalaccelerator/__init__.py +443 -0
  38. aws_cdk/aws_iam/__init__.py +1 -2
  39. aws_cdk/aws_internetmonitor/__init__.py +14 -6
  40. aws_cdk/aws_ivs/__init__.py +1273 -71
  41. aws_cdk/aws_kms/__init__.py +44 -0
  42. aws_cdk/aws_lambda/__init__.py +9 -0
  43. aws_cdk/aws_mediatailor/__init__.py +41 -0
  44. aws_cdk/aws_oam/__init__.py +204 -0
  45. aws_cdk/aws_personalize/__init__.py +8 -6
  46. aws_cdk/aws_pinpoint/__init__.py +5 -3
  47. aws_cdk/aws_pipes/__init__.py +5 -1
  48. aws_cdk/aws_quicksight/__init__.py +12 -6
  49. aws_cdk/aws_rds/__init__.py +370 -96
  50. aws_cdk/aws_redshiftserverless/__init__.py +157 -0
  51. aws_cdk/aws_route53/__init__.py +587 -14
  52. aws_cdk/aws_sagemaker/__init__.py +233 -2
  53. aws_cdk/aws_securityhub/__init__.py +4940 -102
  54. aws_cdk/aws_securitylake/__init__.py +1326 -89
  55. aws_cdk/aws_ses_actions/__init__.py +155 -0
  56. aws_cdk/aws_sns/__init__.py +61 -4
  57. aws_cdk/aws_ssm/__init__.py +5 -2
  58. aws_cdk/aws_ssmcontacts/__init__.py +11 -4
  59. aws_cdk/aws_stepfunctions/__init__.py +8 -16
  60. aws_cdk/aws_stepfunctions_tasks/__init__.py +676 -1
  61. aws_cdk/aws_timestream/__init__.py +1045 -0
  62. aws_cdk/aws_transfer/__init__.py +19 -10
  63. aws_cdk/aws_verifiedpermissions/__init__.py +114 -37
  64. aws_cdk/aws_wisdom/__init__.py +2 -2
  65. aws_cdk/aws_workspacesthinclient/__init__.py +8 -8
  66. aws_cdk/custom_resources/__init__.py +688 -26
  67. aws_cdk/cx_api/__init__.py +17 -0
  68. {aws_cdk_lib-2.137.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/METADATA +3 -3
  69. {aws_cdk_lib-2.137.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/RECORD +73 -69
  70. {aws_cdk_lib-2.137.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/LICENSE +0 -0
  71. {aws_cdk_lib-2.137.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/NOTICE +0 -0
  72. {aws_cdk_lib-2.137.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/WHEEL +0 -0
  73. {aws_cdk_lib-2.137.0.dist-info → aws_cdk_lib-2.139.0.dist-info}/top_level.txt +0 -0
@@ -657,7 +657,7 @@ class CfnCapability(
657
657
  ) -> None:
658
658
  '''
659
659
  :param transaction_set: Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.
660
- :param version: Returns the version to use for the specified X12 transaction set. Supported versions are ``4010`` , ``4030`` , and ``5010`` .
660
+ :param version: Returns the version to use for the specified X12 transaction set.
661
661
 
662
662
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-capability-x12details.html
663
663
  :exampleMetadata: fixture=_generated
@@ -698,8 +698,6 @@ class CfnCapability(
698
698
  def version(self) -> typing.Optional[builtins.str]:
699
699
  '''Returns the version to use for the specified X12 transaction set.
700
700
 
701
- Supported versions are ``4010`` , ``4030`` , and ``5010`` .
702
-
703
701
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-capability-x12details.html#cfn-b2bi-capability-x12details-version
704
702
  '''
705
703
  result = self._values.get("version")
@@ -1974,7 +1972,7 @@ class CfnTransformer(
1974
1972
  If an EDI input file contains more than one transaction, each transaction must have the same transaction set and version, for example 214/4010. If not, the transformer cannot parse the file.
1975
1973
 
1976
1974
  :param transaction_set: Returns an enumerated type where each value identifies an X12 transaction set. Transaction sets are maintained by the X12 Accredited Standards Committee.
1977
- :param version: Returns the version to use for the specified X12 transaction set. Supported versions are ``4010`` , ``4030`` , and ``5010`` .
1975
+ :param version: Returns the version to use for the specified X12 transaction set.
1978
1976
 
1979
1977
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-transformer-x12details.html
1980
1978
  :exampleMetadata: fixture=_generated
@@ -2015,8 +2013,6 @@ class CfnTransformer(
2015
2013
  def version(self) -> typing.Optional[builtins.str]:
2016
2014
  '''Returns the version to use for the specified X12 transaction set.
2017
2015
 
2018
- Supported versions are ``4010`` , ``4030`` , and ``5010`` .
2019
-
2020
2016
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-transformer-x12details.html#cfn-b2bi-transformer-x12details-version
2021
2017
  '''
2022
2018
  result = self._values.get("version")
@@ -1781,7 +1781,7 @@ class CfnBackupPlan(
1781
1781
  :param scope: Scope in which this resource is defined.
1782
1782
  :param id: Construct identifier for this resource (unique in its scope).
1783
1783
  :param backup_plan: Uniquely identifies the backup plan to be associated with the selection of resources.
1784
- :param backup_plan_tags: To help organize your resources, you can assign your own metadata to the resources that you create. Each tag is a key-value pair. The specified tags are assigned to all backups created with this plan.
1784
+ :param backup_plan_tags: The tags to assign to the backup plan.
1785
1785
  '''
1786
1786
  if __debug__:
1787
1787
  type_hints = typing.get_type_hints(_typecheckingstub__8250888ac08b345ef300cc4ce53cc267858e31401cdc7b6a427c98f5b05a644a)
@@ -1888,7 +1888,7 @@ class CfnBackupPlan(
1888
1888
  def backup_plan_tags(
1889
1889
  self,
1890
1890
  ) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
1891
- '''To help organize your resources, you can assign your own metadata to the resources that you create.'''
1891
+ '''The tags to assign to the backup plan.'''
1892
1892
  return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "backupPlanTags"))
1893
1893
 
1894
1894
  @backup_plan_tags.setter
@@ -2161,7 +2161,7 @@ class CfnBackupPlan(
2161
2161
  :param copy_actions: An array of CopyAction objects, which contains the details of the copy operation.
2162
2162
  :param enable_continuous_backup: Enables continuous backup and point-in-time restores (PITR).
2163
2163
  :param lifecycle: The lifecycle defines when a protected resource is transitioned to cold storage and when it expires. AWS Backup transitions and expires backups automatically according to the lifecycle that you define.
2164
- :param recovery_point_tags: To help organize your resources, you can assign your own metadata to the resources that you create. Each tag is a key-value pair.
2164
+ :param recovery_point_tags: The tags to assign to the resources.
2165
2165
  :param schedule_expression: A CRON expression specifying when AWS Backup initiates a backup job.
2166
2166
  :param schedule_expression_timezone: This is the timezone in which the schedule expression is set. By default, ScheduleExpressions are in UTC. You can modify this to a specified timezone.
2167
2167
  :param start_window_minutes: An optional value that specifies a period of time in minutes after a backup is scheduled before a job is canceled if it doesn't start successfully. If this value is included, it must be at least 60 minutes to avoid errors.
@@ -2308,9 +2308,7 @@ class CfnBackupPlan(
2308
2308
  def recovery_point_tags(
2309
2309
  self,
2310
2310
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, builtins.str]]]:
2311
- '''To help organize your resources, you can assign your own metadata to the resources that you create.
2312
-
2313
- Each tag is a key-value pair.
2311
+ '''The tags to assign to the resources.
2314
2312
 
2315
2313
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-backupplan-backupruleresourcetype.html#cfn-backup-backupplan-backupruleresourcetype-recoverypointtags
2316
2314
  '''
@@ -2468,7 +2466,7 @@ class CfnBackupPlan(
2468
2466
 
2469
2467
  :param delete_after_days: Specifies the number of days after creation that a recovery point is deleted. Must be greater than ``MoveToColdStorageAfterDays`` .
2470
2468
  :param move_to_cold_storage_after_days: Specifies the number of days after creation that a recovery point is moved to cold storage.
2471
- :param opt_in_to_archive_for_supported_resources: Optional Boolean. If this is true, this setting will instruct your backup plan to transition supported resources to archive (cold) storage tier in accordance with your lifecycle settings.
2469
+ :param opt_in_to_archive_for_supported_resources: If the value is true, your backup plan transitions supported resources to archive (cold) storage tier in accordance with your lifecycle settings.
2472
2470
 
2473
2471
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-backupplan-lifecycleresourcetype.html
2474
2472
  :exampleMetadata: fixture=_generated
@@ -2522,9 +2520,7 @@ class CfnBackupPlan(
2522
2520
  def opt_in_to_archive_for_supported_resources(
2523
2521
  self,
2524
2522
  ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
2525
- '''Optional Boolean.
2526
-
2527
- If this is true, this setting will instruct your backup plan to transition supported resources to archive (cold) storage tier in accordance with your lifecycle settings.
2523
+ '''If the value is true, your backup plan transitions supported resources to archive (cold) storage tier in accordance with your lifecycle settings.
2528
2524
 
2529
2525
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-backupplan-lifecycleresourcetype.html#cfn-backup-backupplan-lifecycleresourcetype-optintoarchiveforsupportedresources
2530
2526
  '''
@@ -2558,7 +2554,7 @@ class CfnBackupPlanProps:
2558
2554
  '''Properties for defining a ``CfnBackupPlan``.
2559
2555
 
2560
2556
  :param backup_plan: Uniquely identifies the backup plan to be associated with the selection of resources.
2561
- :param backup_plan_tags: To help organize your resources, you can assign your own metadata to the resources that you create. Each tag is a key-value pair. The specified tags are assigned to all backups created with this plan.
2557
+ :param backup_plan_tags: The tags to assign to the backup plan.
2562
2558
 
2563
2559
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-backupplan.html
2564
2560
  :exampleMetadata: fixture=_generated
@@ -2643,9 +2639,7 @@ class CfnBackupPlanProps:
2643
2639
  def backup_plan_tags(
2644
2640
  self,
2645
2641
  ) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
2646
- '''To help organize your resources, you can assign your own metadata to the resources that you create.
2647
-
2648
- Each tag is a key-value pair. The specified tags are assigned to all backups created with this plan.
2642
+ '''The tags to assign to the backup plan.
2649
2643
 
2650
2644
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-backupplan.html#cfn-backup-backupplan-backupplantags
2651
2645
  '''
@@ -3007,6 +3001,8 @@ class CfnBackupSelection(
3007
3001
  ) -> None:
3008
3002
  '''Includes information about tags you define to assign tagged resources to a backup plan.
3009
3003
 
3004
+ Include the prefix ``aws:ResourceTag`` in your tags. For example, ``"aws:ResourceTag/TagKey1": "Value1"`` .
3005
+
3010
3006
  :param condition_key: The key in a key-value pair. For example, in the tag ``Department: Accounting`` , ``Department`` is the key.
3011
3007
  :param condition_value: The value in a key-value pair. For example, in the tag ``Department: Accounting`` , ``Accounting`` is the value.
3012
3008
 
@@ -3457,7 +3453,7 @@ class CfnBackupVault(
3457
3453
  :param id: Construct identifier for this resource (unique in its scope).
3458
3454
  :param backup_vault_name: The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the AWS Region where they are created. They consist of lowercase letters, numbers, and hyphens.
3459
3455
  :param access_policy: A resource-based policy that is used to manage access permissions on the target backup vault.
3460
- :param backup_vault_tags: Metadata that you can assign to help organize the resources that you create. Each tag is a key-value pair.
3456
+ :param backup_vault_tags: The tags to assign to the backup vault.
3461
3457
  :param encryption_key_arn: A server-side encryption key you can specify to encrypt your backups from services that support full AWS Backup management; for example, ``arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`` . If you specify a key, you must specify its ARN, not its alias. If you do not specify a key, AWS Backup creates a KMS key for you by default. To learn which AWS Backup services support full AWS Backup management and how AWS Backup handles encryption for backups from services that do not yet support full AWS Backup , see `Encryption for backups in AWS Backup <https://docs.aws.amazon.com/aws-backup/latest/devguide/encryption.html>`_
3462
3458
  :param lock_configuration: Configuration for `AWS Backup Vault Lock <https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html>`_ .
3463
3459
  :param notifications: The SNS event notifications for the specified backup vault.
@@ -3571,7 +3567,7 @@ class CfnBackupVault(
3571
3567
  def backup_vault_tags(
3572
3568
  self,
3573
3569
  ) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
3574
- '''Metadata that you can assign to help organize the resources that you create.'''
3570
+ '''The tags to assign to the backup vault.'''
3575
3571
  return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "backupVaultTags"))
3576
3572
 
3577
3573
  @backup_vault_tags.setter
@@ -3851,7 +3847,7 @@ class CfnBackupVaultProps:
3851
3847
 
3852
3848
  :param backup_vault_name: The name of a logical container where backups are stored. Backup vaults are identified by names that are unique to the account used to create them and the AWS Region where they are created. They consist of lowercase letters, numbers, and hyphens.
3853
3849
  :param access_policy: A resource-based policy that is used to manage access permissions on the target backup vault.
3854
- :param backup_vault_tags: Metadata that you can assign to help organize the resources that you create. Each tag is a key-value pair.
3850
+ :param backup_vault_tags: The tags to assign to the backup vault.
3855
3851
  :param encryption_key_arn: A server-side encryption key you can specify to encrypt your backups from services that support full AWS Backup management; for example, ``arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`` . If you specify a key, you must specify its ARN, not its alias. If you do not specify a key, AWS Backup creates a KMS key for you by default. To learn which AWS Backup services support full AWS Backup management and how AWS Backup handles encryption for backups from services that do not yet support full AWS Backup , see `Encryption for backups in AWS Backup <https://docs.aws.amazon.com/aws-backup/latest/devguide/encryption.html>`_
3856
3852
  :param lock_configuration: Configuration for `AWS Backup Vault Lock <https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html>`_ .
3857
3853
  :param notifications: The SNS event notifications for the specified backup vault.
@@ -3936,9 +3932,7 @@ class CfnBackupVaultProps:
3936
3932
  def backup_vault_tags(
3937
3933
  self,
3938
3934
  ) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
3939
- '''Metadata that you can assign to help organize the resources that you create.
3940
-
3941
- Each tag is a key-value pair.
3935
+ '''The tags to assign to the backup vault.
3942
3936
 
3943
3937
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-backupvault.html#cfn-backup-backupvault-backupvaulttags
3944
3938
  '''
@@ -4054,7 +4048,7 @@ class CfnFramework(
4054
4048
  :param framework_controls: Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
4055
4049
  :param framework_description: An optional description of the framework with a maximum 1,024 characters.
4056
4050
  :param framework_name: The unique name of a framework. This name is between 1 and 256 characters, starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
4057
- :param framework_tags: A list of tags with which to tag your framework.
4051
+ :param framework_tags: The tags to assign to your framework.
4058
4052
  '''
4059
4053
  if __debug__:
4060
4054
  type_hints = typing.get_type_hints(_typecheckingstub__762b6f2cf173ed987e2f05e55b691e4e8e14552591e05b26b7f7f4e08e3c739d)
@@ -4197,7 +4191,7 @@ class CfnFramework(
4197
4191
  @builtins.property
4198
4192
  @jsii.member(jsii_name="frameworkTags")
4199
4193
  def framework_tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
4200
- '''A list of tags with which to tag your framework.'''
4194
+ '''The tags to assign to your framework.'''
4201
4195
  return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "frameworkTags"))
4202
4196
 
4203
4197
  @framework_tags.setter
@@ -4225,7 +4219,7 @@ class CfnFramework(
4225
4219
  parameter_name: builtins.str,
4226
4220
  parameter_value: builtins.str,
4227
4221
  ) -> None:
4228
- '''A list of parameters for a control.
4222
+ '''The parameters for a control.
4229
4223
 
4230
4224
  A control can have zero, one, or more than one parameter. An example of a control with two parameters is: "backup plan frequency is at least ``daily`` and the retention period is at least ``1 year`` ". The first parameter is ``daily`` . The second parameter is ``1 year`` .
4231
4225
 
@@ -4411,7 +4405,7 @@ class CfnFramework(
4411
4405
  Each framework must contain at least one control.
4412
4406
 
4413
4407
  :param control_name: The name of a control. This name is between 1 and 256 characters.
4414
- :param control_input_parameters: A list of ``ParameterName`` and ``ParameterValue`` pairs.
4408
+ :param control_input_parameters: The name/value pairs.
4415
4409
  :param control_scope: The scope of a control. The control scope defines what the control will evaluate. Three examples of control scopes are: a specific backup plan, all backup plans with a specific tag, or all backup plans. For more information, see ```ControlScope`` . <https://docs.aws.amazon.com/aws-backup/latest/devguide/API_ControlScope.html>`_
4416
4410
 
4417
4411
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-framework-frameworkcontrol.html
@@ -4465,7 +4459,7 @@ class CfnFramework(
4465
4459
  def control_input_parameters(
4466
4460
  self,
4467
4461
  ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnFramework.ControlInputParameterProperty"]]]]:
4468
- '''A list of ``ParameterName`` and ``ParameterValue`` pairs.
4462
+ '''The name/value pairs.
4469
4463
 
4470
4464
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-framework-frameworkcontrol.html#cfn-backup-framework-frameworkcontrol-controlinputparameters
4471
4465
  '''
@@ -4521,7 +4515,7 @@ class CfnFrameworkProps:
4521
4515
  :param framework_controls: Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
4522
4516
  :param framework_description: An optional description of the framework with a maximum 1,024 characters.
4523
4517
  :param framework_name: The unique name of a framework. This name is between 1 and 256 characters, starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
4524
- :param framework_tags: A list of tags with which to tag your framework.
4518
+ :param framework_tags: The tags to assign to your framework.
4525
4519
 
4526
4520
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-framework.html
4527
4521
  :exampleMetadata: fixture=_generated
@@ -4607,7 +4601,7 @@ class CfnFrameworkProps:
4607
4601
 
4608
4602
  @builtins.property
4609
4603
  def framework_tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
4610
- '''A list of tags with which to tag your framework.
4604
+ '''The tags to assign to your framework.
4611
4605
 
4612
4606
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-framework.html#cfn-backup-framework-frameworktags
4613
4607
  '''
@@ -4685,7 +4679,7 @@ class CfnReportPlan(
4685
4679
  :param report_setting: Identifies the report template for the report. Reports are built using a report template. The report templates are:. ``RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`` If the report template is ``RESOURCE_COMPLIANCE_REPORT`` or ``CONTROL_COMPLIANCE_REPORT`` , this API resource also describes the report coverage by AWS Regions and frameworks.
4686
4680
  :param report_plan_description: An optional description of the report plan with a maximum 1,024 characters.
4687
4681
  :param report_plan_name: The unique name of the report plan. This name is between 1 and 256 characters starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
4688
- :param report_plan_tags: A list of tags to tag your report plan.
4682
+ :param report_plan_tags: The tags to assign to your report plan.
4689
4683
  '''
4690
4684
  if __debug__:
4691
4685
  type_hints = typing.get_type_hints(_typecheckingstub__5c6528de906751786b24f01244334abf14ddb763be763a416a6d4f3c8b779828)
@@ -4809,7 +4803,7 @@ class CfnReportPlan(
4809
4803
  @builtins.property
4810
4804
  @jsii.member(jsii_name="reportPlanTags")
4811
4805
  def report_plan_tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
4812
- '''A list of tags to tag your report plan.'''
4806
+ '''The tags to assign to your report plan.'''
4813
4807
  return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "reportPlanTags"))
4814
4808
 
4815
4809
  @report_plan_tags.setter
@@ -4842,7 +4836,7 @@ class CfnReportPlan(
4842
4836
  '''Contains information from your report plan about where to deliver your reports, specifically your Amazon S3 bucket name, S3 key prefix, and the formats of your reports.
4843
4837
 
4844
4838
  :param s3_bucket_name: The unique name of the S3 bucket that receives your reports.
4845
- :param formats: A list of the format of your reports: ``CSV`` , ``JSON`` , or both. If not specified, the default format is ``CSV`` .
4839
+ :param formats: The format of your reports: ``CSV`` , ``JSON`` , or both. If not specified, the default format is ``CSV`` .
4846
4840
  :param s3_key_prefix: The prefix for where AWS Backup Audit Manager delivers your reports to Amazon S3. The prefix is this part of the following path: s3://your-bucket-name/ ``prefix`` /Backup/us-west-2/year/month/day/report-name. If not specified, there is no prefix.
4847
4841
 
4848
4842
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-reportplan-reportdeliverychannel.html
@@ -4887,7 +4881,7 @@ class CfnReportPlan(
4887
4881
 
4888
4882
  @builtins.property
4889
4883
  def formats(self) -> typing.Optional[typing.List[builtins.str]]:
4890
- '''A list of the format of your reports: ``CSV`` , ``JSON`` , or both.
4884
+ '''The format of your reports: ``CSV`` , ``JSON`` , or both.
4891
4885
 
4892
4886
  If not specified, the default format is ``CSV`` .
4893
4887
 
@@ -5076,7 +5070,7 @@ class CfnReportPlanProps:
5076
5070
  :param report_setting: Identifies the report template for the report. Reports are built using a report template. The report templates are:. ``RESOURCE_COMPLIANCE_REPORT | CONTROL_COMPLIANCE_REPORT | BACKUP_JOB_REPORT | COPY_JOB_REPORT | RESTORE_JOB_REPORT`` If the report template is ``RESOURCE_COMPLIANCE_REPORT`` or ``CONTROL_COMPLIANCE_REPORT`` , this API resource also describes the report coverage by AWS Regions and frameworks.
5077
5071
  :param report_plan_description: An optional description of the report plan with a maximum 1,024 characters.
5078
5072
  :param report_plan_name: The unique name of the report plan. This name is between 1 and 256 characters starting with a letter, and consisting of letters (a-z, A-Z), numbers (0-9), and underscores (_).
5079
- :param report_plan_tags: A list of tags to tag your report plan.
5073
+ :param report_plan_tags: The tags to assign to your report plan.
5080
5074
 
5081
5075
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-reportplan.html
5082
5076
  :exampleMetadata: fixture=_generated
@@ -5167,7 +5161,7 @@ class CfnReportPlanProps:
5167
5161
 
5168
5162
  @builtins.property
5169
5163
  def report_plan_tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
5170
- '''A list of tags to tag your report plan.
5164
+ '''The tags to assign to your report plan.
5171
5165
 
5172
5166
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-reportplan.html#cfn-backup-reportplan-reportplantags
5173
5167
  '''
@@ -5192,11 +5186,9 @@ class CfnRestoreTestingPlan(
5192
5186
  metaclass=jsii.JSIIMeta,
5193
5187
  jsii_type="aws-cdk-lib.aws_backup.CfnRestoreTestingPlan",
5194
5188
  ):
5195
- '''This is the first of two steps to create a restore testing plan;
5189
+ '''Creates a restore testing plan.
5196
5190
 
5197
- once this request is successful, finish the procedure with request CreateRestoreTestingSelection.
5198
-
5199
- You must include the parameter RestoreTestingPlan. You may optionally include CreatorRequestId and Tags.
5191
+ The first of two steps to create a restore testing plan. After this request is successful, finish the procedure using CreateRestoreTestingSelection.
5200
5192
 
5201
5193
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-restoretestingplan.html
5202
5194
  :cloudformationResource: AWS::Backup::RestoreTestingPlan
@@ -5425,13 +5417,23 @@ class CfnRestoreTestingPlan(
5425
5417
  exclude_vaults: typing.Optional[typing.Sequence[builtins.str]] = None,
5426
5418
  selection_window_days: typing.Optional[jsii.Number] = None,
5427
5419
  ) -> None:
5428
- '''Required: Algorithm;
5420
+ '''``RecoveryPointSelection`` has five parameters (three required and two optional).
5421
+
5422
+ The values you specify determine which recovery point is included in the restore test. You must indicate with ``Algorithm`` if you want the latest recovery point within your ``SelectionWindowDays`` or if you want a random recovery point, and you must indicate through ``IncludeVaults`` from which vaults the recovery points can be chosen.
5429
5423
 
5430
- Required: Recovery point types; IncludeVaults(one or more). Optional: SelectionWindowDays ('30' if not specified);ExcludeVaults (list of selectors), defaults to empty list if not listed.
5424
+ ``Algorithm`` ( *required* ) Valid values: " ``LATEST_WITHIN_WINDOW`` " or " ``RANDOM_WITHIN_WINDOW`` ".
5425
+
5426
+ ``Recovery point types`` ( *required* ) Valid values: " ``SNAPSHOT`` " and/or " ``CONTINUOUS`` ". Include ``SNAPSHOT`` to restore only snapshot recovery points; include ``CONTINUOUS`` to restore continuous recovery points (point in time restore / PITR); use both to restore either a snapshot or a continuous recovery point. The recovery point will be determined by the value for ``Algorithm`` .
5427
+
5428
+ ``IncludeVaults`` ( *required* ). You must include one or more backup vaults. Use the wildcard ["*"] or specific ARNs.
5429
+
5430
+ ``SelectionWindowDays`` ( *optional* ) Value must be an integer (in days) from 1 to 365. If not included, the value defaults to ``30`` .
5431
+
5432
+ ``ExcludeVaults`` ( *optional* ). You can choose to input one or more specific backup vault ARNs to exclude those vaults' contents from restore eligibility. Or, you can include a list of selectors. If this parameter and its value are not included, it defaults to empty list.
5431
5433
 
5432
5434
  :param algorithm: Acceptable values include "LATEST_WITHIN_WINDOW" or "RANDOM_WITHIN_WINDOW".
5433
5435
  :param include_vaults: Accepted values include wildcard ["*"] or by specific ARNs or ARN wilcard replacement ["arn:aws:backup:us-west-2:123456789012:backup-vault:asdf", ...] ["arn:aws:backup:*:*:backup-vault:asdf-*", ...].
5434
- :param recovery_point_types: These are the types of recovery points.
5436
+ :param recovery_point_types: These are the types of recovery points. Include ``SNAPSHOT`` to restore only snapshot recovery points; include ``CONTINUOUS`` to restore continuous recovery points (point in time restore / PITR); use both to restore either a snapshot or a continuous recovery point. The recovery point will be determined by the value for ``Algorithm`` .
5435
5437
  :param exclude_vaults: Accepted values include specific ARNs or list of selectors. Defaults to empty list if not listed.
5436
5438
  :param selection_window_days: Accepted values are integers from 1 to 365.
5437
5439
 
@@ -5495,6 +5497,8 @@ class CfnRestoreTestingPlan(
5495
5497
  def recovery_point_types(self) -> typing.List[builtins.str]:
5496
5498
  '''These are the types of recovery points.
5497
5499
 
5500
+ Include ``SNAPSHOT`` to restore only snapshot recovery points; include ``CONTINUOUS`` to restore continuous recovery points (point in time restore / PITR); use both to restore either a snapshot or a continuous recovery point. The recovery point will be determined by the value for ``Algorithm`` .
5501
+
5498
5502
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-restoretestingplan-restoretestingrecoverypointselection.html#cfn-backup-restoretestingplan-restoretestingrecoverypointselection-recoverypointtypes
5499
5503
  '''
5500
5504
  result = self._values.get("recovery_point_types")
@@ -5771,7 +5775,7 @@ class CfnRestoreTestingSelection(
5771
5775
  :param iam_role_arn: The Amazon Resource Name (ARN) of the IAM role that AWS Backup uses to create the target resource; for example: ``arn:aws:iam::123456789012:role/S3Access`` .
5772
5776
  :param protected_resource_type: The type of AWS resource included in a resource testing selection; for example, an Amazon EBS volume or an Amazon RDS database.
5773
5777
  :param restore_testing_plan_name: Unique string that is the name of the restore testing plan. The name cannot be changed after creation. The name must consist of only alphanumeric characters and underscores. Maximum length is 50.
5774
- :param restore_testing_selection_name: This is the unique name of the restore testing selection that belongs to the related restore testing plan.
5778
+ :param restore_testing_selection_name: The unique name of the restore testing selection that belongs to the related restore testing plan.
5775
5779
  :param protected_resource_arns: You can include specific ARNs, such as ``ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."]`` or you can include a wildcard: ``ProtectedResourceArns: ["*"]`` , but not both.
5776
5780
  :param protected_resource_conditions: In a resource testing selection, this parameter filters by specific conditions such as ``StringEquals`` or ``StringNotEquals`` .
5777
5781
  :param restore_metadata_overrides: You can override certain restore metadata keys by including the parameter ``RestoreMetadataOverrides`` in the body of ``RestoreTestingSelection`` . Key values are not case sensitive. See the complete list of `restore testing inferred metadata <https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing-inferred-metadata.html>`_ .
@@ -5871,7 +5875,7 @@ class CfnRestoreTestingSelection(
5871
5875
  @builtins.property
5872
5876
  @jsii.member(jsii_name="restoreTestingSelectionName")
5873
5877
  def restore_testing_selection_name(self) -> builtins.str:
5874
- '''This is the unique name of the restore testing selection that belongs to the related restore testing plan.'''
5878
+ '''The unique name of the restore testing selection that belongs to the related restore testing plan.'''
5875
5879
  return typing.cast(builtins.str, jsii.get(self, "restoreTestingSelectionName"))
5876
5880
 
5877
5881
  @restore_testing_selection_name.setter
@@ -5957,8 +5961,8 @@ class CfnRestoreTestingSelection(
5957
5961
 
5958
5962
  Allowed characters are letters, white space, and numbers that can be represented in UTF-8 and the following characters: ``+ - = . _ : /``
5959
5963
 
5960
- :param key: The tag key (String). The key can't start with ``aws:`` . Length Constraints: Minimum length of 1. Maximum length of 128. Pattern: ``^(?![aA]{1}[wW]{1}[sS]{1}:)([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]+)$``
5961
- :param value: The value of the key. Length Constraints: Maximum length of 256. Pattern: ``^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$``
5964
+ :param key: The tag key.
5965
+ :param value: The tag value.
5962
5966
 
5963
5967
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-restoretestingselection-keyvalue.html
5964
5968
  :exampleMetadata: fixture=_generated
@@ -5985,11 +5989,7 @@ class CfnRestoreTestingSelection(
5985
5989
 
5986
5990
  @builtins.property
5987
5991
  def key(self) -> builtins.str:
5988
- '''The tag key (String). The key can't start with ``aws:`` .
5989
-
5990
- Length Constraints: Minimum length of 1. Maximum length of 128.
5991
-
5992
- Pattern: ``^(?![aA]{1}[wW]{1}[sS]{1}:)([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]+)$``
5992
+ '''The tag key.
5993
5993
 
5994
5994
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-restoretestingselection-keyvalue.html#cfn-backup-restoretestingselection-keyvalue-key
5995
5995
  '''
@@ -5999,11 +5999,7 @@ class CfnRestoreTestingSelection(
5999
5999
 
6000
6000
  @builtins.property
6001
6001
  def value(self) -> builtins.str:
6002
- '''The value of the key.
6003
-
6004
- Length Constraints: Maximum length of 256.
6005
-
6006
- Pattern: ``^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$``
6002
+ '''The tag value.
6007
6003
 
6008
6004
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-restoretestingselection-keyvalue.html#cfn-backup-restoretestingselection-keyvalue-value
6009
6005
  '''
@@ -6037,7 +6033,7 @@ class CfnRestoreTestingSelection(
6037
6033
  string_equals: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnRestoreTestingSelection.KeyValueProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
6038
6034
  string_not_equals: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnRestoreTestingSelection.KeyValueProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
6039
6035
  ) -> None:
6040
- '''A list of conditions that you define for resources in your restore testing plan using tags.
6036
+ '''The conditions that you define for resources in your restore testing plan using tags.
6041
6037
 
6042
6038
  For example, ``"StringEquals": { "Key": "aws:ResourceTag/CreatedByCryo", "Value": "true" },`` . Condition operators are case sensitive.
6043
6039
 
@@ -6144,7 +6140,7 @@ class CfnRestoreTestingSelectionProps:
6144
6140
  :param iam_role_arn: The Amazon Resource Name (ARN) of the IAM role that AWS Backup uses to create the target resource; for example: ``arn:aws:iam::123456789012:role/S3Access`` .
6145
6141
  :param protected_resource_type: The type of AWS resource included in a resource testing selection; for example, an Amazon EBS volume or an Amazon RDS database.
6146
6142
  :param restore_testing_plan_name: Unique string that is the name of the restore testing plan. The name cannot be changed after creation. The name must consist of only alphanumeric characters and underscores. Maximum length is 50.
6147
- :param restore_testing_selection_name: This is the unique name of the restore testing selection that belongs to the related restore testing plan.
6143
+ :param restore_testing_selection_name: The unique name of the restore testing selection that belongs to the related restore testing plan.
6148
6144
  :param protected_resource_arns: You can include specific ARNs, such as ``ProtectedResourceArns: ["arn:aws:...", "arn:aws:..."]`` or you can include a wildcard: ``ProtectedResourceArns: ["*"]`` , but not both.
6149
6145
  :param protected_resource_conditions: In a resource testing selection, this parameter filters by specific conditions such as ``StringEquals`` or ``StringNotEquals`` .
6150
6146
  :param restore_metadata_overrides: You can override certain restore metadata keys by including the parameter ``RestoreMetadataOverrides`` in the body of ``RestoreTestingSelection`` . Key values are not case sensitive. See the complete list of `restore testing inferred metadata <https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing-inferred-metadata.html>`_ .
@@ -6246,7 +6242,7 @@ class CfnRestoreTestingSelectionProps:
6246
6242
 
6247
6243
  @builtins.property
6248
6244
  def restore_testing_selection_name(self) -> builtins.str:
6249
- '''This is the unique name of the restore testing selection that belongs to the related restore testing plan.
6245
+ '''The unique name of the restore testing selection that belongs to the related restore testing plan.
6250
6246
 
6251
6247
  :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-restoretestingselection.html#cfn-backup-restoretestingselection-restoretestingselectionname
6252
6248
  '''