aws-cdk-lib 2.187.0__py3-none-any.whl → 2.189.0__py3-none-any.whl

aws_cdk/aws_logs_destinations/__init__.py

@@ -41,6 +41,7 @@ from .._jsii import *
 import constructs as _constructs_77d1e7e8
 from ..aws_iam import IRole as _IRole_235f5d8e
 from ..aws_kinesis import IStream as _IStream_4e2457d2
+from ..aws_kinesisfirehose import IDeliveryStream as _IDeliveryStream_8f118861
 from ..aws_lambda import IFunction as _IFunction_6adb0ab8
 from ..aws_logs import (
     ILogGroup as _ILogGroup_3c4fa718,
@@ -49,6 +50,127 @@ from ..aws_logs import (
 )
 
 
+@jsii.implements(_ILogSubscriptionDestination_99a12804)
+class FirehoseDestination(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_logs_destinations.FirehoseDestination",
+):
+    '''Use a Data Firehose delivery stream as the destination for a log subscription.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        import aws_cdk.aws_logs_destinations as destinations
+        import aws_cdk.aws_kinesisfirehose as firehose
+        
+        # delivery_stream: firehose.IDeliveryStream
+        # log_group: logs.LogGroup
+        
+        
+        logs.SubscriptionFilter(self, "Subscription",
+            log_group=log_group,
+            destination=destinations.FirehoseDestination(delivery_stream),
+            filter_pattern=logs.FilterPattern.all_events()
+        )
+    '''
+
+    def __init__(
+        self,
+        stream: _IDeliveryStream_8f118861,
+        *,
+        role: typing.Optional[_IRole_235f5d8e] = None,
+    ) -> None:
+        '''
+        :param stream: The Data Firehose delivery stream to use as destination.
+        :param role: The role to assume to write log events to the destination. Default: - A new Role is created
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__4cb4e49bfe3a6c7ef67778da7a93e24765ed8e25b0e86da6e92e1d5205457086)
+            check_type(argname="argument stream", value=stream, expected_type=type_hints["stream"])
+        props = FirehoseDestinationProps(role=role)
+
+        jsii.create(self.__class__, self, [stream, props])
+
+    @jsii.member(jsii_name="bind")
+    def bind(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        _source_log_group: _ILogGroup_3c4fa718,
+    ) -> _LogSubscriptionDestinationConfig_15877ced:
+        '''Return the properties required to send subscription events to this destination.
+
+        If necessary, the destination can use the properties of the SubscriptionFilter
+        object itself to configure its permissions to allow the subscription to write
+        to it.
+
+        The destination may reconfigure its own permissions in response to this
+        function call.
+
+        :param scope: -
+        :param _source_log_group: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__b48d2560b01f38d75fb9bf3c773ce107d4b79363d6f0dced504bd870eebb715b)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument _source_log_group", value=_source_log_group, expected_type=type_hints["_source_log_group"])
+        return typing.cast(_LogSubscriptionDestinationConfig_15877ced, jsii.invoke(self, "bind", [scope, _source_log_group]))
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_logs_destinations.FirehoseDestinationProps",
+    jsii_struct_bases=[],
+    name_mapping={"role": "role"},
+)
+class FirehoseDestinationProps:
+    def __init__(self, *, role: typing.Optional[_IRole_235f5d8e] = None) -> None:
+        '''Customize the Amazon Data Firehose Logs Destination.
+
+        :param role: The role to assume to write log events to the destination. Default: - A new Role is created
+
+        :exampleMetadata: fixture=_generated
+
+        Example::
+
+            # The code below shows an example of how to instantiate this type.
+            # The values are placeholders you should change.
+            from aws_cdk import aws_iam as iam
+            from aws_cdk import aws_logs_destinations as logs_destinations
+            
+            # role: iam.Role
+            
+            firehose_destination_props = logs_destinations.FirehoseDestinationProps(
+                role=role
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__b45f72f38e87e36b03e7d6828642750a36a55581864f0124704f80206950b2e6)
+            check_type(argname="argument role", value=role, expected_type=type_hints["role"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if role is not None:
+            self._values["role"] = role
+
+    @builtins.property
+    def role(self) -> typing.Optional[_IRole_235f5d8e]:
+        '''The role to assume to write log events to the destination.
+
+        :default: - A new Role is created
+        '''
+        result = self._values.get("role")
+        return typing.cast(typing.Optional[_IRole_235f5d8e], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "FirehoseDestinationProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.implements(_ILogSubscriptionDestination_99a12804)
 class KinesisDestination(
     metaclass=jsii.JSIIMeta,
@@ -296,6 +418,8 @@ class LambdaDestinationOptions:
 
 
 __all__ = [
+    "FirehoseDestination",
+    "FirehoseDestinationProps",
     "KinesisDestination",
     "KinesisDestinationProps",
     "LambdaDestination",
@@ -304,6 +428,28 @@ __all__ = [
 
 publication.publish()
 
+def _typecheckingstub__4cb4e49bfe3a6c7ef67778da7a93e24765ed8e25b0e86da6e92e1d5205457086(
+    stream: _IDeliveryStream_8f118861,
+    *,
+    role: typing.Optional[_IRole_235f5d8e] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__b48d2560b01f38d75fb9bf3c773ce107d4b79363d6f0dced504bd870eebb715b(
+    scope: _constructs_77d1e7e8.Construct,
+    _source_log_group: _ILogGroup_3c4fa718,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__b45f72f38e87e36b03e7d6828642750a36a55581864f0124704f80206950b2e6(
+    *,
+    role: typing.Optional[_IRole_235f5d8e] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__6f4422231f62d5490fdbb0217f4c6e73134c1c066522144d9488224a6ffe689b(
     stream: _IStream_4e2457d2,
     *,

aws_cdk/aws_notifications/__init__.py

@@ -696,7 +696,7 @@ class CfnManagedNotificationAccountContactAssociation(
 ):
     '''Associates an Account Management Contact with a ``ManagedNotificationConfiguration`` for AWS User Notifications .
 
-    For more information about AWS User Notifications , see the `AWS User Notifications User Guide <https://docs.aws.amazon.com/notifications/latest/userguide/what-is-service.html>`_ . For more information about Account Management Contacts, see the `AWS Account Management Reference Guide <https://docs.aws.amazon.com/accounts/latest/reference/API_AlternateContact.html>`_ .
+    For more information about AWS User Notifications , see the `AWS User Notifications User Guide <https://docs.aws.amazon.com/notifications/latest/userguide/what-is-service.html>`_ . For more information about Account Management Contacts, see the `Account Management Reference Guide <https://docs.aws.amazon.com/accounts/latest/reference/API_AlternateContact.html>`_ .
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-notifications-managednotificationaccountcontactassociation.html
     :cloudformationResource: AWS::Notifications::ManagedNotificationAccountContactAssociation
@@ -725,7 +725,7 @@ class CfnManagedNotificationAccountContactAssociation(
         '''
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param contact_identifier: The unique identifier of the notification contact associated with the AWS account. For more information about the contact types associated with an account, see the `AWS Account Management Reference Guide <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html#manage-acct-update-contact-alternate-orgs>`_ .
+        :param contact_identifier: The unique identifier of the notification contact associated with the AWS account. For more information about the contact types associated with an account, see the `Account Management Reference Guide <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html#manage-acct-update-contact-alternate-orgs>`_ .
         :param managed_notification_configuration_arn: The ARN of the ``ManagedNotificationConfiguration`` to be associated with the ``Channel`` .
         '''
         if __debug__:
@@ -818,7 +818,7 @@ class CfnManagedNotificationAccountContactAssociationProps:
     ) -> None:
         '''Properties for defining a ``CfnManagedNotificationAccountContactAssociation``.
 
-        :param contact_identifier: The unique identifier of the notification contact associated with the AWS account. For more information about the contact types associated with an account, see the `AWS Account Management Reference Guide <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html#manage-acct-update-contact-alternate-orgs>`_ .
+        :param contact_identifier: The unique identifier of the notification contact associated with the AWS account. For more information about the contact types associated with an account, see the `Account Management Reference Guide <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html#manage-acct-update-contact-alternate-orgs>`_ .
         :param managed_notification_configuration_arn: The ARN of the ``ManagedNotificationConfiguration`` to be associated with the ``Channel`` .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-notifications-managednotificationaccountcontactassociation.html
@@ -848,7 +848,7 @@ class CfnManagedNotificationAccountContactAssociationProps:
     def contact_identifier(self) -> builtins.str:
         '''The unique identifier of the notification contact associated with the AWS account.
 
-        For more information about the contact types associated with an account, see the `AWS Account Management Reference Guide <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html#manage-acct-update-contact-alternate-orgs>`_ .
+        For more information about the contact types associated with an account, see the `Account Management Reference Guide <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html#manage-acct-update-contact-alternate-orgs>`_ .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-notifications-managednotificationaccountcontactassociation.html#cfn-notifications-managednotificationaccountcontactassociation-contactidentifier
         '''

aws_cdk/aws_omics/__init__.py

@@ -2707,7 +2707,15 @@ class CfnWorkflow(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_omics.CfnWorkflow",
 ):
-    '''Creates a workflow.
+    '''Creates a private workflow.Private workflows depend on a variety of resources that you create and configure before creating the workflow:.
+
+    - *Input data* : Input data for the workflow, stored in an S3 bucket or a AWS HealthOmics sequence store.
+    - *Workflow definition files* : Define your workflow in one or more workflow definition files, written in WDL, Nextflow, or CWL. The workflow definition specifies the inputs and outputs for runs that use the workflow. It also includes specifications for the runs and run tasks for your workflow, including compute and memory requirements.
+    - *Parameter template files* : Define run parameters using a parameter template file (written in JSON).
+    - *ECR container images* : Create one or more container images for the workflow. Store the images in a private ECR repository.
+    - (Optional) *Sentieon licenses* : Request a Sentieon license if you plan to use Sentieon software in a private workflow.
+
+    For more information, see `Creating private workflows in AWS HealthOmics <https://docs.aws.amazon.com/omics/latest/dev/workflows-setup.html>`_ in the AWS HealthOmics User Guide.
 
     :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-omics-workflow.html
     :cloudformationResource: AWS::Omics::Workflow

aws_cdk/aws_opensearchserverless/__init__.py

@@ -765,8 +765,8 @@ class CfnIndex(
         :param id: Construct identifier for this resource (unique in its scope).
         :param collection_endpoint: The endpoint for the collection.
         :param index_name: The name of the OpenSearch Serverless index.
-        :param mappings: Index Mappings.
-        :param settings: 
+        :param mappings: Index mappings for the OpenSearch Serverless index.
+        :param settings: Index settings for the OpenSearch Serverless index.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a029f2a84e6e81eb77a837c5b057c54ae69d5f1ddda222ff52881f5d0f352fea)
@@ -856,7 +856,7 @@ class CfnIndex(
     def mappings(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnIndex.MappingsProperty"]]:
-        '''Index Mappings.'''
+        '''Index mappings for the OpenSearch Serverless index.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnIndex.MappingsProperty"]], jsii.get(self, "mappings"))
 
     @mappings.setter
@@ -874,6 +874,7 @@ class CfnIndex(
     def settings(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnIndex.IndexSettingsProperty"]]:
+        '''Index settings for the OpenSearch Serverless index.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnIndex.IndexSettingsProperty"]], jsii.get(self, "settings"))
 
     @settings.setter
@@ -903,10 +904,11 @@ class CfnIndex(
             knn_algo_param_ef_search: typing.Optional[jsii.Number] = None,
             refresh_interval: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param knn: Enable/disable k-nearest neighbor search capability.
-            :param knn_algo_param_ef_search: Size of the dynamic list for the nearest neighbors.
-            :param refresh_interval: How often to perform refresh operation (e.g. '1s', '5s').
+            '''An OpenSearch Serverless index resource.
+
+            :param knn: Enable or disable k-nearest neighbor search capability.
+            :param knn_algo_param_ef_search: The size of the dynamic list for the nearest neighbors.
+            :param refresh_interval: How often to perform a refresh operation. For example, 1s or 5s.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-index.html
             :exampleMetadata: fixture=_generated
@@ -940,7 +942,7 @@ class CfnIndex(
         def knn(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''Enable/disable k-nearest neighbor search capability.
+            '''Enable or disable k-nearest neighbor search capability.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-index.html#cfn-opensearchserverless-index-index-knn
             '''
@@ -949,7 +951,7 @@ class CfnIndex(
 
         @builtins.property
         def knn_algo_param_ef_search(self) -> typing.Optional[jsii.Number]:
-            '''Size of the dynamic list for the nearest neighbors.
+            '''The size of the dynamic list for the nearest neighbors.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-index.html#cfn-opensearchserverless-index-index-knnalgoparamefsearch
             '''
@@ -958,7 +960,9 @@ class CfnIndex(
 
         @builtins.property
         def refresh_interval(self) -> typing.Optional[builtins.str]:
-            '''How often to perform refresh operation (e.g. '1s', '5s').
+            '''How often to perform a refresh operation.
+
+            For example, 1s or 5s.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-index.html#cfn-opensearchserverless-index-index-refreshinterval
             '''
@@ -987,8 +991,9 @@ class CfnIndex(
             *,
             index: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnIndex.IndexProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''
-            :param index: 
+            '''Index settings for the OpenSearch Serverless index.
+
+            :param index: Index settings.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-indexsettings.html
             :exampleMetadata: fixture=_generated
@@ -1018,7 +1023,8 @@ class CfnIndex(
         def index(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnIndex.IndexProperty"]]:
-            '''
+            '''Index settings.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-indexsettings.html#cfn-opensearchserverless-index-indexsettings-index
             '''
             result = self._values.get("index")
@@ -1046,9 +1052,9 @@ class CfnIndex(
             *,
             properties: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, typing.Union[_IResolvable_da3f097b, typing.Union["CfnIndex.PropertyMappingProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         ) -> None:
-            '''Index Mappings.
+            '''Index mappings for the OpenSearch Serverless index.
 
-            :param properties: Defines the fields within the mapping, including their types and configurations.
+            :param properties: Nested fields within an object or nested field type.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-mappings.html
             :exampleMetadata: fixture=_generated
@@ -1099,7 +1105,7 @@ class CfnIndex(
         def properties(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, typing.Union[_IResolvable_da3f097b, "CfnIndex.PropertyMappingProperty"]]]]:
-            '''Defines the fields within the mapping, including their types and configurations.
+            '''Nested fields within an object or nested field type.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-mappings.html#cfn-opensearchserverless-index-mappings-properties
             '''
@@ -1323,12 +1329,13 @@ class CfnIndex(
             properties: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, typing.Union[_IResolvable_da3f097b, typing.Union["CfnIndex.PropertyMappingProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
             value: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
+            '''Property mappings for the OpenSearch Serverless index.
+
             :param type: The field data type. Must be a valid OpenSearch field type.
             :param dimension: Dimension size for vector fields, defines the number of dimensions in the vector.
             :param index: Whether a field should be indexed.
             :param method: Configuration for k-NN search method.
-            :param properties: Nested fields within an object or nested field type.
+            :param properties: Defines the fields within the mapping, including their types and configurations.
             :param value: Default value for the field when not specified in a document.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-propertymapping.html
@@ -1434,7 +1441,7 @@ class CfnIndex(
         def properties(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Mapping[builtins.str, typing.Union[_IResolvable_da3f097b, "CfnIndex.PropertyMappingProperty"]]]]:
-            '''Nested fields within an object or nested field type.
+            '''Defines the fields within the mapping, including their types and configurations.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-opensearchserverless-index-propertymapping.html#cfn-opensearchserverless-index-propertymapping-properties
             '''
@@ -1485,8 +1492,8 @@ class CfnIndexProps:
 
         :param collection_endpoint: The endpoint for the collection.
         :param index_name: The name of the OpenSearch Serverless index.
-        :param mappings: Index Mappings.
-        :param settings: 
+        :param mappings: Index mappings for the OpenSearch Serverless index.
+        :param settings: Index settings for the OpenSearch Serverless index.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchserverless-index.html
         :exampleMetadata: fixture=_generated
@@ -1578,7 +1585,7 @@ class CfnIndexProps:
     def mappings(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnIndex.MappingsProperty]]:
-        '''Index Mappings.
+        '''Index mappings for the OpenSearch Serverless index.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchserverless-index.html#cfn-opensearchserverless-index-mappings
         '''
@@ -1589,7 +1596,8 @@ class CfnIndexProps:
     def settings(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnIndex.IndexSettingsProperty]]:
-        '''
+        '''Index settings for the OpenSearch Serverless index.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-opensearchserverless-index.html#cfn-opensearchserverless-index-settings
         '''
         result = self._values.get("settings")

aws_cdk/aws_organizations/__init__.py

@@ -103,7 +103,7 @@ class CfnAccount(
        - Email
        - RoleName
 
-       If you attempt to update the listed parameters, CloudFormation will attempt the update, but you will receive an error message as those updates are not supported from an Organizations management account or a `registered delegated administrator <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html>`_ account. Both the update and the update roll-back will fail, so you must skip the account resource update. To update parameters ``AccountName`` and ``Email`` , you must sign in to the AWS Management Console as the AWS account root user. For more information, see `Update the AWS account name, email address, or password for the root user <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-root-user.html>`_ in the *AWS Account Management Reference Guide* .
+       If you attempt to update the listed parameters, CloudFormation will attempt the update, but you will receive an error message as those updates are not supported from an Organizations management account or a `registered delegated administrator <https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacksets-orgs-delegated-admin.html>`_ account. Both the update and the update roll-back will fail, so you must skip the account resource update. To update parameters ``AccountName`` and ``Email`` , you must sign in to the AWS Management Console as the AWS account root user. For more information, see `Update the AWS account name, email address, or password for the root user <https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-root-user.html>`_ in the *Account Management Reference Guide* .
 
        - When you create an account in an organization using the AWS Organizations console, API, or AWS CLI commands, we don't automatically collect the information required for the account to operate as a standalone account. That includes collecting the payment method and signing the end user license agreement (EULA). If you must remove an account from your organization later, you can do so only after you provide the missing information. For more information, see `Considerations before removing an account from an organization <https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_account-before-remove.html>`_ in the *AWS Organizations User Guide* .
        - When you create an account in an organization using AWS CloudFormation , you can't specify a value for the ``CreateAccount`` operation parameter ``IamUserAccessToBilling`` . The default value for parameter ``IamUserAccessToBilling`` is ``ALLOW`` , and IAM users and roles with the required permissions can access billing information for the new account.

aws_cdk/aws_paymentcryptography/__init__.py

@@ -297,9 +297,13 @@ class CfnKey(
 
     In addition to the key material used in cryptographic operations, an AWS Payment Cryptography key includes metadata such as the key ARN, key usage, key origin, creation date, description, and key state.
 
-    When you create a key, you specify both immutable and mutable data about the key. The immutable data contains key attributes that define the scope and cryptographic operations that you can perform using the key, for example key class (example: ``SYMMETRIC_KEY`` ), key algorithm (example: ``TDES_2KEY`` ), key usage (example: ``TR31_P0_PIN_ENCRYPTION_KEY`` ) and key modes of use (example: ``Encrypt`` ). For information about valid combinations of key attributes, see `Understanding key attributes <https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html>`_ in the *AWS Payment Cryptography User Guide* . The mutable data contained within a key includes usage timestamp and key deletion timestamp and can be modified after creation.
+    When you create a key, you specify both immutable and mutable data about the key. The immutable data contains key attributes that define the scope and cryptographic operations that you can perform using the key, for example key class (example: ``SYMMETRIC_KEY`` ), key algorithm (example: ``TDES_2KEY`` ), key usage (example: ``TR31_P0_PIN_ENCRYPTION_KEY`` ) and key modes of use (example: ``Encrypt`` ). AWS Payment Cryptography binds key attributes to keys using key blocks when you store or export them. AWS Payment Cryptography stores the key contents wrapped and never stores or transmits them in the clear.
 
-    AWS Payment Cryptography binds key attributes to keys using key blocks when you store or export them. AWS Payment Cryptography stores the key contents wrapped and never stores or transmits them in the clear.
+    For information about valid combinations of key attributes, see `Understanding key attributes <https://docs.aws.amazon.com/payment-cryptography/latest/userguide/keys-validattributes.html>`_ in the *AWS Payment Cryptography User Guide* . The mutable data contained within a key includes usage timestamp and key deletion timestamp and can be modified after creation.
+
+    You can use the ``CreateKey`` operation to generate an ECC (Elliptic Curve Cryptography) key pair used for establishing an ECDH (Elliptic Curve Diffie-Hellman) key agreement between two parties. In the ECDH key agreement process, both parties generate their own ECC key pair with key usage K3 and exchange the public keys. Each party then use their private key, the received public key from the other party, and the key derivation parameters including key derivation function, hash algorithm, derivation data, and key algorithm to derive a shared key.
+
+    To maintain the single-use principle of cryptographic keys in payments, ECDH derived keys should not be used for multiple purposes, such as a ``TR31_P0_PIN_ENCRYPTION_KEY`` and ``TR31_K1_KEY_BLOCK_PROTECTION_KEY`` . When creating ECC key pairs in AWS Payment Cryptography you can optionally set the ``DeriveKeyUsage`` parameter, which defines the key usage bound to the symmetric key that will be derived using the ECC key pair.
 
     *Cross-account use* : This operation can't be used across different AWS accounts.
 

aws_cdk/aws_pcaconnectorad/__init__.py

@@ -274,7 +274,7 @@ class CfnConnector(
             '''Information about your VPC and security groups used with the connector.
 
             :param security_group_ids: The security groups used with the connector. You can use a maximum of 4 security groups with a connector.
-            :param ip_address_type: 
+            :param ip_address_type: The VPC IP address type.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pcaconnectorad-connector-vpcinformation.html
             :exampleMetadata: fixture=_generated
@@ -316,7 +316,8 @@ class CfnConnector(
 
         @builtins.property
         def ip_address_type(self) -> typing.Optional[builtins.str]:
-            '''
+            '''The VPC IP address type.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-pcaconnectorad-connector-vpcinformation.html#cfn-pcaconnectorad-connector-vpcinformation-ipaddresstype
             '''
             result = self._values.get("ip_address_type")

aws_cdk/aws_quicksight/__init__.py

@@ -142045,7 +142045,7 @@ class CfnDataSet(
         :param row_level_permission_data_set: The row-level security configuration for the data that you want to create.
         :param row_level_permission_tag_configuration: The element you can use to define tags for row-level security.
         :param tags: Contains a map of the key-value pairs for the resource tag or tags assigned to the dataset.
-        :param use_as: 
+        :param use_as: The usage of the dataset.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__72d075b7003c65fe0f5754c362b528fce8eccbf0c8bca521f7a3200fbe0f67f5)
@@ -142480,6 +142480,7 @@ class CfnDataSet(
     @builtins.property
     @jsii.member(jsii_name="useAs")
     def use_as(self) -> typing.Optional[builtins.str]:
+        '''The usage of the dataset.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "useAs"))
 
     @use_as.setter
@@ -143152,7 +143153,7 @@ class CfnDataSet(
         ) -> None:
             '''The refresh properties of a dataset.
 
-            :param failure_configuration: 
+            :param failure_configuration: The failure configuration for a dataset.
             :param refresh_configuration: The refresh configuration for a dataset.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-datasetrefreshproperties.html
@@ -143195,7 +143196,8 @@ class CfnDataSet(
         def failure_configuration(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshFailureConfigurationProperty"]]:
-            '''
+            '''The failure configuration for a dataset.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-datasetrefreshproperties.html#cfn-quicksight-dataset-datasetrefreshproperties-failureconfiguration
             '''
             result = self._values.get("failure_configuration")
@@ -145667,8 +145669,9 @@ class CfnDataSet(
             *,
             email_alert: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSet.RefreshFailureEmailAlertProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''
-            :param email_alert: 
+            '''The failure configuration of a dataset.
+
+            :param email_alert: The email alert configuration for a dataset refresh failure.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-refreshfailureconfiguration.html
             :exampleMetadata: fixture=_generated
@@ -145696,7 +145699,8 @@ class CfnDataSet(
         def email_alert(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnDataSet.RefreshFailureEmailAlertProperty"]]:
-            '''
+            '''The email alert configuration for a dataset refresh failure.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-refreshfailureconfiguration.html#cfn-quicksight-dataset-refreshfailureconfiguration-emailalert
             '''
             result = self._values.get("email_alert")
@@ -145724,8 +145728,9 @@ class CfnDataSet(
             *,
             alert_status: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param alert_status: 
+            '''The configuration settings for the email alerts that are sent when a dataset refresh fails.
+
+            :param alert_status: The status value that determines if email alerts are sent.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-refreshfailureemailalert.html
             :exampleMetadata: fixture=_generated
@@ -145749,7 +145754,8 @@ class CfnDataSet(
 
         @builtins.property
         def alert_status(self) -> typing.Optional[builtins.str]:
-            '''
+            '''The status value that determines if email alerts are sent.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-refreshfailureemailalert.html#cfn-quicksight-dataset-refreshfailureemailalert-alertstatus
             '''
             result = self._values.get("alert_status")
@@ -147140,12 +147146,13 @@ class CfnDataSet(
             start_from_row: typing.Optional[jsii.Number] = None,
             text_qualifier: typing.Optional[builtins.str] = None,
         ) -> None:
-            '''
-            :param contains_header: 
-            :param delimiter: 
-            :param format: 
-            :param start_from_row: 
-            :param text_qualifier: 
+            '''Information about the format for a source file or files.
+
+            :param contains_header: Whether the file has a header row, or the files each have a header row.
+            :param delimiter: The delimiter between values in the file.
+            :param format: File format.
+            :param start_from_row: A row number to start reading data from.
+            :param text_qualifier: Text qualifier.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html
             :exampleMetadata: fixture=_generated
@@ -147187,7 +147194,8 @@ class CfnDataSet(
         def contains_header(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''
+            '''Whether the file has a header row, or the files each have a header row.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-containsheader
             '''
             result = self._values.get("contains_header")
@@ -147195,7 +147203,8 @@ class CfnDataSet(
 
         @builtins.property
         def delimiter(self) -> typing.Optional[builtins.str]:
-            '''
+            '''The delimiter between values in the file.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-delimiter
             '''
             result = self._values.get("delimiter")
@@ -147203,7 +147212,8 @@ class CfnDataSet(
 
         @builtins.property
         def format(self) -> typing.Optional[builtins.str]:
-            '''
+            '''File format.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-format
             '''
             result = self._values.get("format")
@@ -147211,7 +147221,8 @@ class CfnDataSet(
 
         @builtins.property
         def start_from_row(self) -> typing.Optional[jsii.Number]:
-            '''
+            '''A row number to start reading data from.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-startfromrow
             '''
             result = self._values.get("start_from_row")
@@ -147219,7 +147230,8 @@ class CfnDataSet(
 
         @builtins.property
         def text_qualifier(self) -> typing.Optional[builtins.str]:
-            '''
+            '''Text qualifier.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-quicksight-dataset-uploadsettings.html#cfn-quicksight-dataset-uploadsettings-textqualifier
             '''
             result = self._values.get("text_qualifier")
@@ -147309,7 +147321,7 @@ class CfnDataSetProps:
         :param row_level_permission_data_set: The row-level security configuration for the data that you want to create.
         :param row_level_permission_tag_configuration: The element you can use to define tags for row-level security.
         :param tags: Contains a map of the key-value pairs for the resource tag or tags assigned to the dataset.
-        :param use_as: 
+        :param use_as: The usage of the dataset.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dataset.html
         :exampleMetadata: fixture=_generated
@@ -147852,7 +147864,8 @@ class CfnDataSetProps:
 
     @builtins.property
     def use_as(self) -> typing.Optional[builtins.str]:
-        '''
+        '''The usage of the dataset.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-quicksight-dataset.html#cfn-quicksight-dataset-useas
         '''
         result = self._values.get("use_as")