aws-cdk-lib 2.204.0__py3-none-any.whl → 2.205.0__py3-none-any.whl

aws_cdk/aws_sagemaker/__init__.py

@@ -6403,6 +6403,7 @@ class CfnDomain(
                     environment_id="environmentId",
                     project_id="projectId",
                     project_s3_path="projectS3Path",
+                    single_sign_on_application_arn="singleSignOnApplicationArn",
                     studio_web_portal_access="studioWebPortalAccess"
                 )
             ),
@@ -7801,6 +7802,7 @@ class CfnDomain(
                         environment_id="environmentId",
                         project_id="projectId",
                         project_s3_path="projectS3Path",
+                        single_sign_on_application_arn="singleSignOnApplicationArn",
                         studio_web_portal_access="studioWebPortalAccess"
                     )
                 )
@@ -9201,6 +9203,7 @@ class CfnDomain(
             "environment_id": "environmentId",
             "project_id": "projectId",
             "project_s3_path": "projectS3Path",
+            "single_sign_on_application_arn": "singleSignOnApplicationArn",
             "studio_web_portal_access": "studioWebPortalAccess",
         },
     )
@@ -9214,6 +9217,7 @@ class CfnDomain(
             environment_id: typing.Optional[builtins.str] = None,
             project_id: typing.Optional[builtins.str] = None,
             project_s3_path: typing.Optional[builtins.str] = None,
+            single_sign_on_application_arn: typing.Optional[builtins.str] = None,
             studio_web_portal_access: typing.Optional[builtins.str] = None,
         ) -> None:
             '''The settings that apply to an Amazon SageMaker AI domain when you use it in Amazon SageMaker Unified Studio.
@@ -9224,6 +9228,7 @@ class CfnDomain(
             :param environment_id: The ID of the environment that Amazon SageMaker Unified Studio associates with the domain.
             :param project_id: The ID of the Amazon SageMaker Unified Studio project that corresponds to the domain.
             :param project_s3_path: The location where Amazon S3 stores temporary execution data and other artifacts for the project that corresponds to the domain.
+            :param single_sign_on_application_arn: The ARN of the DataZone application managed by SageMaker Unified Studio in the AWS IAM Identity Center.
             :param studio_web_portal_access: Sets whether you can access the domain in Amazon SageMaker Studio:. - **ENABLED** - You can access the domain in Amazon SageMaker Studio. If you migrate the domain to Amazon SageMaker Unified Studio, you can access it in both studio interfaces. - **DISABLED** - You can't access the domain in Amazon SageMaker Studio. If you migrate the domain to Amazon SageMaker Unified Studio, you can access it only in that studio interface. To migrate a domain to Amazon SageMaker Unified Studio, you specify the UnifiedStudioSettings data type when you use the UpdateDomain action.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-domain-unifiedstudiosettings.html
@@ -9242,6 +9247,7 @@ class CfnDomain(
                     environment_id="environmentId",
                     project_id="projectId",
                     project_s3_path="projectS3Path",
+                    single_sign_on_application_arn="singleSignOnApplicationArn",
                     studio_web_portal_access="studioWebPortalAccess"
                 )
             '''
@@ -9253,6 +9259,7 @@ class CfnDomain(
                 check_type(argname="argument environment_id", value=environment_id, expected_type=type_hints["environment_id"])
                 check_type(argname="argument project_id", value=project_id, expected_type=type_hints["project_id"])
                 check_type(argname="argument project_s3_path", value=project_s3_path, expected_type=type_hints["project_s3_path"])
+                check_type(argname="argument single_sign_on_application_arn", value=single_sign_on_application_arn, expected_type=type_hints["single_sign_on_application_arn"])
                 check_type(argname="argument studio_web_portal_access", value=studio_web_portal_access, expected_type=type_hints["studio_web_portal_access"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
             if domain_account_id is not None:
@@ -9267,6 +9274,8 @@ class CfnDomain(
                 self._values["project_id"] = project_id
             if project_s3_path is not None:
                 self._values["project_s3_path"] = project_s3_path
+            if single_sign_on_application_arn is not None:
+                self._values["single_sign_on_application_arn"] = single_sign_on_application_arn
             if studio_web_portal_access is not None:
                 self._values["studio_web_portal_access"] = studio_web_portal_access
 
@@ -9328,6 +9337,15 @@ class CfnDomain(
             result = self._values.get("project_s3_path")
             return typing.cast(typing.Optional[builtins.str], result)
 
+        @builtins.property
+        def single_sign_on_application_arn(self) -> typing.Optional[builtins.str]:
+            '''The ARN of the DataZone application managed by SageMaker Unified Studio in the AWS IAM Identity Center.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-sagemaker-domain-unifiedstudiosettings.html#cfn-sagemaker-domain-unifiedstudiosettings-singlesignonapplicationarn
+            '''
+            result = self._values.get("single_sign_on_application_arn")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         @builtins.property
         def studio_web_portal_access(self) -> typing.Optional[builtins.str]:
             '''Sets whether you can access the domain in Amazon SageMaker Studio:.
@@ -10159,6 +10177,7 @@ class CfnDomainProps:
                         environment_id="environmentId",
                         project_id="projectId",
                         project_s3_path="projectS3Path",
+                        single_sign_on_application_arn="singleSignOnApplicationArn",
                         studio_web_portal_access="studioWebPortalAccess"
                     )
                 ),
@@ -51522,6 +51541,7 @@ def _typecheckingstub__b4dad77d25b548827f5bcfd63cb5788816c5db5845110e1912053632c
     environment_id: typing.Optional[builtins.str] = None,
     project_id: typing.Optional[builtins.str] = None,
     project_s3_path: typing.Optional[builtins.str] = None,
+    single_sign_on_application_arn: typing.Optional[builtins.str] = None,
     studio_web_portal_access: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""

aws_cdk/aws_synthetics/__init__.py

@@ -88,6 +88,28 @@ schedule = synthetics.Schedule.cron(
 
 If you want the canary to run just once upon deployment, you can use `Schedule.once()`.
 
+### Automatic Retries
+
+You can configure the canary to automatically retry failed runs by using the `maxRetries` property.
+
+This is only supported on the following runtimes or newer: `Runtime.SYNTHETICS_NODEJS_PUPPETEER_10_0`, `Runtime.SYNTHETICS_NODEJS_PLAYWRIGHT_2_0`, `Runtime.SYNTHETICS_PYTHON_SELENIUM_5_1`.
+
+Max retries can be set between 0 and 2. Canaries which time out after 10 minutes are automatically limited to one retry.
+
+For more information, see [Configuring your canary to retry automatically](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_autoretry.html).
+
+```python
+canary = synthetics.Canary(self, "MyCanary",
+    schedule=synthetics.Schedule.rate(Duration.minutes(5)),
+    test=synthetics.Test.custom(
+        handler="canary.handler",
+        code=synthetics.Code.from_asset(path.join(__dirname, "canaries"))
+    ),
+    runtime=synthetics.Runtime.SYNTHETICS_PYTHON_SELENIUM_5_1,
+    max_retries=2
+)
+```
+
 ### Active Tracing
 
 You can choose to enable active AWS X-Ray tracing on canaries that use the `syn-nodejs-2.0` or later runtime by setting `activeTracing` to `true`.
@@ -372,6 +394,24 @@ canary = synthetics.Canary(self, "MyCanary",
     artifact_s3_kms_key=key
 )
 ```
+
+### Tag replication
+
+You can configure a canary to replicate its tags to the underlying Lambda function. This is useful when you want the same tags that are applied to the canary to also be applied to the Lambda function that the canary uses.
+
+```python
+canary = synthetics.Canary(self, "MyCanary",
+    schedule=synthetics.Schedule.rate(Duration.minutes(5)),
+    test=synthetics.Test.custom(
+        code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
+        handler="index.handler"
+    ),
+    runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_7_0,
+    resources_to_replicate_tags=[synthetics.ResourceToReplicateTags.LAMBDA_FUNCTION]
+)
+```
+
+When you specify `ResourceToReplicateTags.LAMBDA_FUNCTION` in the `resourcesToReplicateTags` property, CloudWatch Synthetics will keep the tags of the canary and the Lambda function synchronized. Any future changes you make to the canary's tags will also be applied to the function.
 '''
 from pkgutil import extend_path
 __path__ = extend_path(__path__, __name__)
@@ -568,17 +608,14 @@ class Canary(
 
     Example::
 
-        import aws_cdk as cdk
-        
-        
         canary = synthetics.Canary(self, "MyCanary",
             schedule=synthetics.Schedule.rate(Duration.minutes(5)),
             test=synthetics.Test.custom(
                 code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
                 handler="index.handler"
             ),
-            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_6_2,
-            memory=cdk.Size.mebibytes(1024)
+            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_7_0,
+            resources_to_replicate_tags=[synthetics.ResourceToReplicateTags.LAMBDA_FUNCTION]
         )
     '''
 
@@ -599,8 +636,10 @@ class Canary(
         dry_run_and_update: typing.Optional[builtins.bool] = None,
         environment_variables: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
         failure_retention_period: typing.Optional[_Duration_4839e8c3] = None,
+        max_retries: typing.Optional[jsii.Number] = None,
         memory: typing.Optional[_Size_7b441c34] = None,
         provisioned_resource_cleanup: typing.Optional[builtins.bool] = None,
+        resources_to_replicate_tags: typing.Optional[typing.Sequence["ResourceToReplicateTags"]] = None,
         role: typing.Optional[_IRole_235f5d8e] = None,
         schedule: typing.Optional["Schedule"] = None,
         security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
@@ -623,11 +662,13 @@ class Canary(
         :param artifacts_bucket_location: The s3 location that stores the data of the canary runs. Default: - A new s3 bucket will be created without a prefix.
         :param canary_name: The name of the canary. Be sure to give it a descriptive name that distinguishes it from other canaries in your account. Do not include secrets or proprietary information in your canary name. The canary name makes up part of the canary ARN, which is included in outbound calls over the internet. Default: - A unique name will be generated from the construct ID
         :param cleanup: (deprecated) Specify the underlying resources to be cleaned up when the canary is deleted. Using ``Cleanup.LAMBDA`` will create a Custom Resource to achieve this. Default: Cleanup.NOTHING
-        :param dry_run_and_update: Specifies whether to perform a dry run before updating the canary. If set to true, CDK will execute a dry run to validate the changes before applying them to the canary. If the dry run succeeds, the canary will be updated with the changes. If the dry run fails, the CloudFormation deployment will fail with the dry run’s failure reason. If set to false or omitted, the canary will be updated directly without first performing a dry run. Default: undefined - AWS CloudWatch default is false
+        :param dry_run_and_update: Specifies whether to perform a dry run before updating the canary. If set to true, CDK will execute a dry run to validate the changes before applying them to the canary. If the dry run succeeds, the canary will be updated with the changes. If the dry run fails, the CloudFormation deployment will fail with the dry run's failure reason. If set to false or omitted, the canary will be updated directly without first performing a dry run. Default: undefined - AWS CloudWatch default is false
         :param environment_variables: Key-value pairs that the Synthetics caches and makes available for your canary scripts. Use environment variables to apply configuration changes, such as test and production environment configurations, without changing your Canary script source code. Default: - No environment variables.
         :param failure_retention_period: How many days should failed runs be retained. Default: Duration.days(31)
+        :param max_retries: The amount of times the canary will automatically retry a failed run. This is only supported on the following runtimes or newer: ``Runtime.SYNTHETICS_NODEJS_PUPPETEER_10_0``, ``Runtime.SYNTHETICS_NODEJS_PLAYWRIGHT_2_0``, ``Runtime.SYNTHETICS_PYTHON_SELENIUM_5_1``. Max retries can be set between 0 and 2. Canaries which time out after 10 minutes are automatically limited to one retry. Default: 0
         :param memory: The maximum amount of memory that the canary can use while running. This value must be a multiple of 64 Mib. The range is 960 MiB to 3008 MiB. Default: Size.mebibytes(1024)
         :param provisioned_resource_cleanup: Whether to also delete the Lambda functions and layers used by this canary when the canary is deleted. Default: undefined - the default behavior is to not delete the Lambda functions and layers
+        :param resources_to_replicate_tags: Specifies which resources should have their tags replicated to this canary. To have the tags that you apply to this canary also be applied to the Lambda function that the canary uses, specify this property with the value ResourceToReplicateTags.LAMBDA_FUNCTION. If you do this, CloudWatch Synthetics will keep the tags of the canary and the Lambda function synchronized. Any future changes you make to the canary's tags will also be applied to the function. Default: - No resources will have their tags replicated to this canary
         :param role: Canary execution role. This is the role that will be assumed by the canary upon execution. It controls the permissions that the canary will have. The role must be assumable by the AWS Lambda service principal. If not supplied, a role will be created with all the required permissions. If you provide a Role, you must add the required permissions. Default: - A unique role will be generated for this canary. You can add permissions to roles by calling 'addToRolePolicy'.
         :param schedule: Specify the schedule for how often the canary runs. For example, if you set ``schedule`` to ``rate(10 minutes)``, then the canary will run every 10 minutes. You can set the schedule with ``Schedule.rate(Duration)`` (recommended) or you can specify an expression using ``Schedule.expression()``. Default: 'rate(5 minutes)'
         :param security_groups: The list of security groups to associate with the canary's network interfaces. You must provide ``vpc`` when using this prop. Default: - If the canary is placed within a VPC and a security group is not specified a dedicated security group will be created for this canary.
@@ -655,8 +696,10 @@ class Canary(
             dry_run_and_update=dry_run_and_update,
             environment_variables=environment_variables,
             failure_retention_period=failure_retention_period,
+            max_retries=max_retries,
             memory=memory,
             provisioned_resource_cleanup=provisioned_resource_cleanup,
+            resources_to_replicate_tags=resources_to_replicate_tags,
             role=role,
             schedule=schedule,
             security_groups=security_groups,
@@ -896,8 +939,10 @@ class Canary(
         "dry_run_and_update": "dryRunAndUpdate",
         "environment_variables": "environmentVariables",
         "failure_retention_period": "failureRetentionPeriod",
+        "max_retries": "maxRetries",
         "memory": "memory",
         "provisioned_resource_cleanup": "provisionedResourceCleanup",
+        "resources_to_replicate_tags": "resourcesToReplicateTags",
         "role": "role",
         "schedule": "schedule",
         "security_groups": "securityGroups",
@@ -925,8 +970,10 @@ class CanaryProps:
         dry_run_and_update: typing.Optional[builtins.bool] = None,
         environment_variables: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
         failure_retention_period: typing.Optional[_Duration_4839e8c3] = None,
+        max_retries: typing.Optional[jsii.Number] = None,
         memory: typing.Optional[_Size_7b441c34] = None,
         provisioned_resource_cleanup: typing.Optional[builtins.bool] = None,
+        resources_to_replicate_tags: typing.Optional[typing.Sequence["ResourceToReplicateTags"]] = None,
         role: typing.Optional[_IRole_235f5d8e] = None,
         schedule: typing.Optional["Schedule"] = None,
         security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
@@ -948,11 +995,13 @@ class CanaryProps:
         :param artifacts_bucket_location: The s3 location that stores the data of the canary runs. Default: - A new s3 bucket will be created without a prefix.
         :param canary_name: The name of the canary. Be sure to give it a descriptive name that distinguishes it from other canaries in your account. Do not include secrets or proprietary information in your canary name. The canary name makes up part of the canary ARN, which is included in outbound calls over the internet. Default: - A unique name will be generated from the construct ID
         :param cleanup: (deprecated) Specify the underlying resources to be cleaned up when the canary is deleted. Using ``Cleanup.LAMBDA`` will create a Custom Resource to achieve this. Default: Cleanup.NOTHING
-        :param dry_run_and_update: Specifies whether to perform a dry run before updating the canary. If set to true, CDK will execute a dry run to validate the changes before applying them to the canary. If the dry run succeeds, the canary will be updated with the changes. If the dry run fails, the CloudFormation deployment will fail with the dry run’s failure reason. If set to false or omitted, the canary will be updated directly without first performing a dry run. Default: undefined - AWS CloudWatch default is false
+        :param dry_run_and_update: Specifies whether to perform a dry run before updating the canary. If set to true, CDK will execute a dry run to validate the changes before applying them to the canary. If the dry run succeeds, the canary will be updated with the changes. If the dry run fails, the CloudFormation deployment will fail with the dry run's failure reason. If set to false or omitted, the canary will be updated directly without first performing a dry run. Default: undefined - AWS CloudWatch default is false
         :param environment_variables: Key-value pairs that the Synthetics caches and makes available for your canary scripts. Use environment variables to apply configuration changes, such as test and production environment configurations, without changing your Canary script source code. Default: - No environment variables.
         :param failure_retention_period: How many days should failed runs be retained. Default: Duration.days(31)
+        :param max_retries: The amount of times the canary will automatically retry a failed run. This is only supported on the following runtimes or newer: ``Runtime.SYNTHETICS_NODEJS_PUPPETEER_10_0``, ``Runtime.SYNTHETICS_NODEJS_PLAYWRIGHT_2_0``, ``Runtime.SYNTHETICS_PYTHON_SELENIUM_5_1``. Max retries can be set between 0 and 2. Canaries which time out after 10 minutes are automatically limited to one retry. Default: 0
         :param memory: The maximum amount of memory that the canary can use while running. This value must be a multiple of 64 Mib. The range is 960 MiB to 3008 MiB. Default: Size.mebibytes(1024)
         :param provisioned_resource_cleanup: Whether to also delete the Lambda functions and layers used by this canary when the canary is deleted. Default: undefined - the default behavior is to not delete the Lambda functions and layers
+        :param resources_to_replicate_tags: Specifies which resources should have their tags replicated to this canary. To have the tags that you apply to this canary also be applied to the Lambda function that the canary uses, specify this property with the value ResourceToReplicateTags.LAMBDA_FUNCTION. If you do this, CloudWatch Synthetics will keep the tags of the canary and the Lambda function synchronized. Any future changes you make to the canary's tags will also be applied to the function. Default: - No resources will have their tags replicated to this canary
         :param role: Canary execution role. This is the role that will be assumed by the canary upon execution. It controls the permissions that the canary will have. The role must be assumable by the AWS Lambda service principal. If not supplied, a role will be created with all the required permissions. If you provide a Role, you must add the required permissions. Default: - A unique role will be generated for this canary. You can add permissions to roles by calling 'addToRolePolicy'.
         :param schedule: Specify the schedule for how often the canary runs. For example, if you set ``schedule`` to ``rate(10 minutes)``, then the canary will run every 10 minutes. You can set the schedule with ``Schedule.rate(Duration)`` (recommended) or you can specify an expression using ``Schedule.expression()``. Default: 'rate(5 minutes)'
         :param security_groups: The list of security groups to associate with the canary's network interfaces. You must provide ``vpc`` when using this prop. Default: - If the canary is placed within a VPC and a security group is not specified a dedicated security group will be created for this canary.
@@ -967,17 +1016,14 @@ class CanaryProps:
 
         Example::
 
-            import aws_cdk as cdk
-            
-            
             canary = synthetics.Canary(self, "MyCanary",
                 schedule=synthetics.Schedule.rate(Duration.minutes(5)),
                 test=synthetics.Test.custom(
                     code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
                     handler="index.handler"
                 ),
-                runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_6_2,
-                memory=cdk.Size.mebibytes(1024)
+                runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_7_0,
+                resources_to_replicate_tags=[synthetics.ResourceToReplicateTags.LAMBDA_FUNCTION]
             )
         '''
         if isinstance(artifacts_bucket_location, dict):
@@ -998,8 +1044,10 @@ class CanaryProps:
             check_type(argname="argument dry_run_and_update", value=dry_run_and_update, expected_type=type_hints["dry_run_and_update"])
             check_type(argname="argument environment_variables", value=environment_variables, expected_type=type_hints["environment_variables"])
             check_type(argname="argument failure_retention_period", value=failure_retention_period, expected_type=type_hints["failure_retention_period"])
+            check_type(argname="argument max_retries", value=max_retries, expected_type=type_hints["max_retries"])
             check_type(argname="argument memory", value=memory, expected_type=type_hints["memory"])
             check_type(argname="argument provisioned_resource_cleanup", value=provisioned_resource_cleanup, expected_type=type_hints["provisioned_resource_cleanup"])
+            check_type(argname="argument resources_to_replicate_tags", value=resources_to_replicate_tags, expected_type=type_hints["resources_to_replicate_tags"])
             check_type(argname="argument role", value=role, expected_type=type_hints["role"])
             check_type(argname="argument schedule", value=schedule, expected_type=type_hints["schedule"])
             check_type(argname="argument security_groups", value=security_groups, expected_type=type_hints["security_groups"])
@@ -1033,10 +1081,14 @@ class CanaryProps:
             self._values["environment_variables"] = environment_variables
         if failure_retention_period is not None:
             self._values["failure_retention_period"] = failure_retention_period
+        if max_retries is not None:
+            self._values["max_retries"] = max_retries
         if memory is not None:
             self._values["memory"] = memory
         if provisioned_resource_cleanup is not None:
             self._values["provisioned_resource_cleanup"] = provisioned_resource_cleanup
+        if resources_to_replicate_tags is not None:
+            self._values["resources_to_replicate_tags"] = resources_to_replicate_tags
         if role is not None:
             self._values["role"] = role
         if schedule is not None:
@@ -1178,7 +1230,7 @@ class CanaryProps:
 
         If set to true, CDK will execute a dry run to validate the changes before applying them to the canary.
         If the dry run succeeds, the canary will be updated with the changes.
-        If the dry run fails, the CloudFormation deployment will fail with the dry run’s failure reason.
+        If the dry run fails, the CloudFormation deployment will fail with the dry run's failure reason.
 
         If set to false or omitted, the canary will be updated directly without first performing a dry run.
 
@@ -1213,6 +1265,20 @@ class CanaryProps:
         result = self._values.get("failure_retention_period")
         return typing.cast(typing.Optional[_Duration_4839e8c3], result)
 
+    @builtins.property
+    def max_retries(self) -> typing.Optional[jsii.Number]:
+        '''The amount of times the canary will automatically retry a failed run.
+
+        This is only supported on the following runtimes or newer: ``Runtime.SYNTHETICS_NODEJS_PUPPETEER_10_0``, ``Runtime.SYNTHETICS_NODEJS_PLAYWRIGHT_2_0``, ``Runtime.SYNTHETICS_PYTHON_SELENIUM_5_1``.
+        Max retries can be set between 0 and 2. Canaries which time out after 10 minutes are automatically limited to one retry.
+
+        :default: 0
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_autoretry.html
+        '''
+        result = self._values.get("max_retries")
+        return typing.cast(typing.Optional[jsii.Number], result)
+
     @builtins.property
     def memory(self) -> typing.Optional[_Size_7b441c34]:
         '''The maximum amount of memory that the canary can use while running.
@@ -1234,6 +1300,23 @@ class CanaryProps:
         result = self._values.get("provisioned_resource_cleanup")
         return typing.cast(typing.Optional[builtins.bool], result)
 
+    @builtins.property
+    def resources_to_replicate_tags(
+        self,
+    ) -> typing.Optional[typing.List["ResourceToReplicateTags"]]:
+        '''Specifies which resources should have their tags replicated to this canary.
+
+        To have the tags that you apply to this canary also be applied to the Lambda
+        function that the canary uses, specify this property with the value
+        ResourceToReplicateTags.LAMBDA_FUNCTION. If you do this, CloudWatch Synthetics will keep the tags of the canary and the
+        Lambda function synchronized. Any future changes you make to the canary's tags
+        will also be applied to the function.
+
+        :default: - No resources will have their tags replicated to this canary
+        '''
+        result = self._values.get("resources_to_replicate_tags")
+        return typing.cast(typing.Optional[typing.List["ResourceToReplicateTags"]], result)
+
     @builtins.property
     def role(self) -> typing.Optional[_IRole_235f5d8e]:
         '''Canary execution role.
@@ -3495,17 +3578,14 @@ class Code(
 
     Example::
 
-        import aws_cdk as cdk
-        
-        
         canary = synthetics.Canary(self, "MyCanary",
             schedule=synthetics.Schedule.rate(Duration.minutes(5)),
             test=synthetics.Test.custom(
                 code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
                 handler="index.handler"
             ),
-            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_6_2,
-            memory=cdk.Size.mebibytes(1024)
+            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_7_0,
+            resources_to_replicate_tags=[synthetics.ResourceToReplicateTags.LAMBDA_FUNCTION]
         )
     '''
 
@@ -3871,17 +3951,14 @@ class CustomTestOptions:
 
         Example::
 
-            import aws_cdk as cdk
-            
-            
             canary = synthetics.Canary(self, "MyCanary",
                 schedule=synthetics.Schedule.rate(Duration.minutes(5)),
                 test=synthetics.Test.custom(
                     code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
                     handler="index.handler"
                 ),
-                runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_6_2,
-                memory=cdk.Size.mebibytes(1024)
+                runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_7_0,
+                resources_to_replicate_tags=[synthetics.ResourceToReplicateTags.LAMBDA_FUNCTION]
             )
         '''
         if __debug__:
@@ -3973,6 +4050,34 @@ class InlineCode(
         return typing.cast(CodeConfig, jsii.invoke(self, "bind", [scope, handler, _family, _runtime_name]))
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_synthetics.ResourceToReplicateTags")
+class ResourceToReplicateTags(enum.Enum):
+    '''Resources that tags applied to a canary should be replicated to.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        canary = synthetics.Canary(self, "MyCanary",
+            schedule=synthetics.Schedule.rate(Duration.minutes(5)),
+            test=synthetics.Test.custom(
+                code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
+                handler="index.handler"
+            ),
+            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_7_0,
+            resources_to_replicate_tags=[synthetics.ResourceToReplicateTags.LAMBDA_FUNCTION]
+        )
+    '''
+
+    LAMBDA_FUNCTION = "LAMBDA_FUNCTION"
+    '''Replicate canary tags to the Lambda function.
+
+    When specified, CloudWatch Synthetics will keep the tags of the canary
+    and the Lambda function synchronized. Any future changes made to the
+    canary's tags will also be applied to the function.
+    '''
+
+
 class Runtime(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_synthetics.Runtime"):
     '''Runtime options for a canary.
 
@@ -3980,17 +4085,14 @@ class Runtime(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_synthetics.Run
 
     Example::
 
-        import aws_cdk as cdk
-        
-        
         canary = synthetics.Canary(self, "MyCanary",
             schedule=synthetics.Schedule.rate(Duration.minutes(5)),
             test=synthetics.Test.custom(
                 code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
                 handler="index.handler"
             ),
-            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_6_2,
-            memory=cdk.Size.mebibytes(1024)
+            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_7_0,
+            resources_to_replicate_tags=[synthetics.ResourceToReplicateTags.LAMBDA_FUNCTION]
         )
     '''
 
@@ -4556,11 +4658,11 @@ class Schedule(
         canary = synthetics.Canary(self, "MyCanary",
             schedule=synthetics.Schedule.rate(Duration.minutes(5)),
             test=synthetics.Test.custom(
-                code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
-                handler="index.handler"
+                handler="canary.handler",
+                code=synthetics.Code.from_asset(path.join(__dirname, "canaries"))
             ),
-            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_6_2,
-            active_tracing=True
+            runtime=synthetics.Runtime.SYNTHETICS_PYTHON_SELENIUM_5_1,
+            max_retries=2
         )
     '''
 
@@ -4639,17 +4741,14 @@ class Test(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_synthetics.Test")
 
     Example::
 
-        import aws_cdk as cdk
-        
-        
         canary = synthetics.Canary(self, "MyCanary",
             schedule=synthetics.Schedule.rate(Duration.minutes(5)),
             test=synthetics.Test.custom(
                 code=synthetics.Code.from_asset(path.join(__dirname, "canary")),
                 handler="index.handler"
             ),
-            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_6_2,
-            memory=cdk.Size.mebibytes(1024)
+            runtime=synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_7_0,
+            resources_to_replicate_tags=[synthetics.ResourceToReplicateTags.LAMBDA_FUNCTION]
         )
     '''
 
@@ -4828,6 +4927,7 @@ __all__ = [
     "CronOptions",
     "CustomTestOptions",
     "InlineCode",
+    "ResourceToReplicateTags",
     "Runtime",
     "RuntimeFamily",
     "S3Code",
@@ -4861,8 +4961,10 @@ def _typecheckingstub__b3b6d76e5f93e31884e16cc00a9b4fc93e6782ff7db09c74aa1ef9346
     dry_run_and_update: typing.Optional[builtins.bool] = None,
     environment_variables: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
     failure_retention_period: typing.Optional[_Duration_4839e8c3] = None,
+    max_retries: typing.Optional[jsii.Number] = None,
     memory: typing.Optional[_Size_7b441c34] = None,
     provisioned_resource_cleanup: typing.Optional[builtins.bool] = None,
+    resources_to_replicate_tags: typing.Optional[typing.Sequence[ResourceToReplicateTags]] = None,
     role: typing.Optional[_IRole_235f5d8e] = None,
     schedule: typing.Optional[Schedule] = None,
     security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,
@@ -4890,8 +4992,10 @@ def _typecheckingstub__44ec0b14d52b66927d4daebe6f97bb070f3629bb0eb86e21668ca7862
     dry_run_and_update: typing.Optional[builtins.bool] = None,
     environment_variables: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
     failure_retention_period: typing.Optional[_Duration_4839e8c3] = None,
+    max_retries: typing.Optional[jsii.Number] = None,
     memory: typing.Optional[_Size_7b441c34] = None,
     provisioned_resource_cleanup: typing.Optional[builtins.bool] = None,
+    resources_to_replicate_tags: typing.Optional[typing.Sequence[ResourceToReplicateTags]] = None,
     role: typing.Optional[_IRole_235f5d8e] = None,
     schedule: typing.Optional[Schedule] = None,
     security_groups: typing.Optional[typing.Sequence[_ISecurityGroup_acf8a799]] = None,

aws_cdk/aws_transfer/__init__.py

@@ -1282,6 +1282,7 @@ class CfnConnector(
             logging_role="loggingRole",
             security_policy_name="securityPolicyName",
             sftp_config=transfer.CfnConnector.SftpConfigProperty(
+                max_concurrent_connections=123,
                 trusted_host_keys=["trustedHostKeys"],
                 user_secret_id="userSecretId"
             ),
@@ -1736,6 +1737,7 @@ class CfnConnector(
         jsii_type="aws-cdk-lib.aws_transfer.CfnConnector.SftpConfigProperty",
         jsii_struct_bases=[],
         name_mapping={
+            "max_concurrent_connections": "maxConcurrentConnections",
             "trusted_host_keys": "trustedHostKeys",
             "user_secret_id": "userSecretId",
         },
@@ -1744,11 +1746,13 @@ class CfnConnector(
         def __init__(
             self,
             *,
+            max_concurrent_connections: typing.Optional[jsii.Number] = None,
             trusted_host_keys: typing.Optional[typing.Sequence[builtins.str]] = None,
             user_secret_id: typing.Optional[builtins.str] = None,
         ) -> None:
             '''A structure that contains the parameters for an SFTP connector object.
 
+            :param max_concurrent_connections: Specifies the number of active connections that your connector can establish with the remote server at the same time. Default: - 1
             :param trusted_host_keys: The public portion of the host key, or keys, that are used to identify the external server to which you are connecting. You can use the ``ssh-keyscan`` command against the SFTP server to retrieve the necessary key. .. epigraph:: ``TrustedHostKeys`` is optional for ``CreateConnector`` . If not provided, you can use ``TestConnection`` to retrieve the server host key during the initial connection attempt, and subsequently update the connector with the observed host key. The three standard SSH public key format elements are ``<key type>`` , ``<body base64>`` , and an optional ``<comment>`` , with spaces between each element. Specify only the ``<key type>`` and ``<body base64>`` : do not enter the ``<comment>`` portion of the key. For the trusted host key, AWS Transfer Family accepts RSA and ECDSA keys. - For RSA keys, the ``<key type>`` string is ``ssh-rsa`` . - For ECDSA keys, the ``<key type>`` string is either ``ecdsa-sha2-nistp256`` , ``ecdsa-sha2-nistp384`` , or ``ecdsa-sha2-nistp521`` , depending on the size of the key you generated. Run this command to retrieve the SFTP server host key, where your SFTP server name is ``ftp.host.com`` . ``ssh-keyscan ftp.host.com`` This prints the public host key to standard output. ``ftp.host.com ssh-rsa AAAAB3Nza...<long-string-for-public-key`` Copy and paste this string into the ``TrustedHostKeys`` field for the ``create-connector`` command or into the *Trusted host keys* field in the console.
             :param user_secret_id: The identifier for the secret (in AWS Secrets Manager) that contains the SFTP user's private key, password, or both. The identifier must be the Amazon Resource Name (ARN) of the secret. .. epigraph:: - Required when creating an SFTP connector - Optional when updating an existing SFTP connector
 
@@ -1762,20 +1766,35 @@ class CfnConnector(
                 from aws_cdk import aws_transfer as transfer
                 
                 sftp_config_property = transfer.CfnConnector.SftpConfigProperty(
+                    max_concurrent_connections=123,
                     trusted_host_keys=["trustedHostKeys"],
                     user_secret_id="userSecretId"
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__f4f8d4be2ad63a06a458c41605c9c21318e1d9117d48f21b9ee2ea6bb109d2e8)
+                check_type(argname="argument max_concurrent_connections", value=max_concurrent_connections, expected_type=type_hints["max_concurrent_connections"])
                 check_type(argname="argument trusted_host_keys", value=trusted_host_keys, expected_type=type_hints["trusted_host_keys"])
                 check_type(argname="argument user_secret_id", value=user_secret_id, expected_type=type_hints["user_secret_id"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if max_concurrent_connections is not None:
+                self._values["max_concurrent_connections"] = max_concurrent_connections
             if trusted_host_keys is not None:
                 self._values["trusted_host_keys"] = trusted_host_keys
             if user_secret_id is not None:
                 self._values["user_secret_id"] = user_secret_id
 
+        @builtins.property
+        def max_concurrent_connections(self) -> typing.Optional[jsii.Number]:
+            '''Specifies the number of active connections that your connector can establish with the remote server at the same time.
+
+            :default: - 1
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-transfer-connector-sftpconfig.html#cfn-transfer-connector-sftpconfig-maxconcurrentconnections
+            '''
+            result = self._values.get("max_concurrent_connections")
+            return typing.cast(typing.Optional[jsii.Number], result)
+
         @builtins.property
         def trusted_host_keys(self) -> typing.Optional[typing.List[builtins.str]]:
             '''The public portion of the host key, or keys, that are used to identify the external server to which you are connecting.
@@ -1889,6 +1908,7 @@ class CfnConnectorProps:
                 logging_role="loggingRole",
                 security_policy_name="securityPolicyName",
                 sftp_config=transfer.CfnConnector.SftpConfigProperty(
+                    max_concurrent_connections=123,
                     trusted_host_keys=["trustedHostKeys"],
                     user_secret_id="userSecretId"
                 ),
@@ -2804,7 +2824,7 @@ class CfnServer(
 
             When you host your endpoint within your VPC, you can make your endpoint accessible only to resources within your VPC, or you can attach Elastic IP addresses and make your endpoint accessible to clients over the internet. Your VPC's default security groups are automatically assigned to your endpoint.
 
-            :param address_allocation_ids: A list of address allocation IDs that are required to attach an Elastic IP address to your server's endpoint. An address allocation ID corresponds to the allocation ID of an Elastic IP address. This value can be retrieved from the ``allocationId`` field from the Amazon EC2 `Address <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_Address.html>`_ data type. One way to retrieve this value is by calling the EC2 `DescribeAddresses <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAddresses.html>`_ API. This parameter is optional. Set this parameter if you want to make your VPC endpoint public-facing. For details, see `Create an internet-facing endpoint for your server <https://docs.aws.amazon.com/transfer/latest/userguide/create-server-in-vpc.html#create-internet-facing-endpoint>`_ . .. epigraph:: This property can only be set as follows: - ``EndpointType`` must be set to ``VPC`` - The Transfer Family server must be offline. - You cannot set this parameter for Transfer Family servers that use the FTP protocol. - The server must already have ``SubnetIds`` populated ( ``SubnetIds`` and ``AddressAllocationIds`` cannot be updated simultaneously). - ``AddressAllocationIds`` can't contain duplicates, and must be equal in length to ``SubnetIds`` . For example, if you have three subnet IDs, you must also specify three address allocation IDs. - Call the ``UpdateServer`` API to set or change this parameter.
+            :param address_allocation_ids: A list of address allocation IDs that are required to attach an Elastic IP address to your server's endpoint. An address allocation ID corresponds to the allocation ID of an Elastic IP address. This value can be retrieved from the ``allocationId`` field from the Amazon EC2 `Address <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_Address.html>`_ data type. One way to retrieve this value is by calling the EC2 `DescribeAddresses <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_DescribeAddresses.html>`_ API. This parameter is optional. Set this parameter if you want to make your VPC endpoint public-facing. For details, see `Create an internet-facing endpoint for your server <https://docs.aws.amazon.com/transfer/latest/userguide/create-server-in-vpc.html#create-internet-facing-endpoint>`_ . .. epigraph:: This property can only be set as follows: - ``EndpointType`` must be set to ``VPC`` - The Transfer Family server must be offline. - You cannot set this parameter for Transfer Family servers that use the FTP protocol. - The server must already have ``SubnetIds`` populated ( ``SubnetIds`` and ``AddressAllocationIds`` cannot be updated simultaneously). - ``AddressAllocationIds`` can't contain duplicates, and must be equal in length to ``SubnetIds`` . For example, if you have three subnet IDs, you must also specify three address allocation IDs. - Call the ``UpdateServer`` API to set or change this parameter. - You can't set address allocation IDs for servers that have an ``IpAddressType`` set to ``DUALSTACK`` You can only set this property if ``IpAddressType`` is set to ``IPV4`` .
             :param security_group_ids: A list of security groups IDs that are available to attach to your server's endpoint. .. epigraph:: This property can only be set when ``EndpointType`` is set to ``VPC`` . You can edit the ``SecurityGroupIds`` property in the `UpdateServer <https://docs.aws.amazon.com/transfer/latest/userguide/API_UpdateServer.html>`_ API only if you are changing the ``EndpointType`` from ``PUBLIC`` or ``VPC_ENDPOINT`` to ``VPC`` . To change security groups associated with your server's VPC endpoint after creation, use the Amazon EC2 `ModifyVpcEndpoint <https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_ModifyVpcEndpoint.html>`_ API.
             :param subnet_ids: A list of subnet IDs that are required to host your server endpoint in your VPC. .. epigraph:: This property can only be set when ``EndpointType`` is set to ``VPC`` .
             :param vpc_endpoint_id: The ID of the VPC endpoint. .. epigraph:: This property can only be set when ``EndpointType`` is set to ``VPC_ENDPOINT`` .
@@ -2863,6 +2883,7 @@ class CfnServer(
                - The server must already have ``SubnetIds`` populated ( ``SubnetIds`` and ``AddressAllocationIds`` cannot be updated simultaneously).
                - ``AddressAllocationIds`` can't contain duplicates, and must be equal in length to ``SubnetIds`` . For example, if you have three subnet IDs, you must also specify three address allocation IDs.
                - Call the ``UpdateServer`` API to set or change this parameter.
+               - You can't set address allocation IDs for servers that have an ``IpAddressType`` set to ``DUALSTACK`` You can only set this property if ``IpAddressType`` is set to ``IPV4`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-transfer-server-endpointdetails.html#cfn-transfer-server-endpointdetails-addressallocationids
             '''
@@ -7140,6 +7161,7 @@ def _typecheckingstub__328497a7bbb181a996e0747268f6105731221ad3f578e8a5ca68e405d
 
 def _typecheckingstub__f4f8d4be2ad63a06a458c41605c9c21318e1d9117d48f21b9ee2ea6bb109d2e8(
     *,
+    max_concurrent_connections: typing.Optional[jsii.Number] = None,
     trusted_host_keys: typing.Optional[typing.Sequence[builtins.str]] = None,
     user_secret_id: typing.Optional[builtins.str] = None,
 ) -> None:

{aws_cdk_lib-2.204.0.dist-info → aws_cdk_lib-2.205.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aws-cdk-lib
-Version: 2.204.0
+Version: 2.205.0
 Summary: Version 2 of the AWS Cloud Development Kit library
 Home-page: https://github.com/aws/aws-cdk
 Author: Amazon Web Services