aws-cdk-lib 2.136.1__py3-none-any.whl → 2.138.0__py3-none-any.whl

aws_cdk/aws_aps/__init__.py

@@ -103,7 +103,7 @@ class CfnRuleGroupsNamespace(
         :param id: Construct identifier for this resource (unique in its scope).
         :param data: The rules file used in the namespace. For more details about the rules file, see `Creating a rules file <https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-ruler-rulesfile.html>`_ in the *Amazon Managed Service for Prometheus User Guide* .
         :param name: The name of the rule groups namespace.
-        :param workspace: An Amazon Managed Service for Prometheus workspace is a logical and isolated Prometheus server dedicated to ingesting, storing, and querying your Prometheus-compatible metrics.
+        :param workspace: The ID of the workspace to add the rule groups namespace.
         :param tags: The list of tag keys and values that are associated with the rule groups namespace.
         '''
         if __debug__:
@@ -197,7 +197,7 @@ class CfnRuleGroupsNamespace(
     @builtins.property
     @jsii.member(jsii_name="workspace")
     def workspace(self) -> builtins.str:
-        '''An Amazon Managed Service for Prometheus workspace is a logical and isolated Prometheus server dedicated to ingesting, storing, and querying your Prometheus-compatible metrics.'''
+        '''The ID of the workspace to add the rule groups namespace.'''
         return typing.cast(builtins.str, jsii.get(self, "workspace"))
 
     @workspace.setter
@@ -244,7 +244,7 @@ class CfnRuleGroupsNamespaceProps:
 
         :param data: The rules file used in the namespace. For more details about the rules file, see `Creating a rules file <https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-ruler-rulesfile.html>`_ in the *Amazon Managed Service for Prometheus User Guide* .
         :param name: The name of the rule groups namespace.
-        :param workspace: An Amazon Managed Service for Prometheus workspace is a logical and isolated Prometheus server dedicated to ingesting, storing, and querying your Prometheus-compatible metrics.
+        :param workspace: The ID of the workspace to add the rule groups namespace.
         :param tags: The list of tag keys and values that are associated with the rule groups namespace.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-rulegroupsnamespace.html
@@ -306,7 +306,7 @@ class CfnRuleGroupsNamespaceProps:
 
     @builtins.property
     def workspace(self) -> builtins.str:
-        '''An Amazon Managed Service for Prometheus workspace is a logical and isolated Prometheus server dedicated to ingesting, storing, and querying your Prometheus-compatible metrics.
+        '''The ID of the workspace to add the rule groups namespace.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-rulegroupsnamespace.html#cfn-aps-rulegroupsnamespace-workspace
         '''
@@ -341,7 +341,16 @@ class CfnScraper(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_aps.CfnScraper",
 ):
-    '''Resource Type definition for AWS::APS::Scraper.
+    '''A scraper is a fully-managed agentless collector that discovers and pulls metrics automatically.
+
+    A scraper pulls metrics from Prometheus-compatible sources within an Amazon EKS cluster, and sends them to your Amazon Managed Service for Prometheus workspace. Scrapers are flexible. You can configure the scraper to control what metrics are collected, the frequency of collection, what transformations are applied to the metrics, and more.
+
+    An IAM role will be created for you that Amazon Managed Service for Prometheus uses to access the metrics in your cluster. You must configure this role with a policy that allows it to scrape metrics from your cluster. For more information, see `Configuring your Amazon EKS cluster <https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html#AMP-collector-eks-setup>`_ in the *Amazon Managed Service for Prometheus User Guide* .
+
+    The ``scrapeConfiguration`` parameter contains the YAML configuration for the scraper.
+    .. epigraph::
+
+       For more information about collectors, including what metrics are collected, and how to configure the scraper, see `Using an AWS managed collector <https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html>`_ in the *Amazon Managed Service for Prometheus User Guide* .
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-scraper.html
     :cloudformationResource: AWS::APS::Scraper
@@ -395,11 +404,11 @@ class CfnScraper(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param destination: Scraper metrics destination.
-        :param scrape_configuration: Scraper configuration.
-        :param source: Scraper metrics source.
-        :param alias: Scraper alias.
-        :param tags: An array of key-value pairs to apply to this resource.
+        :param destination: The Amazon Managed Service for Prometheus workspace the scraper sends metrics to.
+        :param scrape_configuration: The configuration in use by the scraper.
+        :param source: The Amazon EKS cluster from which the scraper collects metrics.
+        :param alias: An optional user-assigned scraper alias.
+        :param tags: (Optional) The list of tag keys and values associated with the scraper.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__4d4cb1653b22b80f73c5fa4972418519c1d58f8ac033d22184f1b74ee25bf2b0)
@@ -448,7 +457,9 @@ class CfnScraper(
     @builtins.property
     @jsii.member(jsii_name="attrArn")
     def attr_arn(self) -> builtins.str:
-        '''Scraper ARN.
+        '''The Amazon Resource Name (ARN) of the scraper.
+
+        For example, ``arn:aws:aps:<region>:123456798012:scraper/s-example1-1234-abcd-5678-ef9012abcd34`` .
 
         :cloudformationAttribute: Arn
         '''
@@ -457,7 +468,9 @@ class CfnScraper(
     @builtins.property
     @jsii.member(jsii_name="attrRoleArn")
     def attr_role_arn(self) -> builtins.str:
-        '''IAM role ARN for the scraper.
+        '''The Amazon Resource Name (ARN) of the IAM role that provides permissions for the scraper to discover and collect metrics on your behalf.
+
+        For example, ``arn:aws:iam::123456789012:role/service-role/AmazonGrafanaServiceRole-12example`` .
 
         :cloudformationAttribute: RoleArn
         '''
@@ -466,7 +479,9 @@ class CfnScraper(
     @builtins.property
     @jsii.member(jsii_name="attrScraperId")
     def attr_scraper_id(self) -> builtins.str:
-        '''Required to identify a specific scraper.
+        '''The ID of the scraper.
+
+        For example, ``s-example1-1234-abcd-5678-ef9012abcd34`` .
 
         :cloudformationAttribute: ScraperId
         '''
@@ -488,7 +503,7 @@ class CfnScraper(
     def destination(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, "CfnScraper.DestinationProperty"]:
-        '''Scraper metrics destination.'''
+        '''The Amazon Managed Service for Prometheus workspace the scraper sends metrics to.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnScraper.DestinationProperty"], jsii.get(self, "destination"))
 
     @destination.setter
@@ -506,7 +521,7 @@ class CfnScraper(
     def scrape_configuration(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, "CfnScraper.ScrapeConfigurationProperty"]:
-        '''Scraper configuration.'''
+        '''The configuration in use by the scraper.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnScraper.ScrapeConfigurationProperty"], jsii.get(self, "scrapeConfiguration"))
 
     @scrape_configuration.setter
@@ -524,7 +539,7 @@ class CfnScraper(
     def source(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, "CfnScraper.SourceProperty"]:
-        '''Scraper metrics source.'''
+        '''The Amazon EKS cluster from which the scraper collects metrics.'''
         return typing.cast(typing.Union[_IResolvable_da3f097b, "CfnScraper.SourceProperty"], jsii.get(self, "source"))
 
     @source.setter
@@ -540,7 +555,7 @@ class CfnScraper(
     @builtins.property
     @jsii.member(jsii_name="alias")
     def alias(self) -> typing.Optional[builtins.str]:
-        '''Scraper alias.'''
+        '''An optional user-assigned scraper alias.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "alias"))
 
     @alias.setter
@@ -553,7 +568,7 @@ class CfnScraper(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An array of key-value pairs to apply to this resource.'''
+        '''(Optional) The list of tag keys and values associated with the scraper.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -570,9 +585,9 @@ class CfnScraper(
     )
     class AmpConfigurationProperty:
         def __init__(self, *, workspace_arn: builtins.str) -> None:
-            '''Configuration for Amazon Managed Prometheus metrics destination.
+            '''The ``AmpConfiguration`` structure defines the Amazon Managed Service for Prometheus instance a scraper should send metrics to.
 
-            :param workspace_arn: ARN of an Amazon Managed Prometheus workspace.
+            :param workspace_arn: ARN of the Amazon Managed Service for Prometheus workspace.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-ampconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -596,7 +611,7 @@ class CfnScraper(
 
         @builtins.property
         def workspace_arn(self) -> builtins.str:
-            '''ARN of an Amazon Managed Prometheus workspace.
+            '''ARN of the Amazon Managed Service for Prometheus workspace.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-ampconfiguration.html#cfn-aps-scraper-ampconfiguration-workspacearn
             '''
@@ -626,9 +641,9 @@ class CfnScraper(
             *,
             amp_configuration: typing.Union[_IResolvable_da3f097b, typing.Union["CfnScraper.AmpConfigurationProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''Scraper metrics destination.
+            '''Where to send the metrics from a scraper.
 
-            :param amp_configuration: Configuration for Amazon Managed Prometheus metrics destination.
+            :param amp_configuration: The Amazon Managed Service for Prometheus workspace to send metrics to.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-destination.html
             :exampleMetadata: fixture=_generated
@@ -656,7 +671,7 @@ class CfnScraper(
         def amp_configuration(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnScraper.AmpConfigurationProperty"]:
-            '''Configuration for Amazon Managed Prometheus metrics destination.
+            '''The Amazon Managed Service for Prometheus workspace to send metrics to.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-destination.html#cfn-aps-scraper-destination-ampconfiguration
             '''
@@ -692,11 +707,11 @@ class CfnScraper(
             subnet_ids: typing.Sequence[builtins.str],
             security_group_ids: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
-            '''Configuration for EKS metrics source.
+            '''The ``EksConfiguration`` structure describes the connection to the Amazon EKS cluster from which a scraper collects metrics.
 
-            :param cluster_arn: ARN of an EKS cluster.
-            :param subnet_ids: List of subnet IDs.
-            :param security_group_ids: List of security group IDs.
+            :param cluster_arn: ARN of the Amazon EKS cluster.
+            :param subnet_ids: A list of subnet IDs for the Amazon EKS cluster VPC configuration.
+            :param security_group_ids: A list of the security group IDs for the Amazon EKS cluster VPC configuration.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-eksconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -729,7 +744,7 @@ class CfnScraper(
 
         @builtins.property
         def cluster_arn(self) -> builtins.str:
-            '''ARN of an EKS cluster.
+            '''ARN of the Amazon EKS cluster.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-eksconfiguration.html#cfn-aps-scraper-eksconfiguration-clusterarn
             '''
@@ -739,7 +754,7 @@ class CfnScraper(
 
         @builtins.property
         def subnet_ids(self) -> typing.List[builtins.str]:
-            '''List of subnet IDs.
+            '''A list of subnet IDs for the Amazon EKS cluster VPC configuration.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-eksconfiguration.html#cfn-aps-scraper-eksconfiguration-subnetids
             '''
@@ -749,7 +764,7 @@ class CfnScraper(
 
         @builtins.property
         def security_group_ids(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''List of security group IDs.
+            '''A list of the security group IDs for the Amazon EKS cluster VPC configuration.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-eksconfiguration.html#cfn-aps-scraper-eksconfiguration-securitygroupids
             '''
@@ -774,9 +789,11 @@ class CfnScraper(
     )
     class ScrapeConfigurationProperty:
         def __init__(self, *, configuration_blob: builtins.str) -> None:
-            '''Scraper configuration.
+            '''A scrape configuration for a scraper, base 64 encoded.
+
+            For more information, see `Scraper configuration <https://docs.aws.amazon.com/prometheus/latest/userguide/AMP-collector-how-to.html#AMP-collector-configuration>`_ in the *Amazon Managed Service for Prometheus User Guide* .
 
-            :param configuration_blob: Prometheus compatible scrape configuration in base64 encoded blob format.
+            :param configuration_blob: The base 64 encoded scrape configuration file.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-scrapeconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -800,7 +817,7 @@ class CfnScraper(
 
         @builtins.property
         def configuration_blob(self) -> builtins.str:
-            '''Prometheus compatible scrape configuration in base64 encoded blob format.
+            '''The base 64 encoded scrape configuration file.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-scrapeconfiguration.html#cfn-aps-scraper-scrapeconfiguration-configurationblob
             '''
@@ -830,9 +847,9 @@ class CfnScraper(
             *,
             eks_configuration: typing.Union[_IResolvable_da3f097b, typing.Union["CfnScraper.EksConfigurationProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''Scraper metrics source.
+            '''The source of collected metrics for a scraper.
 
-            :param eks_configuration: Configuration for EKS metrics source.
+            :param eks_configuration: The Amazon EKS cluster from which a scraper collects metrics.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-source.html
             :exampleMetadata: fixture=_generated
@@ -864,7 +881,7 @@ class CfnScraper(
         def eks_configuration(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnScraper.EksConfigurationProperty"]:
-            '''Configuration for EKS metrics source.
+            '''The Amazon EKS cluster from which a scraper collects metrics.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-aps-scraper-source.html#cfn-aps-scraper-source-eksconfiguration
             '''
@@ -907,11 +924,11 @@ class CfnScraperProps:
     ) -> None:
         '''Properties for defining a ``CfnScraper``.
 
-        :param destination: Scraper metrics destination.
-        :param scrape_configuration: Scraper configuration.
-        :param source: Scraper metrics source.
-        :param alias: Scraper alias.
-        :param tags: An array of key-value pairs to apply to this resource.
+        :param destination: The Amazon Managed Service for Prometheus workspace the scraper sends metrics to.
+        :param scrape_configuration: The configuration in use by the scraper.
+        :param source: The Amazon EKS cluster from which the scraper collects metrics.
+        :param alias: An optional user-assigned scraper alias.
+        :param tags: (Optional) The list of tag keys and values associated with the scraper.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-scraper.html
         :exampleMetadata: fixture=_generated
@@ -970,7 +987,7 @@ class CfnScraperProps:
     def destination(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, CfnScraper.DestinationProperty]:
-        '''Scraper metrics destination.
+        '''The Amazon Managed Service for Prometheus workspace the scraper sends metrics to.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-scraper.html#cfn-aps-scraper-destination
         '''
@@ -982,7 +999,7 @@ class CfnScraperProps:
     def scrape_configuration(
         self,
     ) -> typing.Union[_IResolvable_da3f097b, CfnScraper.ScrapeConfigurationProperty]:
-        '''Scraper configuration.
+        '''The configuration in use by the scraper.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-scraper.html#cfn-aps-scraper-scrapeconfiguration
         '''
@@ -992,7 +1009,7 @@ class CfnScraperProps:
 
     @builtins.property
     def source(self) -> typing.Union[_IResolvable_da3f097b, CfnScraper.SourceProperty]:
-        '''Scraper metrics source.
+        '''The Amazon EKS cluster from which the scraper collects metrics.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-scraper.html#cfn-aps-scraper-source
         '''
@@ -1002,7 +1019,7 @@ class CfnScraperProps:
 
     @builtins.property
     def alias(self) -> typing.Optional[builtins.str]:
-        '''Scraper alias.
+        '''An optional user-assigned scraper alias.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-scraper.html#cfn-aps-scraper-alias
         '''
@@ -1011,7 +1028,7 @@ class CfnScraperProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An array of key-value pairs to apply to this resource.
+        '''(Optional) The list of tag keys and values associated with the scraper.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-aps-scraper.html#cfn-aps-scraper-tags
         '''

aws_cdk/aws_b2bi/__init__.py

@@ -657,7 +657,7 @@ class CfnCapability(
         ) -> None:
             '''
             :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.
-            :param version: Returns the version to use for the specified X12 transaction set. Supported versions are ``4010`` , ``4030`` , and ``5010`` .
+            :param version: Returns the version to use for the specified X12 transaction set.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-capability-x12details.html
             :exampleMetadata: fixture=_generated
@@ -698,8 +698,6 @@ class CfnCapability(
         def version(self) -> typing.Optional[builtins.str]:
             '''Returns the version to use for the specified X12 transaction set.
 
-            Supported versions are ``4010`` , ``4030`` , and ``5010`` .
-
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-capability-x12details.html#cfn-b2bi-capability-x12details-version
             '''
             result = self._values.get("version")
@@ -1974,7 +1972,7 @@ class CfnTransformer(
                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.
 
             :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.
-            :param version: Returns the version to use for the specified X12 transaction set. Supported versions are ``4010`` , ``4030`` , and ``5010`` .
+            :param version: Returns the version to use for the specified X12 transaction set.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-transformer-x12details.html
             :exampleMetadata: fixture=_generated
@@ -2015,8 +2013,6 @@ class CfnTransformer(
         def version(self) -> typing.Optional[builtins.str]:
             '''Returns the version to use for the specified X12 transaction set.
 
-            Supported versions are ``4010`` , ``4030`` , and ``5010`` .
-
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-b2bi-transformer-x12details.html#cfn-b2bi-transformer-x12details-version
             '''
             result = self._values.get("version")

aws_cdk/aws_backup/__init__.py

@@ -3457,7 +3457,7 @@ class CfnBackupVault(
         :param id: Construct identifier for this resource (unique in its scope).
         :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.
         :param access_policy: A resource-based policy that is used to manage access permissions on the target backup vault.
-        :param backup_vault_tags: Metadata that you can assign to help organize the resources that you create. Each tag is a key-value pair.
+        :param backup_vault_tags: Metadata that you can assign to help organize your backup vaults. Each tag is a key-value pair.
         :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>`_
         :param lock_configuration: Configuration for `AWS Backup Vault Lock <https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html>`_ .
         :param notifications: The SNS event notifications for the specified backup vault.
@@ -3571,7 +3571,7 @@ class CfnBackupVault(
     def backup_vault_tags(
         self,
     ) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''Metadata that you can assign to help organize the resources that you create.'''
+        '''Metadata that you can assign to help organize your backup vaults.'''
         return typing.cast(typing.Optional[typing.Mapping[builtins.str, builtins.str]], jsii.get(self, "backupVaultTags"))
 
     @backup_vault_tags.setter
@@ -3851,7 +3851,7 @@ class CfnBackupVaultProps:
 
         :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.
         :param access_policy: A resource-based policy that is used to manage access permissions on the target backup vault.
-        :param backup_vault_tags: Metadata that you can assign to help organize the resources that you create. Each tag is a key-value pair.
+        :param backup_vault_tags: Metadata that you can assign to help organize your backup vaults. Each tag is a key-value pair.
         :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>`_
         :param lock_configuration: Configuration for `AWS Backup Vault Lock <https://docs.aws.amazon.com/aws-backup/latest/devguide/vault-lock.html>`_ .
         :param notifications: The SNS event notifications for the specified backup vault.
@@ -3936,7 +3936,7 @@ class CfnBackupVaultProps:
     def backup_vault_tags(
         self,
     ) -> typing.Optional[typing.Mapping[builtins.str, builtins.str]]:
-        '''Metadata that you can assign to help organize the resources that you create.
+        '''Metadata that you can assign to help organize your backup vaults.
 
         Each tag is a key-value pair.
 
@@ -4054,7 +4054,7 @@ class CfnFramework(
         :param framework_controls: Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
         :param framework_description: An optional description of the framework with a maximum 1,024 characters.
         :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 (_).
-        :param framework_tags: A list of tags with which to tag your framework.
+        :param framework_tags: The tags to add your framework.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__762b6f2cf173ed987e2f05e55b691e4e8e14552591e05b26b7f7f4e08e3c739d)
@@ -4197,7 +4197,7 @@ class CfnFramework(
     @builtins.property
     @jsii.member(jsii_name="frameworkTags")
     def framework_tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''A list of tags with which to tag your framework.'''
+        '''The tags to add your framework.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "frameworkTags"))
 
     @framework_tags.setter
@@ -4521,7 +4521,7 @@ class CfnFrameworkProps:
         :param framework_controls: Contains detailed information about all of the controls of a framework. Each framework must contain at least one control.
         :param framework_description: An optional description of the framework with a maximum 1,024 characters.
         :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 (_).
-        :param framework_tags: A list of tags with which to tag your framework.
+        :param framework_tags: The tags to add your framework.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-framework.html
         :exampleMetadata: fixture=_generated
@@ -4607,7 +4607,7 @@ class CfnFrameworkProps:
 
     @builtins.property
     def framework_tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''A list of tags with which to tag your framework.
+        '''The tags to add your framework.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-backup-framework.html#cfn-backup-framework-frameworktags
         '''
@@ -5425,13 +5425,23 @@ class CfnRestoreTestingPlan(
             exclude_vaults: typing.Optional[typing.Sequence[builtins.str]] = None,
             selection_window_days: typing.Optional[jsii.Number] = None,
         ) -> None:
-            '''Required: Algorithm;
+            '''``RecoveryPointSelection`` has five parameters (three required and two optional).
 
-            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.
+            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.
+
+            ``Algorithm`` ( *required* ) Valid values: " ``LATEST_WITHIN_WINDOW`` " or " ``RANDOM_WITHIN_WINDOW`` ".
+
+            ``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`` .
+
+            ``IncludeVaults`` ( *required* ). You must include one or more backup vaults. Use the wildcard ["*"] or specific ARNs.
+
+            ``SelectionWindowDays`` ( *optional* ) Value must be an integer (in days) from 1 to 365. If not included, the value defaults to ``30`` .
+
+            ``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.
 
             :param algorithm: Acceptable values include "LATEST_WITHIN_WINDOW" or "RANDOM_WITHIN_WINDOW".
             :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-*", ...].
-            :param recovery_point_types: These are the types of recovery points.
+            :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`` .
             :param exclude_vaults: Accepted values include specific ARNs or list of selectors. Defaults to empty list if not listed.
             :param selection_window_days: Accepted values are integers from 1 to 365.
 
@@ -5495,6 +5505,8 @@ class CfnRestoreTestingPlan(
         def recovery_point_types(self) -> typing.List[builtins.str]:
             '''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`` .
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-restoretestingplan-restoretestingrecoverypointselection.html#cfn-backup-restoretestingplan-restoretestingrecoverypointselection-recoverypointtypes
             '''
             result = self._values.get("recovery_point_types")
@@ -5957,8 +5969,8 @@ class CfnRestoreTestingSelection(
 
             Allowed characters are letters, white space, and numbers that can be represented in UTF-8 and the following characters: ``+ - = . _ : /``
 
-            :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}_.:/=+\\-@]+)$``
-            :param value: The value of the key. Length Constraints: Maximum length of 256. Pattern: ``^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$``
+            :param key: The tag key.
+            :param value: The tag value.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-restoretestingselection-keyvalue.html
             :exampleMetadata: fixture=_generated
@@ -5985,11 +5997,7 @@ class CfnRestoreTestingSelection(
 
         @builtins.property
         def key(self) -> builtins.str:
-            '''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}_.:/=+\\-@]+)$``
+            '''The tag key.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-restoretestingselection-keyvalue.html#cfn-backup-restoretestingselection-keyvalue-key
             '''
@@ -5999,11 +6007,7 @@ class CfnRestoreTestingSelection(
 
         @builtins.property
         def value(self) -> builtins.str:
-            '''The value of the key.
-
-            Length Constraints: Maximum length of 256.
-
-            Pattern: ``^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$``
+            '''The tag value.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-backup-restoretestingselection-keyvalue.html#cfn-backup-restoretestingselection-keyvalue-value
             '''