aws-cdk-lib 2.146.0__py3-none-any.whl → 2.147.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of aws-cdk-lib might be problematic. Click here for more details.
- aws_cdk/__init__.py +11 -12
- aws_cdk/_jsii/__init__.py +1 -1
- aws_cdk/_jsii/{aws-cdk-lib@2.146.0.jsii.tgz → aws-cdk-lib@2.147.1.jsii.tgz} +0 -0
- aws_cdk/aws_apigateway/__init__.py +32 -12
- aws_cdk/aws_apigatewayv2/__init__.py +48 -2
- aws_cdk/aws_apigatewayv2_integrations/__init__.py +142 -4
- aws_cdk/aws_appconfig/__init__.py +8 -4
- aws_cdk/aws_applicationsignals/__init__.py +1766 -0
- aws_cdk/aws_auditmanager/__init__.py +5 -1
- aws_cdk/aws_autoscaling/__init__.py +65 -20
- aws_cdk/aws_batch/__init__.py +215 -0
- aws_cdk/aws_bedrock/__init__.py +272 -103
- aws_cdk/aws_cloudformation/__init__.py +5 -11
- aws_cdk/aws_cloudfront/__init__.py +10 -3
- aws_cdk/aws_cloudtrail/__init__.py +56 -2
- aws_cdk/aws_codebuild/__init__.py +62 -29
- aws_cdk/aws_codepipeline/__init__.py +10 -5
- aws_cdk/aws_datazone/__init__.py +80 -68
- aws_cdk/aws_deadline/__init__.py +603 -17
- aws_cdk/aws_ec2/__init__.py +237 -112
- aws_cdk/aws_ecs/__init__.py +20 -18
- aws_cdk/aws_eks/__init__.py +15 -9
- aws_cdk/aws_elasticloadbalancingv2/__init__.py +11 -5
- aws_cdk/aws_emrserverless/__init__.py +5 -5
- aws_cdk/aws_events/__init__.py +36 -16
- aws_cdk/aws_fsx/__init__.py +126 -21
- aws_cdk/aws_globalaccelerator/__init__.py +2 -1
- aws_cdk/aws_globalaccelerator_endpoints/__init__.py +35 -4
- aws_cdk/aws_glue/__init__.py +26 -0
- aws_cdk/aws_grafana/__init__.py +4 -4
- aws_cdk/aws_groundstation/__init__.py +55 -35
- aws_cdk/aws_guardduty/__init__.py +826 -0
- aws_cdk/aws_iot/__init__.py +3 -3
- aws_cdk/aws_lambda/__init__.py +7 -5
- aws_cdk/aws_lightsail/__init__.py +1 -1
- aws_cdk/aws_location/__init__.py +10 -11
- aws_cdk/aws_mediapackagev2/__init__.py +38 -20
- aws_cdk/aws_mediatailor/__init__.py +2 -2
- aws_cdk/aws_msk/__init__.py +4 -4
- aws_cdk/aws_mwaa/__init__.py +16 -8
- aws_cdk/aws_nimblestudio/__init__.py +9 -9
- aws_cdk/aws_opensearchservice/__init__.py +5 -4
- aws_cdk/aws_opsworks/__init__.py +3 -3
- aws_cdk/aws_osis/__init__.py +33 -4
- aws_cdk/aws_pipes/__init__.py +97 -45
- aws_cdk/aws_quicksight/__init__.py +23 -21
- aws_cdk/aws_rds/__init__.py +43 -11
- aws_cdk/aws_refactorspaces/__init__.py +3 -3
- aws_cdk/aws_rolesanywhere/__init__.py +21 -14
- aws_cdk/aws_route53/__init__.py +3 -3
- aws_cdk/aws_sagemaker/__init__.py +5 -2
- aws_cdk/aws_securityhub/__init__.py +163 -78
- aws_cdk/aws_securitylake/__init__.py +7 -5
- aws_cdk/aws_ses/__init__.py +117 -0
- aws_cdk/aws_simspaceweaver/__init__.py +2 -2
- aws_cdk/aws_sns/__init__.py +6 -4
- aws_cdk/aws_sqs/__init__.py +3 -3
- aws_cdk/aws_stepfunctions/__init__.py +51 -28
- aws_cdk/aws_stepfunctions_tasks/__init__.py +56 -2
- aws_cdk/aws_transfer/__init__.py +8 -2
- aws_cdk/aws_wafv2/__init__.py +10 -10
- aws_cdk/aws_workspacesweb/__init__.py +8 -8
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/METADATA +1 -1
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/RECORD +68 -67
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/LICENSE +0 -0
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/NOTICE +0 -0
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/WHEEL +0 -0
- {aws_cdk_lib-2.146.0.dist-info → aws_cdk_lib-2.147.1.dist-info}/top_level.txt +0 -0
aws_cdk/aws_ecs/__init__.py
CHANGED
|
@@ -6462,7 +6462,7 @@ class CfnCluster(
|
|
|
6462
6462
|
:param capacity_providers: The short name of one or more capacity providers to associate with the cluster. A capacity provider must be associated with a cluster before it can be included as part of the default capacity provider strategy of the cluster or used in a capacity provider strategy when calling the `CreateService <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html>`_ or `RunTask <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html>`_ actions. If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must be created but not associated with another cluster. New Auto Scaling group capacity providers can be created with the `CreateCapacityProvider <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html>`_ API operation. To use a AWS Fargate capacity provider, specify either the ``FARGATE`` or ``FARGATE_SPOT`` capacity providers. The AWS Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used. The `PutCapacityProvider <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProvider.html>`_ API operation is used to update the list of available capacity providers for a cluster after the cluster is created.
|
|
6463
6463
|
:param cluster_name: A user-generated string that you use to identify your cluster. If you don't specify a name, AWS CloudFormation generates a unique physical ID for the name.
|
|
6464
6464
|
:param cluster_settings: The settings to use when creating a cluster. This parameter is used to turn on CloudWatch Container Insights for a cluster.
|
|
6465
|
-
:param configuration: The execute command configuration for the cluster.
|
|
6465
|
+
:param configuration: The execute command and managed storage configuration for the cluster.
|
|
6466
6466
|
:param default_capacity_provider_strategy: The default capacity provider strategy for the cluster. When services or tasks are run in the cluster with no launch type or capacity provider strategy specified, the default capacity provider strategy is used.
|
|
6467
6467
|
:param service_connect_defaults: Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the ``enabled`` parameter to ``true`` in the ``ServiceConnectConfiguration`` . You can set the namespace of each service individually in the ``ServiceConnectConfiguration`` to override this default parameter. Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see `Service Connect <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
6468
6468
|
:param tags: The metadata that you apply to the cluster to help you categorize and organize them. Each tag consists of a key and an optional value. You define both. The following basic restrictions apply to tags: - Maximum number of tags per resource - 50 - For each resource, each tag key must be unique, and each tag key can have only one value. - Maximum key length - 128 Unicode characters in UTF-8 - Maximum value length - 256 Unicode characters in UTF-8 - If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : /
|
|
@@ -6585,7 +6585,7 @@ class CfnCluster(
|
|
|
6585
6585
|
def configuration(
|
|
6586
6586
|
self,
|
|
6587
6587
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ClusterConfigurationProperty"]]:
|
|
6588
|
-
'''The execute command configuration for the cluster.'''
|
|
6588
|
+
'''The execute command and managed storage configuration for the cluster.'''
|
|
6589
6589
|
return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ClusterConfigurationProperty"]], jsii.get(self, "configuration"))
|
|
6590
6590
|
|
|
6591
6591
|
@configuration.setter
|
|
@@ -6761,10 +6761,10 @@ class CfnCluster(
|
|
|
6761
6761
|
execute_command_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.ExecuteCommandConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
6762
6762
|
managed_storage_configuration: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCluster.ManagedStorageConfigurationProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
|
|
6763
6763
|
) -> None:
|
|
6764
|
-
'''The execute command configuration for the cluster.
|
|
6764
|
+
'''The execute command and managed storage configuration for the cluster.
|
|
6765
6765
|
|
|
6766
6766
|
:param execute_command_configuration: The details of the execute command configuration.
|
|
6767
|
-
:param managed_storage_configuration:
|
|
6767
|
+
:param managed_storage_configuration: The details of the managed storage configuration.
|
|
6768
6768
|
|
|
6769
6769
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-clusterconfiguration.html
|
|
6770
6770
|
:exampleMetadata: fixture=_generated
|
|
@@ -6818,7 +6818,8 @@ class CfnCluster(
|
|
|
6818
6818
|
def managed_storage_configuration(
|
|
6819
6819
|
self,
|
|
6820
6820
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCluster.ManagedStorageConfigurationProperty"]]:
|
|
6821
|
-
'''
|
|
6821
|
+
'''The details of the managed storage configuration.
|
|
6822
|
+
|
|
6822
6823
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-clusterconfiguration.html#cfn-ecs-cluster-clusterconfiguration-managedstorageconfiguration
|
|
6823
6824
|
'''
|
|
6824
6825
|
result = self._values.get("managed_storage_configuration")
|
|
@@ -7168,9 +7169,10 @@ class CfnCluster(
|
|
|
7168
7169
|
fargate_ephemeral_storage_kms_key_id: typing.Optional[builtins.str] = None,
|
|
7169
7170
|
kms_key_id: typing.Optional[builtins.str] = None,
|
|
7170
7171
|
) -> None:
|
|
7171
|
-
'''
|
|
7172
|
-
|
|
7173
|
-
:param
|
|
7172
|
+
'''The managed storage configuration for the cluster.
|
|
7173
|
+
|
|
7174
|
+
:param fargate_ephemeral_storage_kms_key_id: Specify the AWS Key Management Service key ID for the Fargate ephemeral storage.
|
|
7175
|
+
:param kms_key_id: Specify a AWS Key Management Service key ID to encrypt the managed storage.
|
|
7174
7176
|
|
|
7175
7177
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-managedstorageconfiguration.html
|
|
7176
7178
|
:exampleMetadata: fixture=_generated
|
|
@@ -7198,7 +7200,8 @@ class CfnCluster(
|
|
|
7198
7200
|
|
|
7199
7201
|
@builtins.property
|
|
7200
7202
|
def fargate_ephemeral_storage_kms_key_id(self) -> typing.Optional[builtins.str]:
|
|
7201
|
-
'''
|
|
7203
|
+
'''Specify the AWS Key Management Service key ID for the Fargate ephemeral storage.
|
|
7204
|
+
|
|
7202
7205
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-managedstorageconfiguration.html#cfn-ecs-cluster-managedstorageconfiguration-fargateephemeralstoragekmskeyid
|
|
7203
7206
|
'''
|
|
7204
7207
|
result = self._values.get("fargate_ephemeral_storage_kms_key_id")
|
|
@@ -7206,7 +7209,8 @@ class CfnCluster(
|
|
|
7206
7209
|
|
|
7207
7210
|
@builtins.property
|
|
7208
7211
|
def kms_key_id(self) -> typing.Optional[builtins.str]:
|
|
7209
|
-
'''
|
|
7212
|
+
'''Specify a AWS Key Management Service key ID to encrypt the managed storage.
|
|
7213
|
+
|
|
7210
7214
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-cluster-managedstorageconfiguration.html#cfn-ecs-cluster-managedstorageconfiguration-kmskeyid
|
|
7211
7215
|
'''
|
|
7212
7216
|
result = self._values.get("kms_key_id")
|
|
@@ -7659,7 +7663,7 @@ class CfnClusterProps:
|
|
|
7659
7663
|
:param capacity_providers: The short name of one or more capacity providers to associate with the cluster. A capacity provider must be associated with a cluster before it can be included as part of the default capacity provider strategy of the cluster or used in a capacity provider strategy when calling the `CreateService <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateService.html>`_ or `RunTask <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_RunTask.html>`_ actions. If specifying a capacity provider that uses an Auto Scaling group, the capacity provider must be created but not associated with another cluster. New Auto Scaling group capacity providers can be created with the `CreateCapacityProvider <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_CreateCapacityProvider.html>`_ API operation. To use a AWS Fargate capacity provider, specify either the ``FARGATE`` or ``FARGATE_SPOT`` capacity providers. The AWS Fargate capacity providers are available to all accounts and only need to be associated with a cluster to be used. The `PutCapacityProvider <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_PutCapacityProvider.html>`_ API operation is used to update the list of available capacity providers for a cluster after the cluster is created.
|
|
7660
7664
|
:param cluster_name: A user-generated string that you use to identify your cluster. If you don't specify a name, AWS CloudFormation generates a unique physical ID for the name.
|
|
7661
7665
|
:param cluster_settings: The settings to use when creating a cluster. This parameter is used to turn on CloudWatch Container Insights for a cluster.
|
|
7662
|
-
:param configuration: The execute command configuration for the cluster.
|
|
7666
|
+
:param configuration: The execute command and managed storage configuration for the cluster.
|
|
7663
7667
|
:param default_capacity_provider_strategy: The default capacity provider strategy for the cluster. When services or tasks are run in the cluster with no launch type or capacity provider strategy specified, the default capacity provider strategy is used.
|
|
7664
7668
|
:param service_connect_defaults: Use this parameter to set a default Service Connect namespace. After you set a default Service Connect namespace, any new services with Service Connect turned on that are created in the cluster are added as client services in the namespace. This setting only applies to new services that set the ``enabled`` parameter to ``true`` in the ``ServiceConnectConfiguration`` . You can set the namespace of each service individually in the ``ServiceConnectConfiguration`` to override this default parameter. Tasks that run in a namespace can use short names to connect to services in the namespace. Tasks can connect to services across all of the clusters in the namespace. Tasks connect through a managed proxy container that collects logs and metrics for increased visibility. Only the tasks that Amazon ECS services create are supported with Service Connect. For more information, see `Service Connect <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/service-connect.html>`_ in the *Amazon Elastic Container Service Developer Guide* .
|
|
7665
7669
|
:param tags: The metadata that you apply to the cluster to help you categorize and organize them. Each tag consists of a key and an optional value. You define both. The following basic restrictions apply to tags: - Maximum number of tags per resource - 50 - For each resource, each tag key must be unique, and each tag key can have only one value. - Maximum key length - 128 Unicode characters in UTF-8 - Maximum value length - 256 Unicode characters in UTF-8 - If your tagging schema is used across multiple services and resources, remember that other services may have restrictions on allowed characters. Generally allowed characters are: letters, numbers, and spaces representable in UTF-8, and the following characters: + - = . _ : /
|
|
@@ -7781,7 +7785,7 @@ class CfnClusterProps:
|
|
|
7781
7785
|
def configuration(
|
|
7782
7786
|
self,
|
|
7783
7787
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCluster.ClusterConfigurationProperty]]:
|
|
7784
|
-
'''The execute command configuration for the cluster.
|
|
7788
|
+
'''The execute command and managed storage configuration for the cluster.
|
|
7785
7789
|
|
|
7786
7790
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ecs-cluster.html#cfn-ecs-cluster-configuration
|
|
7787
7791
|
'''
|
|
@@ -15753,8 +15757,8 @@ class CfnTaskDefinition(
|
|
|
15753
15757
|
|
|
15754
15758
|
The supported resource types are GPUs and Elastic Inference accelerators. For more information, see `Working with GPUs on Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-gpu.html>`_ or `Working with Amazon Elastic Inference on Amazon ECS <https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-inference.html>`_ in the *Amazon Elastic Container Service Developer Guide*
|
|
15755
15759
|
|
|
15756
|
-
:param type: The type of resource to assign to a container.
|
|
15757
|
-
:param value: The value for the specified resource type.
|
|
15760
|
+
:param type: The type of resource to assign to a container.
|
|
15761
|
+
:param value: The value for the specified resource type. When the type is ``GPU`` , the value is the number of physical ``GPUs`` the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on. When the type is ``InferenceAccelerator`` , the ``value`` matches the ``deviceName`` for an `InferenceAccelerator <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html>`_ specified in a task definition.
|
|
15758
15762
|
|
|
15759
15763
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-resourcerequirement.html
|
|
15760
15764
|
:exampleMetadata: fixture=_generated
|
|
@@ -15783,8 +15787,6 @@ class CfnTaskDefinition(
|
|
|
15783
15787
|
def type(self) -> builtins.str:
|
|
15784
15788
|
'''The type of resource to assign to a container.
|
|
15785
15789
|
|
|
15786
|
-
The supported values are ``GPU`` or ``InferenceAccelerator`` .
|
|
15787
|
-
|
|
15788
15790
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-resourcerequirement.html#cfn-ecs-taskdefinition-resourcerequirement-type
|
|
15789
15791
|
'''
|
|
15790
15792
|
result = self._values.get("type")
|
|
@@ -15795,9 +15797,9 @@ class CfnTaskDefinition(
|
|
|
15795
15797
|
def value(self) -> builtins.str:
|
|
15796
15798
|
'''The value for the specified resource type.
|
|
15797
15799
|
|
|
15798
|
-
|
|
15800
|
+
When the type is ``GPU`` , the value is the number of physical ``GPUs`` the Amazon ECS container agent reserves for the container. The number of GPUs that's reserved for all containers in a task can't exceed the number of available GPUs on the container instance that the task is launched on.
|
|
15799
15801
|
|
|
15800
|
-
|
|
15802
|
+
When the type is ``InferenceAccelerator`` , the ``value`` matches the ``deviceName`` for an `InferenceAccelerator <https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_InferenceAccelerator.html>`_ specified in a task definition.
|
|
15801
15803
|
|
|
15802
15804
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ecs-taskdefinition-resourcerequirement.html#cfn-ecs-taskdefinition-resourcerequirement-value
|
|
15803
15805
|
'''
|
aws_cdk/aws_eks/__init__.py
CHANGED
|
@@ -4965,7 +4965,7 @@ class CfnAddon(
|
|
|
4965
4965
|
:param cluster_name: The name of your cluster.
|
|
4966
4966
|
:param addon_version: The version of the add-on.
|
|
4967
4967
|
:param configuration_values: The configuration values that you provided.
|
|
4968
|
-
:param pod_identity_associations: An array of
|
|
4968
|
+
:param pod_identity_associations: An array of Pod Identity Assocations owned by the Addon. Each EKS Pod Identity association maps a role to a service account in a namespace in the cluster. For more information, see `Attach an IAM Role to an Amazon EKS add-on using Pod Identity <https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html>`_ in the EKS User Guide.
|
|
4969
4969
|
:param preserve_on_delete: Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed.
|
|
4970
4970
|
:param resolve_conflicts: How to resolve field value conflicts for an Amazon EKS add-on. Conflicts are handled based on the value you choose: - *None* – If the self-managed version of the add-on is installed on your cluster, Amazon EKS doesn't change the value. Creation of the add-on might fail. - *Overwrite* – If the self-managed version of the add-on is installed on your cluster and the Amazon EKS default value is different than the existing value, Amazon EKS changes the value to the Amazon EKS default value. - *Preserve* – This is similar to the NONE option. If the self-managed version of the add-on is installed on your cluster Amazon EKS doesn't change the add-on resource properties. Creation of the add-on might fail if conflicts are detected. This option works differently during the update operation. For more information, see `UpdateAddon <https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateAddon.html>`_ . If you don't currently have the self-managed version of the add-on installed on your cluster, the Amazon EKS add-on is installed. Amazon EKS sets all values to default values, regardless of the option that you specify.
|
|
4971
4971
|
:param service_account_role_arn: The Amazon Resource Name (ARN) of an existing IAM role to bind to the add-on's service account. The role must be assigned the IAM permissions required by the add-on. If you don't specify an existing IAM role, then the add-on uses the permissions assigned to the node IAM role. For more information, see `Amazon EKS node IAM role <https://docs.aws.amazon.com/eks/latest/userguide/create-node-role.html>`_ in the *Amazon EKS User Guide* . .. epigraph:: To specify an existing IAM role, you must have an IAM OpenID Connect (OIDC) provider created for your cluster. For more information, see `Enabling IAM roles for service accounts on your cluster <https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html>`_ in the *Amazon EKS User Guide* .
|
|
@@ -5096,7 +5096,7 @@ class CfnAddon(
|
|
|
5096
5096
|
def pod_identity_associations(
|
|
5097
5097
|
self,
|
|
5098
5098
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnAddon.PodIdentityAssociationProperty"]]]]:
|
|
5099
|
-
'''An array of
|
|
5099
|
+
'''An array of Pod Identity Assocations owned by the Addon.'''
|
|
5100
5100
|
return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnAddon.PodIdentityAssociationProperty"]]]], jsii.get(self, "podIdentityAssociations"))
|
|
5101
5101
|
|
|
5102
5102
|
@pod_identity_associations.setter
|
|
@@ -5178,10 +5178,10 @@ class CfnAddon(
|
|
|
5178
5178
|
role_arn: builtins.str,
|
|
5179
5179
|
service_account: builtins.str,
|
|
5180
5180
|
) -> None:
|
|
5181
|
-
'''
|
|
5181
|
+
'''Amazon EKS Pod Identity associations provide the ability to manage credentials for your applications, similar to the way that Amazon EC2 instance profiles provide credentials to Amazon EC2 instances.
|
|
5182
5182
|
|
|
5183
|
-
:param role_arn: The IAM role
|
|
5184
|
-
:param service_account: The Kubernetes service account
|
|
5183
|
+
:param role_arn: The Amazon Resource Name (ARN) of the IAM role to associate with the service account. The EKS Pod Identity agent manages credentials to assume this role for applications in the containers in the pods that use this service account.
|
|
5184
|
+
:param service_account: The name of the Kubernetes service account inside the cluster to associate the IAM credentials with.
|
|
5185
5185
|
|
|
5186
5186
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-eks-addon-podidentityassociation.html
|
|
5187
5187
|
:exampleMetadata: fixture=_generated
|
|
@@ -5208,7 +5208,9 @@ class CfnAddon(
|
|
|
5208
5208
|
|
|
5209
5209
|
@builtins.property
|
|
5210
5210
|
def role_arn(self) -> builtins.str:
|
|
5211
|
-
'''The
|
|
5211
|
+
'''The Amazon Resource Name (ARN) of the IAM role to associate with the service account.
|
|
5212
|
+
|
|
5213
|
+
The EKS Pod Identity agent manages credentials to assume this role for applications in the containers in the pods that use this service account.
|
|
5212
5214
|
|
|
5213
5215
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-eks-addon-podidentityassociation.html#cfn-eks-addon-podidentityassociation-rolearn
|
|
5214
5216
|
'''
|
|
@@ -5218,7 +5220,7 @@ class CfnAddon(
|
|
|
5218
5220
|
|
|
5219
5221
|
@builtins.property
|
|
5220
5222
|
def service_account(self) -> builtins.str:
|
|
5221
|
-
'''The Kubernetes service account
|
|
5223
|
+
'''The name of the Kubernetes service account inside the cluster to associate the IAM credentials with.
|
|
5222
5224
|
|
|
5223
5225
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-eks-addon-podidentityassociation.html#cfn-eks-addon-podidentityassociation-serviceaccount
|
|
5224
5226
|
'''
|
|
@@ -5273,7 +5275,7 @@ class CfnAddonProps:
|
|
|
5273
5275
|
:param cluster_name: The name of your cluster.
|
|
5274
5276
|
:param addon_version: The version of the add-on.
|
|
5275
5277
|
:param configuration_values: The configuration values that you provided.
|
|
5276
|
-
:param pod_identity_associations: An array of
|
|
5278
|
+
:param pod_identity_associations: An array of Pod Identity Assocations owned by the Addon. Each EKS Pod Identity association maps a role to a service account in a namespace in the cluster. For more information, see `Attach an IAM Role to an Amazon EKS add-on using Pod Identity <https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html>`_ in the EKS User Guide.
|
|
5277
5279
|
:param preserve_on_delete: Specifying this option preserves the add-on software on your cluster but Amazon EKS stops managing any settings for the add-on. If an IAM account is associated with the add-on, it isn't removed.
|
|
5278
5280
|
:param resolve_conflicts: How to resolve field value conflicts for an Amazon EKS add-on. Conflicts are handled based on the value you choose: - *None* – If the self-managed version of the add-on is installed on your cluster, Amazon EKS doesn't change the value. Creation of the add-on might fail. - *Overwrite* – If the self-managed version of the add-on is installed on your cluster and the Amazon EKS default value is different than the existing value, Amazon EKS changes the value to the Amazon EKS default value. - *Preserve* – This is similar to the NONE option. If the self-managed version of the add-on is installed on your cluster Amazon EKS doesn't change the add-on resource properties. Creation of the add-on might fail if conflicts are detected. This option works differently during the update operation. For more information, see `UpdateAddon <https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateAddon.html>`_ . If you don't currently have the self-managed version of the add-on installed on your cluster, the Amazon EKS add-on is installed. Amazon EKS sets all values to default values, regardless of the option that you specify.
|
|
5279
5281
|
:param service_account_role_arn: The Amazon Resource Name (ARN) of an existing IAM role to bind to the add-on's service account. The role must be assigned the IAM permissions required by the add-on. If you don't specify an existing IAM role, then the add-on uses the permissions assigned to the node IAM role. For more information, see `Amazon EKS node IAM role <https://docs.aws.amazon.com/eks/latest/userguide/create-node-role.html>`_ in the *Amazon EKS User Guide* . .. epigraph:: To specify an existing IAM role, you must have an IAM OpenID Connect (OIDC) provider created for your cluster. For more information, see `Enabling IAM roles for service accounts on your cluster <https://docs.aws.amazon.com/eks/latest/userguide/enable-iam-roles-for-service-accounts.html>`_ in the *Amazon EKS User Guide* .
|
|
@@ -5380,7 +5382,11 @@ class CfnAddonProps:
|
|
|
5380
5382
|
def pod_identity_associations(
|
|
5381
5383
|
self,
|
|
5382
5384
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnAddon.PodIdentityAssociationProperty]]]]:
|
|
5383
|
-
'''An array of
|
|
5385
|
+
'''An array of Pod Identity Assocations owned by the Addon.
|
|
5386
|
+
|
|
5387
|
+
Each EKS Pod Identity association maps a role to a service account in a namespace in the cluster.
|
|
5388
|
+
|
|
5389
|
+
For more information, see `Attach an IAM Role to an Amazon EKS add-on using Pod Identity <https://docs.aws.amazon.com/eks/latest/userguide/add-ons-iam.html>`_ in the EKS User Guide.
|
|
5384
5390
|
|
|
5385
5391
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-eks-addon.html#cfn-eks-addon-podidentityassociations
|
|
5386
5392
|
'''
|
|
@@ -7833,7 +7833,7 @@ class CfnLoadBalancer(
|
|
|
7833
7833
|
:param scope: Scope in which this resource is defined.
|
|
7834
7834
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
7835
7835
|
:param enforce_security_group_inbound_rules_on_private_link_traffic: Indicates whether to evaluate inbound security group rules for traffic sent to a Network Load Balancer through AWS PrivateLink .
|
|
7836
|
-
:param ip_address_type: The IP address type. The possible values are ``ipv4`` (for IPv4 addresses) and ``dualstack`` (for IPv4 and IPv6 addresses). You can’t specify ``dualstack`` for a load balancer with a UDP or TCP_UDP listener.
|
|
7836
|
+
:param ip_address_type: Note: Internal load balancers must use the ``ipv4`` IP address type. [Application Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses), ``dualstack`` (for IPv4 and IPv6 addresses), and ``dualstack-without-public-ipv4`` (for IPv6 only public addresses, with private IPv4 and IPv6 addresses). Note: Application Load Balancer authentication only supports IPv4 addresses when connecting to an Identity Provider (IdP) or Amazon Cognito endpoint. Without a public IPv4 address the load balancer cannot complete the authentication process, resulting in HTTP 500 errors. [Network Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses) and ``dualstack`` (for IPv4 and IPv6 addresses). You can’t specify ``dualstack`` for a load balancer with a UDP or TCP_UDP listener. [Gateway Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses) and ``dualstack`` (for IPv4 and IPv6 addresses).
|
|
7837
7837
|
:param load_balancer_attributes: The load balancer attributes.
|
|
7838
7838
|
:param name: The name of the load balancer. This name must be unique per region per account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, must not begin or end with a hyphen, and must not begin with "internal-". If you don't specify a name, AWS CloudFormation generates a unique physical ID for the load balancer. If you specify a name, you cannot perform updates that require replacement of this resource, but you can perform other updates. To replace the resource, specify a new name.
|
|
7839
7839
|
:param scheme: The nodes of an Internet-facing load balancer have public IP addresses. The DNS name of an Internet-facing load balancer is publicly resolvable to the public IP addresses of the nodes. Therefore, Internet-facing load balancers can route requests from clients over the internet. The nodes of an internal load balancer have only private IP addresses. The DNS name of an internal load balancer is publicly resolvable to the private IP addresses of the nodes. Therefore, internal load balancers can route requests only from clients with access to the VPC for the load balancer. The default is an Internet-facing load balancer. You cannot specify a scheme for a Gateway Load Balancer.
|
|
@@ -7986,7 +7986,7 @@ class CfnLoadBalancer(
|
|
|
7986
7986
|
@builtins.property
|
|
7987
7987
|
@jsii.member(jsii_name="ipAddressType")
|
|
7988
7988
|
def ip_address_type(self) -> typing.Optional[builtins.str]:
|
|
7989
|
-
'''
|
|
7989
|
+
'''Note: Internal load balancers must use the ``ipv4`` IP address type.'''
|
|
7990
7990
|
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "ipAddressType"))
|
|
7991
7991
|
|
|
7992
7992
|
@ip_address_type.setter
|
|
@@ -8361,7 +8361,7 @@ class CfnLoadBalancerProps:
|
|
|
8361
8361
|
'''Properties for defining a ``CfnLoadBalancer``.
|
|
8362
8362
|
|
|
8363
8363
|
:param enforce_security_group_inbound_rules_on_private_link_traffic: Indicates whether to evaluate inbound security group rules for traffic sent to a Network Load Balancer through AWS PrivateLink .
|
|
8364
|
-
:param ip_address_type: The IP address type. The possible values are ``ipv4`` (for IPv4 addresses) and ``dualstack`` (for IPv4 and IPv6 addresses). You can’t specify ``dualstack`` for a load balancer with a UDP or TCP_UDP listener.
|
|
8364
|
+
:param ip_address_type: Note: Internal load balancers must use the ``ipv4`` IP address type. [Application Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses), ``dualstack`` (for IPv4 and IPv6 addresses), and ``dualstack-without-public-ipv4`` (for IPv6 only public addresses, with private IPv4 and IPv6 addresses). Note: Application Load Balancer authentication only supports IPv4 addresses when connecting to an Identity Provider (IdP) or Amazon Cognito endpoint. Without a public IPv4 address the load balancer cannot complete the authentication process, resulting in HTTP 500 errors. [Network Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses) and ``dualstack`` (for IPv4 and IPv6 addresses). You can’t specify ``dualstack`` for a load balancer with a UDP or TCP_UDP listener. [Gateway Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses) and ``dualstack`` (for IPv4 and IPv6 addresses).
|
|
8365
8365
|
:param load_balancer_attributes: The load balancer attributes.
|
|
8366
8366
|
:param name: The name of the load balancer. This name must be unique per region per account, can have a maximum of 32 characters, must contain only alphanumeric characters or hyphens, must not begin or end with a hyphen, and must not begin with "internal-". If you don't specify a name, AWS CloudFormation generates a unique physical ID for the load balancer. If you specify a name, you cannot perform updates that require replacement of this resource, but you can perform other updates. To replace the resource, specify a new name.
|
|
8367
8367
|
:param scheme: The nodes of an Internet-facing load balancer have public IP addresses. The DNS name of an Internet-facing load balancer is publicly resolvable to the public IP addresses of the nodes. Therefore, Internet-facing load balancers can route requests from clients over the internet. The nodes of an internal load balancer have only private IP addresses. The DNS name of an internal load balancer is publicly resolvable to the private IP addresses of the nodes. Therefore, internal load balancers can route requests only from clients with access to the VPC for the load balancer. The default is an Internet-facing load balancer. You cannot specify a scheme for a Gateway Load Balancer.
|
|
@@ -8453,9 +8453,15 @@ class CfnLoadBalancerProps:
|
|
|
8453
8453
|
|
|
8454
8454
|
@builtins.property
|
|
8455
8455
|
def ip_address_type(self) -> typing.Optional[builtins.str]:
|
|
8456
|
-
'''
|
|
8456
|
+
'''Note: Internal load balancers must use the ``ipv4`` IP address type.
|
|
8457
8457
|
|
|
8458
|
-
The possible values are ``ipv4`` (for IPv4 addresses)
|
|
8458
|
+
[Application Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses), ``dualstack`` (for IPv4 and IPv6 addresses), and ``dualstack-without-public-ipv4`` (for IPv6 only public addresses, with private IPv4 and IPv6 addresses).
|
|
8459
|
+
|
|
8460
|
+
Note: Application Load Balancer authentication only supports IPv4 addresses when connecting to an Identity Provider (IdP) or Amazon Cognito endpoint. Without a public IPv4 address the load balancer cannot complete the authentication process, resulting in HTTP 500 errors.
|
|
8461
|
+
|
|
8462
|
+
[Network Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses) and ``dualstack`` (for IPv4 and IPv6 addresses). You can’t specify ``dualstack`` for a load balancer with a UDP or TCP_UDP listener.
|
|
8463
|
+
|
|
8464
|
+
[Gateway Load Balancers] The IP address type. The possible values are ``ipv4`` (for only IPv4 addresses) and ``dualstack`` (for IPv4 and IPv6 addresses).
|
|
8459
8465
|
|
|
8460
8466
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-elasticloadbalancingv2-loadbalancer.html#cfn-elasticloadbalancingv2-loadbalancer-ipaddresstype
|
|
8461
8467
|
'''
|
|
@@ -672,10 +672,10 @@ class CfnApplication(
|
|
|
672
672
|
) -> None:
|
|
673
673
|
'''The Amazon CloudWatch configuration for monitoring logs.
|
|
674
674
|
|
|
675
|
-
You can configure your jobs to send log information to CloudWatch
|
|
675
|
+
You can configure your jobs to send log information to CloudWatch.
|
|
676
676
|
|
|
677
677
|
:param enabled: Enables CloudWatch logging. Default: - false
|
|
678
|
-
:param encryption_key_arn: The AWS Key Management Service (KMS) key ARN to encrypt the logs that you store in CloudWatch Logs
|
|
678
|
+
:param encryption_key_arn: The AWS Key Management Service (KMS) key ARN to encrypt the logs that you store in CloudWatch Logs.
|
|
679
679
|
:param log_group_name: The name of the log group in Amazon CloudWatch Logs where you want to publish your logs.
|
|
680
680
|
:param log_stream_name_prefix: Prefix for the CloudWatch log stream name.
|
|
681
681
|
:param log_type_map: The specific log-streams which need to be uploaded to CloudWatch.
|
|
@@ -734,7 +734,7 @@ class CfnApplication(
|
|
|
734
734
|
|
|
735
735
|
@builtins.property
|
|
736
736
|
def encryption_key_arn(self) -> typing.Optional[builtins.str]:
|
|
737
|
-
'''The AWS Key Management Service (KMS) key ARN to encrypt the logs that you store in CloudWatch Logs
|
|
737
|
+
'''The AWS Key Management Service (KMS) key ARN to encrypt the logs that you store in CloudWatch Logs.
|
|
738
738
|
|
|
739
739
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emrserverless-application-cloudwatchloggingconfiguration.html#cfn-emrserverless-application-cloudwatchloggingconfiguration-encryptionkeyarn
|
|
740
740
|
'''
|
|
@@ -1347,7 +1347,7 @@ class CfnApplication(
|
|
|
1347
1347
|
) -> None:
|
|
1348
1348
|
'''The configuration setting for monitoring.
|
|
1349
1349
|
|
|
1350
|
-
:param cloud_watch_logging_configuration: The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs to send log information to CloudWatch
|
|
1350
|
+
:param cloud_watch_logging_configuration: The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs to send log information to CloudWatch.
|
|
1351
1351
|
:param managed_persistence_monitoring_configuration: The managed log persistence configuration for a job run.
|
|
1352
1352
|
:param s3_monitoring_configuration: The Amazon S3 configuration for monitoring log publishing.
|
|
1353
1353
|
|
|
@@ -1400,7 +1400,7 @@ class CfnApplication(
|
|
|
1400
1400
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnApplication.CloudWatchLoggingConfigurationProperty"]]:
|
|
1401
1401
|
'''The Amazon CloudWatch configuration for monitoring logs.
|
|
1402
1402
|
|
|
1403
|
-
You can configure your jobs to send log information to CloudWatch
|
|
1403
|
+
You can configure your jobs to send log information to CloudWatch.
|
|
1404
1404
|
|
|
1405
1405
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-emrserverless-application-monitoringconfiguration.html#cfn-emrserverless-application-monitoringconfiguration-cloudwatchloggingconfiguration
|
|
1406
1406
|
'''
|
aws_cdk/aws_events/__init__.py
CHANGED
|
@@ -3453,10 +3453,10 @@ class CfnEventBus(
|
|
|
3453
3453
|
:param scope: Scope in which this resource is defined.
|
|
3454
3454
|
:param id: Construct identifier for this resource (unique in its scope).
|
|
3455
3455
|
:param name: The name of the new event bus. Custom event bus names can't contain the ``/`` character, but you can use the ``/`` character in partner event bus names. In addition, for partner event buses, the name must exactly match the name of the partner event source that this event bus is matched to. You can't use the name ``default`` for a custom event bus, as this name is already used for your account's default event bus.
|
|
3456
|
-
:param dead_letter_config:
|
|
3457
|
-
:param description: The
|
|
3456
|
+
:param dead_letter_config: Configuration details of the Amazon SQS queue for EventBridge to use as a dead-letter queue (DLQ). For more information, see `Using dead-letter queues to process undelivered events <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-event-delivery.html#eb-rule-dlq>`_ in the *EventBridge User Guide* .
|
|
3457
|
+
:param description: The event bus description.
|
|
3458
3458
|
:param event_source_name: If you are creating a partner event bus, this specifies the partner event source that the new event bus will be matched with.
|
|
3459
|
-
:param kms_key_identifier:
|
|
3459
|
+
:param kms_key_identifier: The identifier of the AWS KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt events on this event bus. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN. If you do not specify a customer managed key identifier, EventBridge uses an AWS owned key to encrypt events on the event bus. For more information, see `Managing keys <https://docs.aws.amazon.com/kms/latest/developerguide/getting-started.html>`_ in the *AWS Key Management Service Developer Guide* . .. epigraph:: Archives and schema discovery are not supported for event buses encrypted using a customer managed key. EventBridge returns an error if: - You call ``[CreateArchive](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateArchive.html)`` on an event bus set to use a customer managed key for encryption. - You call ``[CreateDiscoverer](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers.html#CreateDiscoverer)`` on an event bus set to use a customer managed key for encryption. - You call ``[UpdatedEventBus](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_UpdatedEventBus.html)`` to set a customer managed key on an event bus with an archives or schema discovery enabled. To enable archives or schema discovery on an event bus, choose to use an AWS owned key . For more information, see `Data encryption in EventBridge <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-encryption.html>`_ in the *Amazon EventBridge User Guide* .
|
|
3460
3460
|
:param policy: The permissions policy of the event bus, describing which other AWS accounts can write events to this event bus.
|
|
3461
3461
|
:param tags: Tags to associate with the event bus.
|
|
3462
3462
|
'''
|
|
@@ -3561,7 +3561,7 @@ class CfnEventBus(
|
|
|
3561
3561
|
def dead_letter_config(
|
|
3562
3562
|
self,
|
|
3563
3563
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventBus.DeadLetterConfigProperty"]]:
|
|
3564
|
-
'''
|
|
3564
|
+
'''Configuration details of the Amazon SQS queue for EventBridge to use as a dead-letter queue (DLQ).'''
|
|
3565
3565
|
return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnEventBus.DeadLetterConfigProperty"]], jsii.get(self, "deadLetterConfig"))
|
|
3566
3566
|
|
|
3567
3567
|
@dead_letter_config.setter
|
|
@@ -3577,7 +3577,7 @@ class CfnEventBus(
|
|
|
3577
3577
|
@builtins.property
|
|
3578
3578
|
@jsii.member(jsii_name="description")
|
|
3579
3579
|
def description(self) -> typing.Optional[builtins.str]:
|
|
3580
|
-
'''The
|
|
3580
|
+
'''The event bus description.'''
|
|
3581
3581
|
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "description"))
|
|
3582
3582
|
|
|
3583
3583
|
@description.setter
|
|
@@ -3603,7 +3603,7 @@ class CfnEventBus(
|
|
|
3603
3603
|
@builtins.property
|
|
3604
3604
|
@jsii.member(jsii_name="kmsKeyIdentifier")
|
|
3605
3605
|
def kms_key_identifier(self) -> typing.Optional[builtins.str]:
|
|
3606
|
-
'''
|
|
3606
|
+
'''The identifier of the AWS KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt events on this event bus.'''
|
|
3607
3607
|
return typing.cast(typing.Optional[builtins.str], jsii.get(self, "kmsKeyIdentifier"))
|
|
3608
3608
|
|
|
3609
3609
|
@kms_key_identifier.setter
|
|
@@ -3646,9 +3646,11 @@ class CfnEventBus(
|
|
|
3646
3646
|
)
|
|
3647
3647
|
class DeadLetterConfigProperty:
|
|
3648
3648
|
def __init__(self, *, arn: typing.Optional[builtins.str] = None) -> None:
|
|
3649
|
-
'''
|
|
3649
|
+
'''Configuration details of the Amazon SQS queue for EventBridge to use as a dead-letter queue (DLQ).
|
|
3650
|
+
|
|
3651
|
+
For more information, see `Using dead-letter queues to process undelivered events <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-event-delivery.html#eb-rule-dlq>`_ in the *EventBridge User Guide* .
|
|
3650
3652
|
|
|
3651
|
-
:param arn:
|
|
3653
|
+
:param arn: The ARN of the SQS queue specified as the target for the dead-letter queue.
|
|
3652
3654
|
|
|
3653
3655
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-eventbus-deadletterconfig.html
|
|
3654
3656
|
:exampleMetadata: fixture=_generated
|
|
@@ -3672,7 +3674,8 @@ class CfnEventBus(
|
|
|
3672
3674
|
|
|
3673
3675
|
@builtins.property
|
|
3674
3676
|
def arn(self) -> typing.Optional[builtins.str]:
|
|
3675
|
-
'''
|
|
3677
|
+
'''The ARN of the SQS queue specified as the target for the dead-letter queue.
|
|
3678
|
+
|
|
3676
3679
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-events-eventbus-deadletterconfig.html#cfn-events-eventbus-deadletterconfig-arn
|
|
3677
3680
|
'''
|
|
3678
3681
|
result = self._values.get("arn")
|
|
@@ -4191,10 +4194,10 @@ class CfnEventBusProps:
|
|
|
4191
4194
|
'''Properties for defining a ``CfnEventBus``.
|
|
4192
4195
|
|
|
4193
4196
|
:param name: The name of the new event bus. Custom event bus names can't contain the ``/`` character, but you can use the ``/`` character in partner event bus names. In addition, for partner event buses, the name must exactly match the name of the partner event source that this event bus is matched to. You can't use the name ``default`` for a custom event bus, as this name is already used for your account's default event bus.
|
|
4194
|
-
:param dead_letter_config:
|
|
4195
|
-
:param description: The
|
|
4197
|
+
:param dead_letter_config: Configuration details of the Amazon SQS queue for EventBridge to use as a dead-letter queue (DLQ). For more information, see `Using dead-letter queues to process undelivered events <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-event-delivery.html#eb-rule-dlq>`_ in the *EventBridge User Guide* .
|
|
4198
|
+
:param description: The event bus description.
|
|
4196
4199
|
:param event_source_name: If you are creating a partner event bus, this specifies the partner event source that the new event bus will be matched with.
|
|
4197
|
-
:param kms_key_identifier:
|
|
4200
|
+
:param kms_key_identifier: The identifier of the AWS KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt events on this event bus. The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN. If you do not specify a customer managed key identifier, EventBridge uses an AWS owned key to encrypt events on the event bus. For more information, see `Managing keys <https://docs.aws.amazon.com/kms/latest/developerguide/getting-started.html>`_ in the *AWS Key Management Service Developer Guide* . .. epigraph:: Archives and schema discovery are not supported for event buses encrypted using a customer managed key. EventBridge returns an error if: - You call ``[CreateArchive](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateArchive.html)`` on an event bus set to use a customer managed key for encryption. - You call ``[CreateDiscoverer](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers.html#CreateDiscoverer)`` on an event bus set to use a customer managed key for encryption. - You call ``[UpdatedEventBus](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_UpdatedEventBus.html)`` to set a customer managed key on an event bus with an archives or schema discovery enabled. To enable archives or schema discovery on an event bus, choose to use an AWS owned key . For more information, see `Data encryption in EventBridge <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-encryption.html>`_ in the *Amazon EventBridge User Guide* .
|
|
4198
4201
|
:param policy: The permissions policy of the event bus, describing which other AWS accounts can write events to this event bus.
|
|
4199
4202
|
:param tags: Tags to associate with the event bus.
|
|
4200
4203
|
|
|
@@ -4269,7 +4272,9 @@ class CfnEventBusProps:
|
|
|
4269
4272
|
def dead_letter_config(
|
|
4270
4273
|
self,
|
|
4271
4274
|
) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnEventBus.DeadLetterConfigProperty]]:
|
|
4272
|
-
'''
|
|
4275
|
+
'''Configuration details of the Amazon SQS queue for EventBridge to use as a dead-letter queue (DLQ).
|
|
4276
|
+
|
|
4277
|
+
For more information, see `Using dead-letter queues to process undelivered events <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-event-delivery.html#eb-rule-dlq>`_ in the *EventBridge User Guide* .
|
|
4273
4278
|
|
|
4274
4279
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html#cfn-events-eventbus-deadletterconfig
|
|
4275
4280
|
'''
|
|
@@ -4278,7 +4283,7 @@ class CfnEventBusProps:
|
|
|
4278
4283
|
|
|
4279
4284
|
@builtins.property
|
|
4280
4285
|
def description(self) -> typing.Optional[builtins.str]:
|
|
4281
|
-
'''The
|
|
4286
|
+
'''The event bus description.
|
|
4282
4287
|
|
|
4283
4288
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html#cfn-events-eventbus-description
|
|
4284
4289
|
'''
|
|
@@ -4296,7 +4301,22 @@ class CfnEventBusProps:
|
|
|
4296
4301
|
|
|
4297
4302
|
@builtins.property
|
|
4298
4303
|
def kms_key_identifier(self) -> typing.Optional[builtins.str]:
|
|
4299
|
-
'''
|
|
4304
|
+
'''The identifier of the AWS KMS customer managed key for EventBridge to use, if you choose to use a customer managed key to encrypt events on this event bus.
|
|
4305
|
+
|
|
4306
|
+
The identifier can be the key Amazon Resource Name (ARN), KeyId, key alias, or key alias ARN.
|
|
4307
|
+
|
|
4308
|
+
If you do not specify a customer managed key identifier, EventBridge uses an AWS owned key to encrypt events on the event bus.
|
|
4309
|
+
|
|
4310
|
+
For more information, see `Managing keys <https://docs.aws.amazon.com/kms/latest/developerguide/getting-started.html>`_ in the *AWS Key Management Service Developer Guide* .
|
|
4311
|
+
.. epigraph::
|
|
4312
|
+
|
|
4313
|
+
Archives and schema discovery are not supported for event buses encrypted using a customer managed key. EventBridge returns an error if:
|
|
4314
|
+
|
|
4315
|
+
- You call ``[CreateArchive](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_CreateArchive.html)`` on an event bus set to use a customer managed key for encryption.
|
|
4316
|
+
- You call ``[CreateDiscoverer](https://docs.aws.amazon.com/eventbridge/latest/schema-reference/v1-discoverers.html#CreateDiscoverer)`` on an event bus set to use a customer managed key for encryption.
|
|
4317
|
+
- You call ``[UpdatedEventBus](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_UpdatedEventBus.html)`` to set a customer managed key on an event bus with an archives or schema discovery enabled.
|
|
4318
|
+
|
|
4319
|
+
To enable archives or schema discovery on an event bus, choose to use an AWS owned key . For more information, see `Data encryption in EventBridge <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-encryption.html>`_ in the *Amazon EventBridge User Guide* .
|
|
4300
4320
|
|
|
4301
4321
|
:see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-events-eventbus.html#cfn-events-eventbus-kmskeyidentifier
|
|
4302
4322
|
'''
|
|
@@ -5192,7 +5212,7 @@ class CfnRule(
|
|
|
5192
5212
|
def __init__(self, *, arn: typing.Optional[builtins.str] = None) -> None:
|
|
5193
5213
|
'''Configuration details of the Amazon SQS queue for EventBridge to use as a dead-letter queue (DLQ).
|
|
5194
5214
|
|
|
5195
|
-
For more information, see `
|
|
5215
|
+
For more information, see `Using dead-letter queues to process undelivered events <https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rule-event-delivery.html#eb-rule-dlq>`_ in the *EventBridge User Guide* .
|
|
5196
5216
|
|
|
5197
5217
|
:param arn: The ARN of the SQS queue specified as the target for the dead-letter queue.
|
|
5198
5218
|
|