aws-cdk-lib 2.140.0__py3-none-any.whl → 2.141.0__py3-none-any.whl

aws_cdk/_jsii/__init__.py

@@ -19,7 +19,7 @@ import aws_cdk.asset_node_proxy_agent_v6._jsii
 import constructs._jsii
 
 __jsii_assembly__ = jsii.JSIIAssembly.load(
-    "aws-cdk-lib", "2.140.0", __name__[0:-6], "aws-cdk-lib@2.140.0.jsii.tgz"
+    "aws-cdk-lib", "2.141.0", __name__[0:-6], "aws-cdk-lib@2.141.0.jsii.tgz"
 )
 
 __all__ = [

aws_cdk/aws_bedrock/__init__.py

@@ -984,11 +984,11 @@ class CfnAgent(
             top_k: typing.Optional[jsii.Number] = None,
             top_p: typing.Optional[jsii.Number] = None,
         ) -> None:
-            '''Contains inference parameters to use when the agent invokes a foundation model in the part of the agent sequence defined by the ``promptType`` .
+            '''Specifications about the inference parameters that were provided alongside the prompt.
 
-            For more information, see `Inference parameters for foundation models <https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html>`_ .
+            These are specified in the `PromptOverrideConfiguration <https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptOverrideConfiguration.html>`_ object that was set when the agent was created or updated. For more information, see `Inference parameters for foundation models <https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html>`_ .
 
-            :param maximum_length: The maximum number of tokens to allow in the generated response.
+            :param maximum_length: The maximum number of tokens allowed in the generated response.
             :param stop_sequences: A list of stop sequences. A stop sequence is a sequence of characters that causes the model to stop generating the response.
             :param temperature: The likelihood of the model selecting higher-probability options while generating a response. A lower value makes the model more likely to choose higher-probability options, while a higher value makes the model more likely to choose lower-probability options.
             :param top_k: While generating a response, the model determines the probability of the following token at each point of generation. The value that you set for ``topK`` is the number of most-likely candidates from which the model chooses the next token in the sequence. For example, if you set ``topK`` to 50, the model selects the next token from among the top 50 most likely choices.
@@ -1032,7 +1032,7 @@ class CfnAgent(
 
         @builtins.property
         def maximum_length(self) -> typing.Optional[jsii.Number]:
-            '''The maximum number of tokens to allow in the generated response.
+            '''The maximum number of tokens allowed in the generated response.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-agent-inferenceconfiguration.html#cfn-bedrock-agent-inferenceconfiguration-maximumlength
             '''
@@ -2381,7 +2381,7 @@ class CfnDataSource(
         :param data_source_configuration: Contains details about how the data source is stored.
         :param knowledge_base_id: The unique identifier of the knowledge base to which the data source belongs.
         :param name: The name of the data source.
-        :param data_deletion_policy: The deletion policy for the data source.
+        :param data_deletion_policy: The data deletion policy for a data source.
         :param description: The description of the data source.
         :param server_side_encryption_configuration: Contains details about the configuration of the server-side encryption.
         :param vector_ingestion_configuration: Contains details about how to ingest the documents in the data source.
@@ -2465,7 +2465,7 @@ class CfnDataSource(
     @builtins.property
     @jsii.member(jsii_name="attrFailureReasons")
     def attr_failure_reasons(self) -> typing.List[builtins.str]:
-        '''The details of the failure reasons related to the data source.
+        '''The detailed reasons on the failure to delete a data source.
 
         :cloudformationAttribute: FailureReasons
         '''
@@ -2532,7 +2532,7 @@ class CfnDataSource(
     @builtins.property
     @jsii.member(jsii_name="dataDeletionPolicy")
     def data_deletion_policy(self) -> typing.Optional[builtins.str]:
-        '''The deletion policy for the data source.'''
+        '''The data deletion policy for a data source.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "dataDeletionPolicy"))
 
     @data_deletion_policy.setter
@@ -2856,7 +2856,7 @@ class CfnDataSource(
             '''Contains information about the S3 configuration of the data source.
 
             :param bucket_arn: The Amazon Resource Name (ARN) of the bucket that contains the data source.
-            :param bucket_owner_account_id: The account ID for the owner of the S3 bucket.
+            :param bucket_owner_account_id: The bucket account owner ID for the S3 bucket.
             :param inclusion_prefixes: A list of S3 prefixes that define the object containing the data sources. For more information, see `Organizing objects using prefixes <https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html>`_ .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-datasource-s3datasourceconfiguration.html
@@ -2901,7 +2901,7 @@ class CfnDataSource(
 
         @builtins.property
         def bucket_owner_account_id(self) -> typing.Optional[builtins.str]:
-            '''The account ID for the owner of the S3 bucket.
+            '''The bucket account owner ID for the S3 bucket.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-bedrock-datasource-s3datasourceconfiguration.html#cfn-bedrock-datasource-s3datasourceconfiguration-bucketowneraccountid
             '''
@@ -3083,7 +3083,7 @@ class CfnDataSourceProps:
         :param data_source_configuration: Contains details about how the data source is stored.
         :param knowledge_base_id: The unique identifier of the knowledge base to which the data source belongs.
         :param name: The name of the data source.
-        :param data_deletion_policy: The deletion policy for the data source.
+        :param data_deletion_policy: The data deletion policy for a data source.
         :param description: The description of the data source.
         :param server_side_encryption_configuration: Contains details about the configuration of the server-side encryption.
         :param vector_ingestion_configuration: Contains details about how to ingest the documents in the data source.
@@ -3187,7 +3187,7 @@ class CfnDataSourceProps:
 
     @builtins.property
     def data_deletion_policy(self) -> typing.Optional[builtins.str]:
-        '''The deletion policy for the data source.
+        '''The data deletion policy for a data source.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-bedrock-datasource.html#cfn-bedrock-datasource-datadeletionpolicy
         '''
@@ -3243,7 +3243,9 @@ class CfnGuardrail(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_bedrock.CfnGuardrail",
 ):
-    '''Definition of AWS::Bedrock::Guardrail Resource Type.
+    '''Creates a guardrail to block topics and to implement safeguards for your generative AI applications.
+
+    You can configure denied topics to disallow undesirable topics and content filters to block harmful content in model inputs and responses. For more information, see `Guardrails for Amazon Bedrock <https://docs.aws.amazon.com/bedrock/latest/userguide/guardrails.html>`_ in the *Amazon Bedrock User Guide*
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-bedrock-guardrail.html
     :cloudformationResource: AWS::Bedrock::Guardrail
@@ -3328,14 +3330,14 @@ class CfnGuardrail(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param blocked_input_messaging: Messaging for when violations are detected in text.
-        :param blocked_outputs_messaging: Messaging for when violations are detected in text.
-        :param name: Name of the guardrail.
+        :param blocked_input_messaging: The message to return when the guardrail blocks a prompt.
+        :param blocked_outputs_messaging: The message to return when the guardrail blocks a model response.
+        :param name: The name of the guardrail.
         :param content_policy_config: Content policy config for a guardrail.
-        :param description: Description of the guardrail or its version.
-        :param kms_key_arn: The KMS key with which the guardrail was encrypted at rest.
+        :param description: A description of the guardrail.
+        :param kms_key_arn: The ARN of the AWS KMS key used to encrypt the guardrail.
         :param sensitive_information_policy_config: Sensitive information policy config for a guardrail.
-        :param tags: List of Tags.
+        :param tags: Metadata that you can assign to a guardrail as key-value pairs. For more information, see the following resources:. - `Tag naming limits and requirements <https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html#tag-conventions>`_ - `Tagging best practices <https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html#tag-best-practices>`_
         :param topic_policy_config: Topic policy config for a guardrail.
         :param word_policy_config: Word policy config for a guardrail.
         '''
@@ -3391,7 +3393,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="attrCreatedAt")
     def attr_created_at(self) -> builtins.str:
-        '''Time Stamp.
+        '''The date and time at which the guardrail was created.
 
         :cloudformationAttribute: CreatedAt
         '''
@@ -3409,7 +3411,9 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="attrGuardrailArn")
     def attr_guardrail_arn(self) -> builtins.str:
-        '''Arn representation for the guardrail.
+        '''The Amazon Resource Name (ARN) of the guardrail.
+
+        This a the primary identifier for the guardrail.
 
         :cloudformationAttribute: GuardrailArn
         '''
@@ -3418,7 +3422,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="attrGuardrailId")
     def attr_guardrail_id(self) -> builtins.str:
-        '''Unique id for the guardrail.
+        '''The unique identifier of the guardrail.
 
         :cloudformationAttribute: GuardrailId
         '''
@@ -3445,7 +3449,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="attrUpdatedAt")
     def attr_updated_at(self) -> builtins.str:
-        '''Time Stamp.
+        '''The date and time at which the guardrail was last updated.
 
         :cloudformationAttribute: UpdatedAt
         '''
@@ -3454,7 +3458,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="attrVersion")
     def attr_version(self) -> builtins.str:
-        '''Guardrail version.
+        '''The version of the guardrail.
 
         :cloudformationAttribute: Version
         '''
@@ -3474,7 +3478,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="blockedInputMessaging")
     def blocked_input_messaging(self) -> builtins.str:
-        '''Messaging for when violations are detected in text.'''
+        '''The message to return when the guardrail blocks a prompt.'''
         return typing.cast(builtins.str, jsii.get(self, "blockedInputMessaging"))
 
     @blocked_input_messaging.setter
@@ -3487,7 +3491,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="blockedOutputsMessaging")
     def blocked_outputs_messaging(self) -> builtins.str:
-        '''Messaging for when violations are detected in text.'''
+        '''The message to return when the guardrail blocks a model response.'''
         return typing.cast(builtins.str, jsii.get(self, "blockedOutputsMessaging"))
 
     @blocked_outputs_messaging.setter
@@ -3500,7 +3504,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="name")
     def name(self) -> builtins.str:
-        '''Name of the guardrail.'''
+        '''The name of the guardrail.'''
         return typing.cast(builtins.str, jsii.get(self, "name"))
 
     @name.setter
@@ -3531,7 +3535,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="description")
     def description(self) -> typing.Optional[builtins.str]:
-        '''Description of the guardrail or its version.'''
+        '''A description of the guardrail.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "description"))
 
     @description.setter
@@ -3544,7 +3548,7 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="kmsKeyArn")
     def kms_key_arn(self) -> typing.Optional[builtins.str]:
-        '''The KMS key with which the guardrail was encrypted at rest.'''
+        '''The ARN of the AWS KMS key used to encrypt the guardrail.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "kmsKeyArn"))
 
     @kms_key_arn.setter
@@ -3575,7 +3579,10 @@ class CfnGuardrail(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''List of Tags.'''
+        '''Metadata that you can assign to a guardrail as key-value pairs.
+
+        For more information, see the following resources:.
+        '''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -4426,14 +4433,14 @@ class CfnGuardrailProps:
     ) -> None:
         '''Properties for defining a ``CfnGuardrail``.
 
-        :param blocked_input_messaging: Messaging for when violations are detected in text.
-        :param blocked_outputs_messaging: Messaging for when violations are detected in text.
-        :param name: Name of the guardrail.
+        :param blocked_input_messaging: The message to return when the guardrail blocks a prompt.
+        :param blocked_outputs_messaging: The message to return when the guardrail blocks a model response.
+        :param name: The name of the guardrail.
         :param content_policy_config: Content policy config for a guardrail.
-        :param description: Description of the guardrail or its version.
-        :param kms_key_arn: The KMS key with which the guardrail was encrypted at rest.
+        :param description: A description of the guardrail.
+        :param kms_key_arn: The ARN of the AWS KMS key used to encrypt the guardrail.
         :param sensitive_information_policy_config: Sensitive information policy config for a guardrail.
-        :param tags: List of Tags.
+        :param tags: Metadata that you can assign to a guardrail as key-value pairs. For more information, see the following resources:. - `Tag naming limits and requirements <https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html#tag-conventions>`_ - `Tagging best practices <https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html#tag-best-practices>`_
         :param topic_policy_config: Topic policy config for a guardrail.
         :param word_policy_config: Word policy config for a guardrail.
 
@@ -4533,7 +4540,7 @@ class CfnGuardrailProps:
 
     @builtins.property
     def blocked_input_messaging(self) -> builtins.str:
-        '''Messaging for when violations are detected in text.
+        '''The message to return when the guardrail blocks a prompt.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-bedrock-guardrail.html#cfn-bedrock-guardrail-blockedinputmessaging
         '''
@@ -4543,7 +4550,7 @@ class CfnGuardrailProps:
 
     @builtins.property
     def blocked_outputs_messaging(self) -> builtins.str:
-        '''Messaging for when violations are detected in text.
+        '''The message to return when the guardrail blocks a model response.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-bedrock-guardrail.html#cfn-bedrock-guardrail-blockedoutputsmessaging
         '''
@@ -4553,7 +4560,7 @@ class CfnGuardrailProps:
 
     @builtins.property
     def name(self) -> builtins.str:
-        '''Name of the guardrail.
+        '''The name of the guardrail.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-bedrock-guardrail.html#cfn-bedrock-guardrail-name
         '''
@@ -4574,7 +4581,7 @@ class CfnGuardrailProps:
 
     @builtins.property
     def description(self) -> typing.Optional[builtins.str]:
-        '''Description of the guardrail or its version.
+        '''A description of the guardrail.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-bedrock-guardrail.html#cfn-bedrock-guardrail-description
         '''
@@ -4583,7 +4590,7 @@ class CfnGuardrailProps:
 
     @builtins.property
     def kms_key_arn(self) -> typing.Optional[builtins.str]:
-        '''The KMS key with which the guardrail was encrypted at rest.
+        '''The ARN of the AWS KMS key used to encrypt the guardrail.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-bedrock-guardrail.html#cfn-bedrock-guardrail-kmskeyarn
         '''
@@ -4603,7 +4610,10 @@ class CfnGuardrailProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''List of Tags.
+        '''Metadata that you can assign to a guardrail as key-value pairs. For more information, see the following resources:.
+
+        - `Tag naming limits and requirements <https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html#tag-conventions>`_
+        - `Tagging best practices <https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html#tag-best-practices>`_
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-bedrock-guardrail.html#cfn-bedrock-guardrail-tags
         '''

aws_cdk/aws_cloudtrail/__init__.py

@@ -3383,9 +3383,18 @@ class CfnTrail(
             type: builtins.str,
             values: typing.Optional[typing.Sequence[builtins.str]] = None,
         ) -> None:
-            '''The Amazon S3 buckets, AWS Lambda functions, or Amazon DynamoDB tables that you specify in your event selectors for your trail to log data events.
+            '''Data events provide information about the resource operations performed on or within a resource itself.
+
+            These are also known as data plane operations. You can specify up to 250 data resources for a trail.
+
+            Configure the ``DataResource`` to specify the resource type and resource ARNs for which you want to log data events.
+
+            You can specify the following resource types in your event selectors for your trail:
+
+            - ``AWS::DynamoDB::Table``
+            - ``AWS::Lambda::Function``
+            - ``AWS::S3::Object``
 
-            Data events provide information about the resource operations performed on or within a resource itself. These are also known as data plane operations. You can specify up to 250 data resources for a trail.
             .. epigraph::
 
                The total number of allowed data resources is 250. This number can be distributed between 1 and 5 event selectors, but the total cannot exceed 250 across all selectors for the trail.
@@ -3406,7 +3415,7 @@ class CfnTrail(
             - The ``Invoke`` API operation on *MyOtherLambdaFunction* is an Lambda API. Because the CloudTrail user did not specify logging data events for all Lambda functions, the ``Invoke`` operation for *MyOtherLambdaFunction* does not match the function specified for the trail. The trail doesn’t log the event.
 
             :param type: The resource type in which you want to log data events. You can specify the following *basic* event selector resource types: - ``AWS::DynamoDB::Table`` - ``AWS::Lambda::Function`` - ``AWS::S3::Object`` Additional resource types are available through *advanced* event selectors. For more information about these additional resource types, see `AdvancedFieldSelector <https://docs.aws.amazon.com/awscloudtrail/latest/APIReference/API_AdvancedFieldSelector.html>`_ .
-            :param values: An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified objects. - To log data events for all objects in all S3 buckets in your AWS account , specify the prefix as ``arn:aws:s3`` . .. epigraph:: This also enables logging of data event activity performed by any user or role in your AWS account , even if that activity is performed on a bucket that belongs to another AWS account . - To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as ``arn:aws:s3:::bucket-1/`` . The trail logs data events for all objects in this S3 bucket. - To log data events for specific objects, specify the S3 bucket and object prefix such as ``arn:aws:s3:::bucket-1/example-images`` . The trail logs data events for objects in this S3 bucket that match the prefix. - To log data events for all Lambda functions in your AWS account , specify the prefix as ``arn:aws:lambda`` . .. epigraph:: This also enables logging of ``Invoke`` activity performed by any user or role in your AWS account , even if that activity is performed on a function that belongs to another AWS account . - To log data events for a specific Lambda function, specify the function ARN. .. epigraph:: Lambda function ARNs are exact. For example, if you specify a function ARN *arn:aws:lambda:us-west-2:111111111111:function:helloworld* , data events will only be logged for *arn:aws:lambda:us-west-2:111111111111:function:helloworld* . They will not be logged for *arn:aws:lambda:us-west-2:111111111111:function:helloworld2* . - To log data events for all DynamoDB tables in your AWS account , specify the prefix as ``arn:aws:dynamodb`` .
+            :param values: An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified resource type. - To log data events for all objects in all S3 buckets in your AWS account , specify the prefix as ``arn:aws:s3`` . .. epigraph:: This also enables logging of data event activity performed by any user or role in your AWS account , even if that activity is performed on a bucket that belongs to another AWS account . - To log data events for all objects in an S3 bucket, specify the bucket and an empty object prefix such as ``arn:aws:s3:::bucket-1/`` . The trail logs data events for all objects in this S3 bucket. - To log data events for specific objects, specify the S3 bucket and object prefix such as ``arn:aws:s3:::bucket-1/example-images`` . The trail logs data events for objects in this S3 bucket that match the prefix. - To log data events for all Lambda functions in your AWS account , specify the prefix as ``arn:aws:lambda`` . .. epigraph:: This also enables logging of ``Invoke`` activity performed by any user or role in your AWS account , even if that activity is performed on a function that belongs to another AWS account . - To log data events for a specific Lambda function, specify the function ARN. .. epigraph:: Lambda function ARNs are exact. For example, if you specify a function ARN *arn:aws:lambda:us-west-2:111111111111:function:helloworld* , data events will only be logged for *arn:aws:lambda:us-west-2:111111111111:function:helloworld* . They will not be logged for *arn:aws:lambda:us-west-2:111111111111:function:helloworld2* . - To log data events for all DynamoDB tables in your AWS account , specify the prefix as ``arn:aws:dynamodb`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-cloudtrail-trail-dataresource.html
             :exampleMetadata: fixture=_generated
@@ -3454,7 +3463,7 @@ class CfnTrail(
 
         @builtins.property
         def values(self) -> typing.Optional[typing.List[builtins.str]]:
-            '''An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified objects.
+            '''An array of Amazon Resource Name (ARN) strings or partial ARN strings for the specified resource type.
 
             - To log data events for all objects in all S3 buckets in your AWS account , specify the prefix as ``arn:aws:s3`` .
 

aws_cdk/aws_connectcampaigns/__init__.py

@@ -346,7 +346,7 @@ class CfnCampaign(
             '''Contains information about answering machine detection.
 
             :param enable_answer_machine_detection: Whether answering machine detection is enabled.
-            :param await_answer_machine_prompt: Enables detection of prompts (e.g., beep after after a voicemail greeting).
+            :param await_answer_machine_prompt: Whether waiting for answer machine prompt is enabled.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-connectcampaigns-campaign-answermachinedetectionconfig.html
             :exampleMetadata: fixture=_generated
@@ -390,7 +390,7 @@ class CfnCampaign(
         def await_answer_machine_prompt(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''Enables detection of prompts (e.g., beep after after a voicemail greeting).
+            '''Whether waiting for answer machine prompt is enabled.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-connectcampaigns-campaign-answermachinedetectionconfig.html#cfn-connectcampaigns-campaign-answermachinedetectionconfig-awaitanswermachineprompt
             '''