aws-cdk-lib 2.195.0__py3-none-any.whl → 2.224.0__py3-none-any.whl

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`.
@@ -146,6 +168,32 @@ canary = synthetics.Canary(self, "MyCanary",
 )
 ```
 
+### Browser Type Configuration
+
+You can configure which browsers your canary uses for testing by specifying the `browserConfigs` property. This allows you to test your application across different browsers to ensure compatibility.
+
+Available browser types:
+
+* `BrowserType.CHROME` - Google Chrome browser
+* `BrowserType.FIREFOX` - Mozilla Firefox browser
+
+You can specify up to 2 browser configurations. When multiple browsers are configured, the canary will run tests on each browser sequentially.
+
+```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_9_1,
+    browser_configs=[synthetics.BrowserType.CHROME, synthetics.BrowserType.FIREFOX
+    ]
+)
+```
+
+> **Note:** Firefox support is available for Node.js runtimes (Puppeteer and Playwright) but not for Python Selenium runtimes. When using Firefox, ensure your runtime version supports it.
+
 ### Deleting underlying resources on canary deletion
 
 When you delete a lambda, the following underlying resources are isolated in your AWS account:
@@ -220,7 +268,18 @@ synthetics.Canary(self, "Bucket Canary",
 ```
 
 > **Note:** Synthetics have a specified folder structure for canaries.
-> For Node with puppeteer scripts supplied via `code.fromAsset()` or `code.fromBucket()`, the canary resource requires the following folder structure:
+> For Node with puppeteer scripts supplied via `code.fromAsset()` or `code.fromBucket()`, the canary resource requires the following folder structure for runtime versions older than `syn-nodejs-puppeteer-11.0`:
+>
+> ```plaintext
+> canary/
+> ├── nodejs/
+>    ├── node_modules/
+>         ├── <filename>.js
+> ```
+>
+> For puppeteer based runtime versions newer than or equal to `syn-nodejs-puppeteer-11.0`, `nodjs/node_modules` is not necessary but supported.
+>
+> Both
 >
 > ```plaintext
 > canary/
@@ -229,6 +288,15 @@ synthetics.Canary(self, "Bucket Canary",
 >         ├── <filename>.js
 > ```
 >
+> And
+>
+> ```plaintext
+> canary/
+>  ├── <filename>.js
+> ```
+>
+> are supported.
+>
 > For Node with playwright scripts supplied via `code.fromAsset()` or `code.fromBucket()`, the canary resource requires the following folder structure:
 >
 > ```plaintext
@@ -302,6 +370,29 @@ cloudwatch.Alarm(self, "CanaryAlarm",
 )
 ```
 
+### Performing safe canary updates
+
+You can configure a canary to first perform a dry run before applying any updates. The `dryRunAndUpdate` property can be used to safely update canaries by validating the changes before they're applied.
+This feature is supported for canary runtime versions `syn-nodejs-puppeteer-10.0+`, `syn-nodejs-playwright-2.0+`, and `syn-python-selenium-5.1+`.
+
+When `dryRunAndUpdate` is 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.
+
+```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_PYTHON_SELENIUM_5_1,
+    dry_run_and_update=True
+)
+```
+
+For more information, see [Performing safe canary updates](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/performing-safe-canary-upgrades.html).
+
 ### Artifacts
 
 You can pass an S3 bucket to store artifacts from canary runs. If you do not,
@@ -349,6 +440,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__)
@@ -419,6 +528,14 @@ from ..aws_s3 import (
     Location as _Location_0948fa7f,
 )
 from ..aws_s3_assets import AssetOptions as _AssetOptions_2aa69621
+from ..interfaces.aws_kms import IKeyRef as _IKeyRef_d4fc6ef3
+from ..interfaces.aws_s3 import IBucketRef as _IBucketRef_3debe44e
+from ..interfaces.aws_synthetics import (
+    CanaryReference as _CanaryReference_fbbe85ce,
+    GroupReference as _GroupReference_37835a7e,
+    ICanaryRef as _ICanaryRef_cf407e49,
+    IGroupRef as _IGroupRef_4fc55162,
+)
 
 
 @jsii.data_type(
@@ -533,6 +650,32 @@ class ArtifactsEncryptionMode(enum.Enum):
     '''Server-side encryption (SSE) with an AWS KMS customer managed key.'''
 
 
+@jsii.enum(jsii_type="aws-cdk-lib.aws_synthetics.BrowserType")
+class BrowserType(enum.Enum):
+    '''Browser types supported by CloudWatch Synthetics Canary.
+
+    :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_9_1,
+            browser_configs=[synthetics.BrowserType.CHROME, synthetics.BrowserType.FIREFOX
+            ]
+        )
+    '''
+
+    CHROME = "CHROME"
+    '''Google Chrome browser.'''
+    FIREFOX = "FIREFOX"
+    '''Mozilla Firefox browser.'''
+
+
 @jsii.implements(_IConnectable_10015a05)
 class Canary(
     _Resource_45bc6135,
@@ -545,17 +688,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]
         )
     '''
 
@@ -571,12 +711,16 @@ class Canary(
         artifact_s3_kms_key: typing.Optional[_IKey_5f11635f] = None,
         artifacts_bucket_lifecycle_rules: typing.Optional[typing.Sequence[typing.Union[_LifecycleRule_bb74e6ff, typing.Dict[builtins.str, typing.Any]]]] = None,
         artifacts_bucket_location: typing.Optional[typing.Union[ArtifactsBucketLocation, typing.Dict[builtins.str, typing.Any]]] = None,
+        browser_configs: typing.Optional[typing.Sequence[BrowserType]] = None,
         canary_name: typing.Optional[builtins.str] = None,
         cleanup: typing.Optional["Cleanup"] = None,
+        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,
@@ -597,12 +741,16 @@ class Canary(
         :param artifact_s3_kms_key: The KMS key used to encrypt canary artifacts. Default: - no kms key if ``artifactS3EncryptionMode`` is set to ``S3_MANAGED``. A key will be created if one is not provided and ``artifactS3EncryptionMode`` is set to ``KMS``.
         :param artifacts_bucket_lifecycle_rules: Lifecycle rules for the generated canary artifact bucket. Has no effect if a bucket is passed to ``artifactsBucketLocation``. If you pass a bucket to ``artifactsBucketLocation``, you can add lifecycle rules to the bucket itself. Default: - no rules applied to the generated bucket.
         :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 browser_configs: Browser configurations for the canary. Specifies which browser(s) to use for running the canary tests. You can specify up to 2 browser configurations. Firefox is supported with Node.js Puppeteer and Playwright runtimes, but not with Python Selenium runtimes. Default: undefined - AWS CloudWatch default is using only Chrome browser
         :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 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.
@@ -625,12 +773,16 @@ class Canary(
             artifact_s3_kms_key=artifact_s3_kms_key,
             artifacts_bucket_lifecycle_rules=artifacts_bucket_lifecycle_rules,
             artifacts_bucket_location=artifacts_bucket_location,
+            browser_configs=browser_configs,
             canary_name=canary_name,
             cleanup=cleanup,
+            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,
@@ -651,6 +803,7 @@ class Canary(
         account: typing.Optional[builtins.str] = None,
         color: typing.Optional[builtins.str] = None,
         dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        id: typing.Optional[builtins.str] = None,
         label: typing.Optional[builtins.str] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         region: typing.Optional[builtins.str] = None,
@@ -658,12 +811,14 @@ class Canary(
         stack_region: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional[_Unit_61bc6f70] = None,
+        visible: typing.Optional[builtins.bool] = None,
     ) -> _Metric_e396a4dc:
         '''Measure the Duration of a single canary run, in seconds.
 
         :param account: Account which this metric comes from. Default: - Deployment account.
         :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
         :param dimensions_map: Dimensions of the metric. Default: - No dimensions.
+        :param id: Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
         :param label: Label for this metric when added to a Graph in a Dashboard. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. Default: - No label
         :param period: The period over which the specified statistic is applied. Default: Duration.minutes(5)
         :param region: Region which this metric comes from. Default: - Deployment region.
@@ -671,6 +826,7 @@ class Canary(
         :param stack_region: Region of the stack this metric is attached to. Default: - Deployment region.
         :param statistic: What function to use for aggregating. Use the ``aws_cloudwatch.Stats`` helper class to construct valid input strings. Can be one of the following: - "Minimum" | "min" - "Maximum" | "max" - "Average" | "avg" - "Sum" | "sum" - "SampleCount | "n" - "pNN.NN" - "tmNN.NN" | "tm(NN.NN%:NN.NN%)" - "iqm" - "wmNN.NN" | "wm(NN.NN%:NN.NN%)" - "tcNN.NN" | "tc(NN.NN%:NN.NN%)" - "tsNN.NN" | "ts(NN.NN%:NN.NN%)" Default: Average
         :param unit: Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
+        :param visible: Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
         :default: avg over 5 minutes
         '''
@@ -678,6 +834,7 @@ class Canary(
             account=account,
             color=color,
             dimensions_map=dimensions_map,
+            id=id,
             label=label,
             period=period,
             region=region,
@@ -685,6 +842,7 @@ class Canary(
             stack_region=stack_region,
             statistic=statistic,
             unit=unit,
+            visible=visible,
         )
 
         return typing.cast(_Metric_e396a4dc, jsii.invoke(self, "metricDuration", [options]))
@@ -696,6 +854,7 @@ class Canary(
         account: typing.Optional[builtins.str] = None,
         color: typing.Optional[builtins.str] = None,
         dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        id: typing.Optional[builtins.str] = None,
         label: typing.Optional[builtins.str] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         region: typing.Optional[builtins.str] = None,
@@ -703,6 +862,7 @@ class Canary(
         stack_region: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional[_Unit_61bc6f70] = None,
+        visible: typing.Optional[builtins.bool] = None,
     ) -> _Metric_e396a4dc:
         '''Measure the number of failed canary runs over a given time period.
 
@@ -711,6 +871,7 @@ class Canary(
         :param account: Account which this metric comes from. Default: - Deployment account.
         :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
         :param dimensions_map: Dimensions of the metric. Default: - No dimensions.
+        :param id: Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
         :param label: Label for this metric when added to a Graph in a Dashboard. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. Default: - No label
         :param period: The period over which the specified statistic is applied. Default: Duration.minutes(5)
         :param region: Region which this metric comes from. Default: - Deployment region.
@@ -718,11 +879,13 @@ class Canary(
         :param stack_region: Region of the stack this metric is attached to. Default: - Deployment region.
         :param statistic: What function to use for aggregating. Use the ``aws_cloudwatch.Stats`` helper class to construct valid input strings. Can be one of the following: - "Minimum" | "min" - "Maximum" | "max" - "Average" | "avg" - "Sum" | "sum" - "SampleCount | "n" - "pNN.NN" - "tmNN.NN" | "tm(NN.NN%:NN.NN%)" - "iqm" - "wmNN.NN" | "wm(NN.NN%:NN.NN%)" - "tcNN.NN" | "tc(NN.NN%:NN.NN%)" - "tsNN.NN" | "ts(NN.NN%:NN.NN%)" Default: Average
         :param unit: Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
+        :param visible: Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
         '''
         options = _MetricOptions_1788b62f(
             account=account,
             color=color,
             dimensions_map=dimensions_map,
+            id=id,
             label=label,
             period=period,
             region=region,
@@ -730,6 +893,7 @@ class Canary(
             stack_region=stack_region,
             statistic=statistic,
             unit=unit,
+            visible=visible,
         )
 
         return typing.cast(_Metric_e396a4dc, jsii.invoke(self, "metricFailed", [options]))
@@ -741,6 +905,7 @@ class Canary(
         account: typing.Optional[builtins.str] = None,
         color: typing.Optional[builtins.str] = None,
         dimensions_map: typing.Optional[typing.Mapping[builtins.str, builtins.str]] = None,
+        id: typing.Optional[builtins.str] = None,
         label: typing.Optional[builtins.str] = None,
         period: typing.Optional[_Duration_4839e8c3] = None,
         region: typing.Optional[builtins.str] = None,
@@ -748,12 +913,14 @@ class Canary(
         stack_region: typing.Optional[builtins.str] = None,
         statistic: typing.Optional[builtins.str] = None,
         unit: typing.Optional[_Unit_61bc6f70] = None,
+        visible: typing.Optional[builtins.bool] = None,
     ) -> _Metric_e396a4dc:
         '''Measure the percentage of successful canary runs.
 
         :param account: Account which this metric comes from. Default: - Deployment account.
         :param color: The hex color code, prefixed with '#' (e.g. '#00ff00'), to use when this metric is rendered on a graph. The ``Color`` class has a set of standard colors that can be used here. Default: - Automatic color
         :param dimensions_map: Dimensions of the metric. Default: - No dimensions.
+        :param id: Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
         :param label: Label for this metric when added to a Graph in a Dashboard. You can use `dynamic labels <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/graph-dynamic-labels.html>`_ to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph's legend. Default: - No label
         :param period: The period over which the specified statistic is applied. Default: Duration.minutes(5)
         :param region: Region which this metric comes from. Default: - Deployment region.
@@ -761,6 +928,7 @@ class Canary(
         :param stack_region: Region of the stack this metric is attached to. Default: - Deployment region.
         :param statistic: What function to use for aggregating. Use the ``aws_cloudwatch.Stats`` helper class to construct valid input strings. Can be one of the following: - "Minimum" | "min" - "Maximum" | "max" - "Average" | "avg" - "Sum" | "sum" - "SampleCount | "n" - "pNN.NN" - "tmNN.NN" | "tm(NN.NN%:NN.NN%)" - "iqm" - "wmNN.NN" | "wm(NN.NN%:NN.NN%)" - "tcNN.NN" | "tc(NN.NN%:NN.NN%)" - "tsNN.NN" | "ts(NN.NN%:NN.NN%)" Default: Average
         :param unit: Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
+        :param visible: Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
         :default: avg over 5 minutes
         '''
@@ -768,6 +936,7 @@ class Canary(
             account=account,
             color=color,
             dimensions_map=dimensions_map,
+            id=id,
             label=label,
             period=period,
             region=region,
@@ -775,10 +944,17 @@ class Canary(
             stack_region=stack_region,
             statistic=statistic,
             unit=unit,
+            visible=visible,
         )
 
         return typing.cast(_Metric_e396a4dc, jsii.invoke(self, "metricSuccessPercent", [options]))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="PROPERTY_INJECTION_ID")
+    def PROPERTY_INJECTION_ID(cls) -> builtins.str:
+        '''Uniquely identifies this class.'''
+        return typing.cast(builtins.str, jsii.sget(cls, "PROPERTY_INJECTION_ID"))
+
     @builtins.property
     @jsii.member(jsii_name="artifactsBucket")
     def artifacts_bucket(self) -> _IBucket_42e086fd:
@@ -841,12 +1017,16 @@ class Canary(
         "artifact_s3_kms_key": "artifactS3KmsKey",
         "artifacts_bucket_lifecycle_rules": "artifactsBucketLifecycleRules",
         "artifacts_bucket_location": "artifactsBucketLocation",
+        "browser_configs": "browserConfigs",
         "canary_name": "canaryName",
         "cleanup": "cleanup",
+        "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",
@@ -869,12 +1049,16 @@ class CanaryProps:
         artifact_s3_kms_key: typing.Optional[_IKey_5f11635f] = None,
         artifacts_bucket_lifecycle_rules: typing.Optional[typing.Sequence[typing.Union[_LifecycleRule_bb74e6ff, typing.Dict[builtins.str, typing.Any]]]] = None,
         artifacts_bucket_location: typing.Optional[typing.Union[ArtifactsBucketLocation, typing.Dict[builtins.str, typing.Any]]] = None,
+        browser_configs: typing.Optional[typing.Sequence[BrowserType]] = None,
         canary_name: typing.Optional[builtins.str] = None,
         cleanup: typing.Optional["Cleanup"] = None,
+        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,
@@ -894,12 +1078,16 @@ class CanaryProps:
         :param artifact_s3_kms_key: The KMS key used to encrypt canary artifacts. Default: - no kms key if ``artifactS3EncryptionMode`` is set to ``S3_MANAGED``. A key will be created if one is not provided and ``artifactS3EncryptionMode`` is set to ``KMS``.
         :param artifacts_bucket_lifecycle_rules: Lifecycle rules for the generated canary artifact bucket. Has no effect if a bucket is passed to ``artifactsBucketLocation``. If you pass a bucket to ``artifactsBucketLocation``, you can add lifecycle rules to the bucket itself. Default: - no rules applied to the generated bucket.
         :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 browser_configs: Browser configurations for the canary. Specifies which browser(s) to use for running the canary tests. You can specify up to 2 browser configurations. Firefox is supported with Node.js Puppeteer and Playwright runtimes, but not with Python Selenium runtimes. Default: undefined - AWS CloudWatch default is using only Chrome browser
         :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 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.
@@ -914,17 +1102,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):
@@ -940,12 +1125,16 @@ class CanaryProps:
             check_type(argname="argument artifact_s3_kms_key", value=artifact_s3_kms_key, expected_type=type_hints["artifact_s3_kms_key"])
             check_type(argname="argument artifacts_bucket_lifecycle_rules", value=artifacts_bucket_lifecycle_rules, expected_type=type_hints["artifacts_bucket_lifecycle_rules"])
             check_type(argname="argument artifacts_bucket_location", value=artifacts_bucket_location, expected_type=type_hints["artifacts_bucket_location"])
+            check_type(argname="argument browser_configs", value=browser_configs, expected_type=type_hints["browser_configs"])
             check_type(argname="argument canary_name", value=canary_name, expected_type=type_hints["canary_name"])
             check_type(argname="argument cleanup", value=cleanup, expected_type=type_hints["cleanup"])
+            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"])
@@ -969,18 +1158,26 @@ class CanaryProps:
             self._values["artifacts_bucket_lifecycle_rules"] = artifacts_bucket_lifecycle_rules
         if artifacts_bucket_location is not None:
             self._values["artifacts_bucket_location"] = artifacts_bucket_location
+        if browser_configs is not None:
+            self._values["browser_configs"] = browser_configs
         if canary_name is not None:
             self._values["canary_name"] = canary_name
         if cleanup is not None:
             self._values["cleanup"] = cleanup
+        if dry_run_and_update is not None:
+            self._values["dry_run_and_update"] = dry_run_and_update
         if environment_variables is not None:
             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:
@@ -1084,6 +1281,23 @@ class CanaryProps:
         result = self._values.get("artifacts_bucket_location")
         return typing.cast(typing.Optional[ArtifactsBucketLocation], result)
 
+    @builtins.property
+    def browser_configs(self) -> typing.Optional[typing.List[BrowserType]]:
+        '''Browser configurations for the canary.
+
+        Specifies which browser(s) to use for running the canary tests.
+        You can specify up to 2 browser configurations.
+
+        Firefox is supported with Node.js Puppeteer and Playwright runtimes,
+        but not with Python Selenium runtimes.
+
+        :default: undefined - AWS CloudWatch default is using only Chrome browser
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries.html
+        '''
+        result = self._values.get("browser_configs")
+        return typing.cast(typing.Optional[typing.List[BrowserType]], result)
+
     @builtins.property
     def canary_name(self) -> typing.Optional[builtins.str]:
         '''The name of the canary.
@@ -1116,6 +1330,23 @@ class CanaryProps:
         result = self._values.get("cleanup")
         return typing.cast(typing.Optional["Cleanup"], result)
 
+    @builtins.property
+    def dry_run_and_update(self) -> typing.Optional[builtins.bool]:
+        '''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
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/performing-safe-canary-upgrades.html
+        '''
+        result = self._values.get("dry_run_and_update")
+        return typing.cast(typing.Optional[builtins.bool], result)
+
     @builtins.property
     def environment_variables(
         self,
@@ -1140,6 +1371,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.
@@ -1161,6 +1406,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.
@@ -1286,7 +1548,7 @@ class CanaryProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
+@jsii.implements(_IInspectable_c2943556, _ICanaryRef_cf407e49, _ITaggable_36806126)
 class CfnCanary(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -1315,9 +1577,14 @@ class CfnCanary(
         cfn_canary = synthetics.CfnCanary(self, "MyCfnCanary",
             artifact_s3_location="artifactS3Location",
             code=synthetics.CfnCanary.CodeProperty(
-                handler="handler",
+                blueprint_types=["blueprintTypes"],
+                dependencies=[synthetics.CfnCanary.DependencyProperty(
+                    reference="reference",
         
-                # the properties below are optional
+                    # the properties below are optional
+                    type="type"
+                )],
+                handler="handler",
                 s3_bucket="s3Bucket",
                 s3_key="s3Key",
                 s3_object_version="s3ObjectVersion",
@@ -1331,7 +1598,10 @@ class CfnCanary(
                 expression="expression",
         
                 # the properties below are optional
-                duration_in_seconds="durationInSeconds"
+                duration_in_seconds="durationInSeconds",
+                retry_config=synthetics.CfnCanary.RetryConfigProperty(
+                    max_retries=123
+                )
             ),
         
             # the properties below are optional
@@ -1341,7 +1611,11 @@ class CfnCanary(
                     kms_key_arn="kmsKeyArn"
                 )
             ),
+            browser_configs=[synthetics.CfnCanary.BrowserConfigProperty(
+                browser_type="browserType"
+            )],
             delete_lambda_resources_on_canary_deletion=False,
+            dry_run_and_update=False,
             failure_retention_period=123,
             provisioned_resource_cleanup="provisionedResourceCleanup",
             resources_to_replicate_tags=["resourcesToReplicateTags"],
@@ -1350,6 +1624,7 @@ class CfnCanary(
                 environment_variables={
                     "environment_variables_key": "environmentVariables"
                 },
+                ephemeral_storage=123,
                 memory_in_mb=123,
                 timeout_in_seconds=123
             ),
@@ -1368,8 +1643,21 @@ class CfnCanary(
         
                     # the properties below are optional
                     ignore_coordinates=["ignoreCoordinates"]
-                )]
+                )],
+                browser_type="browserType"
             ),
+            visual_references=[synthetics.CfnCanary.VisualReferenceProperty(
+                base_canary_run_id="baseCanaryRunId",
+        
+                # the properties below are optional
+                base_screenshots=[synthetics.CfnCanary.BaseScreenshotProperty(
+                    screenshot_name="screenshotName",
+        
+                    # the properties below are optional
+                    ignore_coordinates=["ignoreCoordinates"]
+                )],
+                browser_type="browserType"
+            )],
             vpc_config=synthetics.CfnCanary.VPCConfigProperty(
                 security_group_ids=["securityGroupIds"],
                 subnet_ids=["subnetIds"],
@@ -1393,7 +1681,9 @@ class CfnCanary(
         runtime_version: builtins.str,
         schedule: typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.ScheduleProperty", typing.Dict[builtins.str, typing.Any]]],
         artifact_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.ArtifactConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+        browser_configs: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.BrowserConfigProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         delete_lambda_resources_on_canary_deletion: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        dry_run_and_update: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         failure_retention_period: typing.Optional[jsii.Number] = None,
         provisioned_resource_cleanup: typing.Optional[builtins.str] = None,
         resources_to_replicate_tags: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -1402,9 +1692,11 @@ class CfnCanary(
         success_retention_period: typing.Optional[jsii.Number] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
         visual_reference: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.VisualReferenceProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
+        visual_references: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.VisualReferenceProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         vpc_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.VPCConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::Synthetics::Canary``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param artifact_s3_location: The location in Amazon S3 where Synthetics stores artifacts from the runs of this canary. Artifacts include the log file, screenshots, and HAR files. Specify the full location path, including ``s3://`` at the beginning of the path.
@@ -1414,7 +1706,9 @@ class CfnCanary(
         :param runtime_version: Specifies the runtime version to use for the canary. For more information about runtime versions, see `Canary Runtime Versions <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html>`_ .
         :param schedule: A structure that contains information about how often the canary is to run, and when these runs are to stop.
         :param artifact_config: A structure that contains the configuration for canary artifacts, including the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.
+        :param browser_configs: A structure that specifies the browser type to use for a canary run. CloudWatch Synthetics supports running canaries on both ``CHROME`` and ``FIREFOX`` browsers. .. epigraph:: If not specified, ``browserConfigs`` defaults to Chrome.
         :param delete_lambda_resources_on_canary_deletion: (deprecated) Deletes associated lambda resources created by Synthetics if set to True. Default is False
+        :param dry_run_and_update: Specifies whether to perform a dry run before updating the canary. If set to ``true`` , CloudFormation 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. The default value is ``false`` . For more information, see `Performing safe canary updates <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/performing-safe-canary-upgrades.html>`_ .
         :param failure_retention_period: The number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days. This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
         :param provisioned_resource_cleanup: Specifies whether to also delete the Lambda functions and layers used by this canary when the canary is deleted. If it is ``AUTOMATIC`` , the Lambda functions and layers will be deleted when the canary is deleted. If the value of this parameter is ``OFF`` , then the value of the ``DeleteLambda`` parameter of the `DeleteCanary <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DeleteCanary.html>`_ operation determines whether the Lambda functions and layers will be deleted.
         :param resources_to_replicate_tags: 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 ``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.
@@ -1422,7 +1716,8 @@ class CfnCanary(
         :param start_canary_after_creation: Specify TRUE to have the canary start making runs immediately after it is created. A canary that you create using CloudFormation can't be used to monitor the CloudFormation stack that creates the canary or to roll back that stack if there is a failure.
         :param success_retention_period: The number of days to retain data about successful runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days. This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
         :param tags: The list of key-value pairs that are associated with the canary.
-        :param visual_reference: If this canary performs visual monitoring by comparing screenshots, this structure contains the ID of the canary run to use as the baseline for screenshots, and the coordinates of any parts of the screen to ignore during the visual monitoring comparison.
+        :param visual_reference: 
+        :param visual_references: A list of visual reference configurations for the canary, one for each browser type that the canary is configured to run on. Visual references are used for visual monitoring comparisons. ``syn-nodejs-puppeteer-11.0`` and above, and ``syn-nodejs-playwright-3.0`` and above, only supports ``visualReferences`` . ``visualReference`` field is not supported. Versions older than ``syn-nodejs-puppeteer-11.0`` supports both ``visualReference`` and ``visualReferences`` for backward compatibility. It is recommended to use ``visualReferences`` for consistency and future compatibility.
         :param vpc_config: If this canary is to test an endpoint in a VPC, this structure contains information about the subnet and security groups of the VPC endpoint. For more information, see `Running a Canary in a VPC <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html>`_ .
         '''
         if __debug__:
@@ -1437,7 +1732,9 @@ class CfnCanary(
             runtime_version=runtime_version,
             schedule=schedule,
             artifact_config=artifact_config,
+            browser_configs=browser_configs,
             delete_lambda_resources_on_canary_deletion=delete_lambda_resources_on_canary_deletion,
+            dry_run_and_update=dry_run_and_update,
             failure_retention_period=failure_retention_period,
             provisioned_resource_cleanup=provisioned_resource_cleanup,
             resources_to_replicate_tags=resources_to_replicate_tags,
@@ -1446,11 +1743,33 @@ class CfnCanary(
             success_retention_period=success_retention_period,
             tags=tags,
             visual_reference=visual_reference,
+            visual_references=visual_references,
             vpc_config=vpc_config,
         )
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromCanaryName")
+    @builtins.classmethod
+    def from_canary_name(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        canary_name: builtins.str,
+    ) -> _ICanaryRef_cf407e49:
+        '''Creates a new ICanaryRef from a canaryName.
+
+        :param scope: -
+        :param id: -
+        :param canary_name: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__a9ea9a4c62ed507734c1656b5b5b9ece24a5a15e32aa598350d8dcba80710c99)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+            check_type(argname="argument canary_name", value=canary_name, expected_type=type_hints["canary_name"])
+        return typing.cast(_ICanaryRef_cf407e49, jsii.sinvoke(cls, "fromCanaryName", [scope, id, canary_name]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -1510,6 +1829,12 @@ class CfnCanary(
         '''
         return typing.cast(builtins.str, jsii.get(self, "attrState"))
 
+    @builtins.property
+    @jsii.member(jsii_name="canaryRef")
+    def canary_ref(self) -> _CanaryReference_fbbe85ce:
+        '''A reference to a Canary resource.'''
+        return typing.cast(_CanaryReference_fbbe85ce, jsii.get(self, "canaryRef"))
+
     @builtins.property
     @jsii.member(jsii_name="cfnProperties")
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
@@ -1625,6 +1950,24 @@ class CfnCanary(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "artifactConfig", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="browserConfigs")
+    def browser_configs(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.BrowserConfigProperty"]]]]:
+        '''A structure that specifies the browser type to use for a canary run.'''
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.BrowserConfigProperty"]]]], jsii.get(self, "browserConfigs"))
+
+    @browser_configs.setter
+    def browser_configs(
+        self,
+        value: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.BrowserConfigProperty"]]]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__91233a90f3d4d918352b4597b2dee50c3da02176501744c2dc696dbd8a735b68)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "browserConfigs", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="deleteLambdaResourcesOnCanaryDeletion")
     def delete_lambda_resources_on_canary_deletion(
@@ -1648,6 +1991,24 @@ class CfnCanary(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "deleteLambdaResourcesOnCanaryDeletion", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="dryRunAndUpdate")
+    def dry_run_and_update(
+        self,
+    ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
+        '''Specifies whether to perform a dry run before updating the canary.'''
+        return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "dryRunAndUpdate"))
+
+    @dry_run_and_update.setter
+    def dry_run_and_update(
+        self,
+        value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__59860e5fb72da4da1108545c9e0b8f706d34cf83eb363fda05f04cbb14baf1fe)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "dryRunAndUpdate", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="failureRetentionPeriod")
     def failure_retention_period(self) -> typing.Optional[jsii.Number]:
@@ -1760,7 +2121,11 @@ class CfnCanary(
     def visual_reference(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCanary.VisualReferenceProperty"]]:
-        '''If this canary performs visual monitoring by comparing screenshots, this structure contains the ID of the canary run to use as the baseline for screenshots, and the coordinates of any parts of the screen to ignore during the visual monitoring comparison.'''
+        '''
+        :deprecated: this property has been deprecated
+
+        :stability: deprecated
+        '''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCanary.VisualReferenceProperty"]], jsii.get(self, "visualReference"))
 
     @visual_reference.setter
@@ -1773,6 +2138,24 @@ class CfnCanary(
             check_type(argname="argument value", value=value, expected_type=type_hints["value"])
         jsii.set(self, "visualReference", value) # pyright: ignore[reportArgumentType]
 
+    @builtins.property
+    @jsii.member(jsii_name="visualReferences")
+    def visual_references(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.VisualReferenceProperty"]]]]:
+        '''A list of visual reference configurations for the canary, one for each browser type that the canary is configured to run on.'''
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.VisualReferenceProperty"]]]], jsii.get(self, "visualReferences"))
+
+    @visual_references.setter
+    def visual_references(
+        self,
+        value: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.VisualReferenceProperty"]]]],
+    ) -> None:
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__004341f5a58c9e6e190c4bc518ea476aac62201a1708bb1650a22fbf74c64b52)
+            check_type(argname="argument value", value=value, expected_type=type_hints["value"])
+        jsii.set(self, "visualReferences", value) # pyright: ignore[reportArgumentType]
+
     @builtins.property
     @jsii.member(jsii_name="vpcConfig")
     def vpc_config(
@@ -1933,10 +2316,64 @@ class CfnCanary(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_synthetics.CfnCanary.BrowserConfigProperty",
+        jsii_struct_bases=[],
+        name_mapping={"browser_type": "browserType"},
+    )
+    class BrowserConfigProperty:
+        def __init__(self, *, browser_type: builtins.str) -> None:
+            '''A structure that specifies the browser type to use for a canary run.
+
+            :param browser_type: The browser type associated with this browser configuration.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-browserconfig.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_synthetics as synthetics
+                
+                browser_config_property = synthetics.CfnCanary.BrowserConfigProperty(
+                    browser_type="browserType"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__c91e35c3c240434fee052d7f899893609a9c027813412eb6312483e200412435)
+                check_type(argname="argument browser_type", value=browser_type, expected_type=type_hints["browser_type"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {
+                "browser_type": browser_type,
+            }
+
+        @builtins.property
+        def browser_type(self) -> builtins.str:
+            '''The browser type associated with this browser configuration.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-browserconfig.html#cfn-synthetics-canary-browserconfig-browsertype
+            '''
+            result = self._values.get("browser_type")
+            assert result is not None, "Required property 'browser_type' is missing"
+            return typing.cast(builtins.str, result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "BrowserConfigProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
     @jsii.data_type(
         jsii_type="aws-cdk-lib.aws_synthetics.CfnCanary.CodeProperty",
         jsii_struct_bases=[],
         name_mapping={
+            "blueprint_types": "blueprintTypes",
+            "dependencies": "dependencies",
             "handler": "handler",
             "s3_bucket": "s3Bucket",
             "s3_key": "s3Key",
@@ -1949,7 +2386,9 @@ class CfnCanary(
         def __init__(
             self,
             *,
-            handler: builtins.str,
+            blueprint_types: typing.Optional[typing.Sequence[builtins.str]] = None,
+            dependencies: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.DependencyProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
+            handler: typing.Optional[builtins.str] = None,
             s3_bucket: typing.Optional[builtins.str] = None,
             s3_key: typing.Optional[builtins.str] = None,
             s3_object_version: typing.Optional[builtins.str] = None,
@@ -1960,10 +2399,12 @@ class CfnCanary(
 
             This structure contains the Lambda handler with the location where the canary should start running the script. If the script is stored in an S3 bucket, the bucket name, key, and version are also included. If the script is passed into the canary directly, the script code is contained in the value of ``Script`` .
 
-            :param handler: The entry point to use for the source code when running the canary. For canaries that use the ``syn-python-selenium-1.0`` runtime or a ``syn-nodejs.puppeteer`` runtime earlier than ``syn-nodejs.puppeteer-3.4`` , the handler must be specified as ``*fileName* .handler`` . For ``syn-python-selenium-1.1`` , ``syn-nodejs.puppeteer-3.4`` , and later runtimes, the handler can be specified as ``*fileName* . *functionName*`` , or you can specify a folder where canary scripts reside as ``*folder* / *fileName* . *functionName*`` .
+            :param blueprint_types: ``BlueprintTypes`` are a list of templates that enable simplified canary creation. You can create canaries for common monitoring scenarios by providing only a JSON configuration file instead of writing custom scripts. ``multi-checks`` is the only supported value. When you specify ``BlueprintTypes`` , the ``Handler`` field cannot be specified since the blueprint provides a pre-defined entry point.
+            :param dependencies: List of Lambda layers to attach to the canary.
+            :param handler: The entry point to use for the source code when running the canary. For canaries that use the ``syn-python-selenium-1.0`` runtime or a ``syn-nodejs.puppeteer`` runtime earlier than ``syn-nodejs.puppeteer-3.4`` , the handler must be specified as ``*fileName* .handler`` . For ``syn-python-selenium-1.1`` , ``syn-nodejs.puppeteer-3.4`` , and later runtimes, the handler can be specified as ``*fileName* . *functionName*`` , or you can specify a folder where canary scripts reside as ``*folder* / *fileName* . *functionName*`` . This field is required when you don't specify ``BlueprintTypes`` and is not allowed when you specify ``BlueprintTypes`` .
             :param s3_bucket: If your canary script is located in S3, specify the bucket name here. The bucket must already exist.
-            :param s3_key: The S3 key of your script. For more information, see `Working with Amazon S3 Objects <https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingObjects.html>`_ .
-            :param s3_object_version: The S3 version ID of your script.
+            :param s3_key: The Amazon S3 key of your script. For more information, see `Working with Amazon S3 Objects <https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingObjects.html>`_ .
+            :param s3_object_version: The Amazon S3 version ID of your script.
             :param script: If you input your canary script directly into the canary instead of referring to an S3 location, the value of this parameter is the script in plain text. It can be up to 5 MB.
             :param source_location_arn: The ARN of the Lambda layer where Synthetics stores the canary script code.
 
@@ -1977,9 +2418,14 @@ class CfnCanary(
                 from aws_cdk import aws_synthetics as synthetics
                 
                 code_property = synthetics.CfnCanary.CodeProperty(
-                    handler="handler",
+                    blueprint_types=["blueprintTypes"],
+                    dependencies=[synthetics.CfnCanary.DependencyProperty(
+                        reference="reference",
                 
-                    # the properties below are optional
+                        # the properties below are optional
+                        type="type"
+                    )],
+                    handler="handler",
                     s3_bucket="s3Bucket",
                     s3_key="s3Key",
                     s3_object_version="s3ObjectVersion",
@@ -1989,88 +2435,250 @@ class CfnCanary(
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__3d403372a613babc1ab10717d050ec9a7f4055961f3545f2d0600d89c7b3dcc3)
+                check_type(argname="argument blueprint_types", value=blueprint_types, expected_type=type_hints["blueprint_types"])
+                check_type(argname="argument dependencies", value=dependencies, expected_type=type_hints["dependencies"])
                 check_type(argname="argument handler", value=handler, expected_type=type_hints["handler"])
                 check_type(argname="argument s3_bucket", value=s3_bucket, expected_type=type_hints["s3_bucket"])
                 check_type(argname="argument s3_key", value=s3_key, expected_type=type_hints["s3_key"])
                 check_type(argname="argument s3_object_version", value=s3_object_version, expected_type=type_hints["s3_object_version"])
                 check_type(argname="argument script", value=script, expected_type=type_hints["script"])
                 check_type(argname="argument source_location_arn", value=source_location_arn, expected_type=type_hints["source_location_arn"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {}
+            if blueprint_types is not None:
+                self._values["blueprint_types"] = blueprint_types
+            if dependencies is not None:
+                self._values["dependencies"] = dependencies
+            if handler is not None:
+                self._values["handler"] = handler
+            if s3_bucket is not None:
+                self._values["s3_bucket"] = s3_bucket
+            if s3_key is not None:
+                self._values["s3_key"] = s3_key
+            if s3_object_version is not None:
+                self._values["s3_object_version"] = s3_object_version
+            if script is not None:
+                self._values["script"] = script
+            if source_location_arn is not None:
+                self._values["source_location_arn"] = source_location_arn
+
+        @builtins.property
+        def blueprint_types(self) -> typing.Optional[typing.List[builtins.str]]:
+            '''``BlueprintTypes`` are a list of templates that enable simplified canary creation.
+
+            You can create canaries for common monitoring scenarios by providing only a JSON configuration file instead of writing custom scripts. ``multi-checks`` is the only supported value.
+
+            When you specify ``BlueprintTypes`` , the ``Handler`` field cannot be specified since the blueprint provides a pre-defined entry point.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-blueprinttypes
+            '''
+            result = self._values.get("blueprint_types")
+            return typing.cast(typing.Optional[typing.List[builtins.str]], result)
+
+        @builtins.property
+        def dependencies(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.DependencyProperty"]]]]:
+            '''List of Lambda layers to attach to the canary.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-dependencies
+            '''
+            result = self._values.get("dependencies")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.DependencyProperty"]]]], result)
+
+        @builtins.property
+        def handler(self) -> typing.Optional[builtins.str]:
+            '''The entry point to use for the source code when running the canary.
+
+            For canaries that use the ``syn-python-selenium-1.0`` runtime or a ``syn-nodejs.puppeteer`` runtime earlier than ``syn-nodejs.puppeteer-3.4`` , the handler must be specified as ``*fileName* .handler`` . For ``syn-python-selenium-1.1`` , ``syn-nodejs.puppeteer-3.4`` , and later runtimes, the handler can be specified as ``*fileName* . *functionName*`` , or you can specify a folder where canary scripts reside as ``*folder* / *fileName* . *functionName*`` .
+
+            This field is required when you don't specify ``BlueprintTypes`` and is not allowed when you specify ``BlueprintTypes`` .
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-handler
+            '''
+            result = self._values.get("handler")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def s3_bucket(self) -> typing.Optional[builtins.str]:
+            '''If your canary script is located in S3, specify the bucket name here.
+
+            The bucket must already exist.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-s3bucket
+            '''
+            result = self._values.get("s3_bucket")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def s3_key(self) -> typing.Optional[builtins.str]:
+            '''The Amazon S3 key of your script.
+
+            For more information, see `Working with Amazon S3 Objects <https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingObjects.html>`_ .
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-s3key
+            '''
+            result = self._values.get("s3_key")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def s3_object_version(self) -> typing.Optional[builtins.str]:
+            '''The Amazon S3 version ID of your script.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-s3objectversion
+            '''
+            result = self._values.get("s3_object_version")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def script(self) -> typing.Optional[builtins.str]:
+            '''If you input your canary script directly into the canary instead of referring to an S3 location, the value of this parameter is the script in plain text.
+
+            It can be up to 5 MB.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-script
+            '''
+            result = self._values.get("script")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        @builtins.property
+        def source_location_arn(self) -> typing.Optional[builtins.str]:
+            '''The ARN of the Lambda layer where Synthetics stores the canary script code.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-sourcelocationarn
+            '''
+            result = self._values.get("source_location_arn")
+            return typing.cast(typing.Optional[builtins.str], result)
+
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
+
+        def __repr__(self) -> str:
+            return "CodeProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
+
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_synthetics.CfnCanary.DependencyProperty",
+        jsii_struct_bases=[],
+        name_mapping={"reference": "reference", "type": "type"},
+    )
+    class DependencyProperty:
+        def __init__(
+            self,
+            *,
+            reference: builtins.str,
+            type: typing.Optional[builtins.str] = None,
+        ) -> None:
+            '''A structure that contains information about a dependency for a canary.
+
+            :param reference: The dependency reference. For Lambda layers, this is the ARN of the Lambda layer. For more information about Lambda ARN format, see `Lambda <https://docs.aws.amazon.com/lambda/latest/api/API_Layer.html>`_ .
+            :param type: The type of dependency. Valid value is ``LambdaLayer`` .
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-dependency.html
+            :exampleMetadata: fixture=_generated
+
+            Example::
+
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_synthetics as synthetics
+                
+                dependency_property = synthetics.CfnCanary.DependencyProperty(
+                    reference="reference",
+                
+                    # the properties below are optional
+                    type="type"
+                )
+            '''
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__02338e317b0b84f714774aabea98599cd96fe9cff23790733ad426e75f9984f4)
+                check_type(argname="argument reference", value=reference, expected_type=type_hints["reference"])
+                check_type(argname="argument type", value=type, expected_type=type_hints["type"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
-                "handler": handler,
+                "reference": reference,
             }
-            if s3_bucket is not None:
-                self._values["s3_bucket"] = s3_bucket
-            if s3_key is not None:
-                self._values["s3_key"] = s3_key
-            if s3_object_version is not None:
-                self._values["s3_object_version"] = s3_object_version
-            if script is not None:
-                self._values["script"] = script
-            if source_location_arn is not None:
-                self._values["source_location_arn"] = source_location_arn
+            if type is not None:
+                self._values["type"] = type
 
         @builtins.property
-        def handler(self) -> builtins.str:
-            '''The entry point to use for the source code when running the canary.
+        def reference(self) -> builtins.str:
+            '''The dependency reference.
 
-            For canaries that use the ``syn-python-selenium-1.0`` runtime or a ``syn-nodejs.puppeteer`` runtime earlier than ``syn-nodejs.puppeteer-3.4`` , the handler must be specified as ``*fileName* .handler`` . For ``syn-python-selenium-1.1`` , ``syn-nodejs.puppeteer-3.4`` , and later runtimes, the handler can be specified as ``*fileName* . *functionName*`` , or you can specify a folder where canary scripts reside as ``*folder* / *fileName* . *functionName*`` .
+            For Lambda layers, this is the ARN of the Lambda layer. For more information about Lambda ARN format, see `Lambda <https://docs.aws.amazon.com/lambda/latest/api/API_Layer.html>`_ .
 
-            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-handler
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-dependency.html#cfn-synthetics-canary-dependency-reference
             '''
-            result = self._values.get("handler")
-            assert result is not None, "Required property 'handler' is missing"
+            result = self._values.get("reference")
+            assert result is not None, "Required property 'reference' is missing"
             return typing.cast(builtins.str, result)
 
         @builtins.property
-        def s3_bucket(self) -> typing.Optional[builtins.str]:
-            '''If your canary script is located in S3, specify the bucket name here.
+        def type(self) -> typing.Optional[builtins.str]:
+            '''The type of dependency.
 
-            The bucket must already exist.
+            Valid value is ``LambdaLayer`` .
 
-            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-s3bucket
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-dependency.html#cfn-synthetics-canary-dependency-type
             '''
-            result = self._values.get("s3_bucket")
+            result = self._values.get("type")
             return typing.cast(typing.Optional[builtins.str], result)
 
-        @builtins.property
-        def s3_key(self) -> typing.Optional[builtins.str]:
-            '''The S3 key of your script.
+        def __eq__(self, rhs: typing.Any) -> builtins.bool:
+            return isinstance(rhs, self.__class__) and rhs._values == self._values
 
-            For more information, see `Working with Amazon S3 Objects <https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingObjects.html>`_ .
+        def __ne__(self, rhs: typing.Any) -> builtins.bool:
+            return not (rhs == self)
 
-            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-s3key
-            '''
-            result = self._values.get("s3_key")
-            return typing.cast(typing.Optional[builtins.str], result)
+        def __repr__(self) -> str:
+            return "DependencyProperty(%s)" % ", ".join(
+                k + "=" + repr(v) for k, v in self._values.items()
+            )
 
-        @builtins.property
-        def s3_object_version(self) -> typing.Optional[builtins.str]:
-            '''The S3 version ID of your script.
+    @jsii.data_type(
+        jsii_type="aws-cdk-lib.aws_synthetics.CfnCanary.RetryConfigProperty",
+        jsii_struct_bases=[],
+        name_mapping={"max_retries": "maxRetries"},
+    )
+    class RetryConfigProperty:
+        def __init__(self, *, max_retries: jsii.Number) -> None:
+            '''The canary's retry configuration information.
 
-            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-s3objectversion
-            '''
-            result = self._values.get("s3_object_version")
-            return typing.cast(typing.Optional[builtins.str], result)
+            :param max_retries: The maximum number of retries. The value must be less than or equal to two.
 
-        @builtins.property
-        def script(self) -> typing.Optional[builtins.str]:
-            '''If you input your canary script directly into the canary instead of referring to an S3 location, the value of this parameter is the script in plain text.
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-retryconfig.html
+            :exampleMetadata: fixture=_generated
 
-            It can be up to 5 MB.
+            Example::
 
-            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-script
+                # The code below shows an example of how to instantiate this type.
+                # The values are placeholders you should change.
+                from aws_cdk import aws_synthetics as synthetics
+                
+                retry_config_property = synthetics.CfnCanary.RetryConfigProperty(
+                    max_retries=123
+                )
             '''
-            result = self._values.get("script")
-            return typing.cast(typing.Optional[builtins.str], result)
+            if __debug__:
+                type_hints = typing.get_type_hints(_typecheckingstub__e7a2c989ca2c701e49af0e8032c8c49bb52546c68c9e6359df8e7a9f2c4cf9a1)
+                check_type(argname="argument max_retries", value=max_retries, expected_type=type_hints["max_retries"])
+            self._values: typing.Dict[builtins.str, typing.Any] = {
+                "max_retries": max_retries,
+            }
 
         @builtins.property
-        def source_location_arn(self) -> typing.Optional[builtins.str]:
-            '''The ARN of the Lambda layer where Synthetics stores the canary script code.
+        def max_retries(self) -> jsii.Number:
+            '''The maximum number of retries.
 
-            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-code.html#cfn-synthetics-canary-code-sourcelocationarn
+            The value must be less than or equal to two.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-retryconfig.html#cfn-synthetics-canary-retryconfig-maxretries
             '''
-            result = self._values.get("source_location_arn")
-            return typing.cast(typing.Optional[builtins.str], result)
+            result = self._values.get("max_retries")
+            assert result is not None, "Required property 'max_retries' is missing"
+            return typing.cast(jsii.Number, result)
 
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -2079,7 +2687,7 @@ class CfnCanary(
             return not (rhs == self)
 
         def __repr__(self) -> str:
-            return "CodeProperty(%s)" % ", ".join(
+            return "RetryConfigProperty(%s)" % ", ".join(
                 k + "=" + repr(v) for k, v in self._values.items()
             )
 
@@ -2089,6 +2697,7 @@ class CfnCanary(
         name_mapping={
             "active_tracing": "activeTracing",
             "environment_variables": "environmentVariables",
+            "ephemeral_storage": "ephemeralStorage",
             "memory_in_mb": "memoryInMb",
             "timeout_in_seconds": "timeoutInSeconds",
         },
@@ -2099,6 +2708,7 @@ class CfnCanary(
             *,
             active_tracing: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
             environment_variables: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
+            ephemeral_storage: typing.Optional[jsii.Number] = None,
             memory_in_mb: typing.Optional[jsii.Number] = None,
             timeout_in_seconds: typing.Optional[jsii.Number] = None,
         ) -> None:
@@ -2108,6 +2718,7 @@ class CfnCanary(
 
             :param active_tracing: Specifies whether this canary is to use active AWS X-Ray tracing when it runs. Active tracing enables this canary run to be displayed in the ServiceLens and X-Ray service maps even if the canary does not hit an endpoint that has X-Ray tracing enabled. Using X-Ray tracing incurs charges. For more information, see `Canaries and X-Ray tracing <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_tracing.html>`_ . You can enable active tracing only for canaries that use version ``syn-nodejs-2.0`` or later for their canary runtime.
             :param environment_variables: Specifies the keys and values to use for any environment variables used in the canary script. Use the following format: { "key1" : "value1", "key2" : "value2", ...} Keys must start with a letter and be at least two characters. The total size of your environment variables cannot exceed 4 KB. You can't specify any Lambda reserved environment variables as the keys for your environment variables. For more information about reserved keys, see `Runtime environment variables <https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-runtime>`_ .
+            :param ephemeral_storage: Specifies the amount of ephemeral storage (in MB) to allocate for the canary run during execution. This temporary storage is used for storing canary run artifacts (which are uploaded to an Amazon S3 bucket at the end of the run), and any canary browser operations. This temporary storage is cleared after the run is completed. Default storage value is 1024 MB.
             :param memory_in_mb: The maximum amount of memory that the canary can use while running. This value must be a multiple of 64. The range is 960 to 3008.
             :param timeout_in_seconds: How long the canary is allowed to run before it must stop. You can't set this time to be longer than the frequency of the runs of this canary. If you omit this field, the frequency of the canary is used as this value, up to a maximum of 900 seconds.
 
@@ -2125,6 +2736,7 @@ class CfnCanary(
                     environment_variables={
                         "environment_variables_key": "environmentVariables"
                     },
+                    ephemeral_storage=123,
                     memory_in_mb=123,
                     timeout_in_seconds=123
                 )
@@ -2133,6 +2745,7 @@ class CfnCanary(
                 type_hints = typing.get_type_hints(_typecheckingstub__fa148862e82948accbbe951e7afcee721aa7014754c81106d2648fe1c5cf28e2)
                 check_type(argname="argument active_tracing", value=active_tracing, expected_type=type_hints["active_tracing"])
                 check_type(argname="argument environment_variables", value=environment_variables, expected_type=type_hints["environment_variables"])
+                check_type(argname="argument ephemeral_storage", value=ephemeral_storage, expected_type=type_hints["ephemeral_storage"])
                 check_type(argname="argument memory_in_mb", value=memory_in_mb, expected_type=type_hints["memory_in_mb"])
                 check_type(argname="argument timeout_in_seconds", value=timeout_in_seconds, expected_type=type_hints["timeout_in_seconds"])
             self._values: typing.Dict[builtins.str, typing.Any] = {}
@@ -2140,6 +2753,8 @@ class CfnCanary(
                 self._values["active_tracing"] = active_tracing
             if environment_variables is not None:
                 self._values["environment_variables"] = environment_variables
+            if ephemeral_storage is not None:
+                self._values["ephemeral_storage"] = ephemeral_storage
             if memory_in_mb is not None:
                 self._values["memory_in_mb"] = memory_in_mb
             if timeout_in_seconds is not None:
@@ -2177,6 +2792,17 @@ class CfnCanary(
             result = self._values.get("environment_variables")
             return typing.cast(typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]], result)
 
+        @builtins.property
+        def ephemeral_storage(self) -> typing.Optional[jsii.Number]:
+            '''Specifies the amount of ephemeral storage (in MB) to allocate for the canary run during execution.
+
+            This temporary storage is used for storing canary run artifacts (which are uploaded to an Amazon S3 bucket at the end of the run), and any canary browser operations. This temporary storage is cleared after the run is completed. Default storage value is 1024 MB.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-runconfig.html#cfn-synthetics-canary-runconfig-ephemeralstorage
+            '''
+            result = self._values.get("ephemeral_storage")
+            return typing.cast(typing.Optional[jsii.Number], result)
+
         @builtins.property
         def memory_in_mb(self) -> typing.Optional[jsii.Number]:
             '''The maximum amount of memory that the canary can use while running.
@@ -2294,6 +2920,7 @@ class CfnCanary(
         name_mapping={
             "expression": "expression",
             "duration_in_seconds": "durationInSeconds",
+            "retry_config": "retryConfig",
         },
     )
     class ScheduleProperty:
@@ -2302,11 +2929,13 @@ class CfnCanary(
             *,
             expression: builtins.str,
             duration_in_seconds: typing.Optional[builtins.str] = None,
+            retry_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.RetryConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
             '''This structure specifies how often a canary is to make runs and the date and time when it should stop making runs.
 
             :param expression: A ``rate`` expression or a ``cron`` expression that defines how often the canary is to run. For a rate expression, The syntax is ``rate( *number unit* )`` . *unit* can be ``minute`` , ``minutes`` , or ``hour`` . For example, ``rate(1 minute)`` runs the canary once a minute, ``rate(10 minutes)`` runs it once every 10 minutes, and ``rate(1 hour)`` runs it once every hour. You can specify a frequency between ``rate(1 minute)`` and ``rate(1 hour)`` . Specifying ``rate(0 minute)`` or ``rate(0 hour)`` is a special value that causes the canary to run only once when it is started. Use ``cron( *expression* )`` to specify a cron expression. You can't schedule a canary to wait for more than a year before running. For information about the syntax for cron expressions, see `Scheduling canary runs using cron <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_cron.html>`_ .
             :param duration_in_seconds: How long, in seconds, for the canary to continue making regular runs according to the schedule in the ``Expression`` value. If you specify 0, the canary continues making runs until you stop it. If you omit this field, the default of 0 is used.
+            :param retry_config: The canary's retry configuration information.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-schedule.html
             :exampleMetadata: fixture=_generated
@@ -2321,18 +2950,24 @@ class CfnCanary(
                     expression="expression",
                 
                     # the properties below are optional
-                    duration_in_seconds="durationInSeconds"
+                    duration_in_seconds="durationInSeconds",
+                    retry_config=synthetics.CfnCanary.RetryConfigProperty(
+                        max_retries=123
+                    )
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__e4999288d0e0c5de04c56a3436208778026602dfdca27710aee93f9f4e034c29)
                 check_type(argname="argument expression", value=expression, expected_type=type_hints["expression"])
                 check_type(argname="argument duration_in_seconds", value=duration_in_seconds, expected_type=type_hints["duration_in_seconds"])
+                check_type(argname="argument retry_config", value=retry_config, expected_type=type_hints["retry_config"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "expression": expression,
             }
             if duration_in_seconds is not None:
                 self._values["duration_in_seconds"] = duration_in_seconds
+            if retry_config is not None:
+                self._values["retry_config"] = retry_config
 
         @builtins.property
         def expression(self) -> builtins.str:
@@ -2363,6 +2998,17 @@ class CfnCanary(
             result = self._values.get("duration_in_seconds")
             return typing.cast(typing.Optional[builtins.str], result)
 
+        @builtins.property
+        def retry_config(
+            self,
+        ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCanary.RetryConfigProperty"]]:
+            '''The canary's retry configuration information.
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-schedule.html#cfn-synthetics-canary-schedule-retryconfig
+            '''
+            result = self._values.get("retry_config")
+            return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnCanary.RetryConfigProperty"]], result)
+
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -2399,7 +3045,7 @@ class CfnCanary(
 
             :param security_group_ids: The IDs of the security groups for this canary.
             :param subnet_ids: The IDs of the subnets where this canary is to run.
-            :param ipv6_allowed_for_dual_stack: Allow outbound IPv6 traffic on VPC canaries that are connected to dual-stack subnets if set to true.
+            :param ipv6_allowed_for_dual_stack: Set this to ``true`` to allow outbound IPv6 traffic on VPC canaries that are connected to dual-stack subnets. The default is ``false`` .
             :param vpc_id: The ID of the VPC where this canary is to run.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-vpcconfig.html
@@ -2459,7 +3105,9 @@ class CfnCanary(
         def ipv6_allowed_for_dual_stack(
             self,
         ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-            '''Allow outbound IPv6 traffic on VPC canaries that are connected to dual-stack subnets if set to true.
+            '''Set this to ``true`` to allow outbound IPv6 traffic on VPC canaries that are connected to dual-stack subnets.
+
+            The default is ``false`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-vpcconfig.html#cfn-synthetics-canary-vpcconfig-ipv6allowedfordualstack
             '''
@@ -2492,6 +3140,7 @@ class CfnCanary(
         name_mapping={
             "base_canary_run_id": "baseCanaryRunId",
             "base_screenshots": "baseScreenshots",
+            "browser_type": "browserType",
         },
     )
     class VisualReferenceProperty:
@@ -2500,6 +3149,7 @@ class CfnCanary(
             *,
             base_canary_run_id: builtins.str,
             base_screenshots: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnCanary.BaseScreenshotProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
+            browser_type: typing.Optional[builtins.str] = None,
         ) -> None:
             '''Defines the screenshots to use as the baseline for comparisons during visual monitoring comparisons during future runs of this canary.
 
@@ -2509,6 +3159,7 @@ class CfnCanary(
 
             :param base_canary_run_id: Specifies which canary run to use the screenshots from as the baseline for future visual monitoring with this canary. Valid values are ``nextrun`` to use the screenshots from the next run after this update is made, ``lastrun`` to use the screenshots from the most recent run before this update was made, or the value of ``Id`` in the `CanaryRun <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_CanaryRun.html>`_ from any past run of this canary.
             :param base_screenshots: An array of screenshots that are used as the baseline for comparisons during visual monitoring.
+            :param browser_type: The browser type associated with this visual reference configuration. Valid values are ``CHROME`` and ``FIREFOX`` .
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-visualreference.html
             :exampleMetadata: fixture=_generated
@@ -2528,18 +3179,22 @@ class CfnCanary(
                 
                         # the properties below are optional
                         ignore_coordinates=["ignoreCoordinates"]
-                    )]
+                    )],
+                    browser_type="browserType"
                 )
             '''
             if __debug__:
                 type_hints = typing.get_type_hints(_typecheckingstub__f52b6b7318141dc99f6bd36c21b91cda286b67d7dea805791a6132a2cd794526)
                 check_type(argname="argument base_canary_run_id", value=base_canary_run_id, expected_type=type_hints["base_canary_run_id"])
                 check_type(argname="argument base_screenshots", value=base_screenshots, expected_type=type_hints["base_screenshots"])
+                check_type(argname="argument browser_type", value=browser_type, expected_type=type_hints["browser_type"])
             self._values: typing.Dict[builtins.str, typing.Any] = {
                 "base_canary_run_id": base_canary_run_id,
             }
             if base_screenshots is not None:
                 self._values["base_screenshots"] = base_screenshots
+            if browser_type is not None:
+                self._values["browser_type"] = browser_type
 
         @builtins.property
         def base_canary_run_id(self) -> builtins.str:
@@ -2564,6 +3219,17 @@ class CfnCanary(
             result = self._values.get("base_screenshots")
             return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, "CfnCanary.BaseScreenshotProperty"]]]], result)
 
+        @builtins.property
+        def browser_type(self) -> typing.Optional[builtins.str]:
+            '''The browser type associated with this visual reference configuration.
+
+            Valid values are ``CHROME`` and ``FIREFOX`` .
+
+            :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-synthetics-canary-visualreference.html#cfn-synthetics-canary-visualreference-browsertype
+            '''
+            result = self._values.get("browser_type")
+            return typing.cast(typing.Optional[builtins.str], result)
+
         def __eq__(self, rhs: typing.Any) -> builtins.bool:
             return isinstance(rhs, self.__class__) and rhs._values == self._values
 
@@ -2587,7 +3253,9 @@ class CfnCanary(
         "runtime_version": "runtimeVersion",
         "schedule": "schedule",
         "artifact_config": "artifactConfig",
+        "browser_configs": "browserConfigs",
         "delete_lambda_resources_on_canary_deletion": "deleteLambdaResourcesOnCanaryDeletion",
+        "dry_run_and_update": "dryRunAndUpdate",
         "failure_retention_period": "failureRetentionPeriod",
         "provisioned_resource_cleanup": "provisionedResourceCleanup",
         "resources_to_replicate_tags": "resourcesToReplicateTags",
@@ -2596,6 +3264,7 @@ class CfnCanary(
         "success_retention_period": "successRetentionPeriod",
         "tags": "tags",
         "visual_reference": "visualReference",
+        "visual_references": "visualReferences",
         "vpc_config": "vpcConfig",
     },
 )
@@ -2610,7 +3279,9 @@ class CfnCanaryProps:
         runtime_version: builtins.str,
         schedule: typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.ScheduleProperty, typing.Dict[builtins.str, typing.Any]]],
         artifact_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.ArtifactConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+        browser_configs: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.BrowserConfigProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
         delete_lambda_resources_on_canary_deletion: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+        dry_run_and_update: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         failure_retention_period: typing.Optional[jsii.Number] = None,
         provisioned_resource_cleanup: typing.Optional[builtins.str] = None,
         resources_to_replicate_tags: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -2619,6 +3290,7 @@ class CfnCanaryProps:
         success_retention_period: typing.Optional[jsii.Number] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
         visual_reference: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VisualReferenceProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+        visual_references: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VisualReferenceProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
         vpc_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VPCConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
         '''Properties for defining a ``CfnCanary``.
@@ -2630,7 +3302,9 @@ class CfnCanaryProps:
         :param runtime_version: Specifies the runtime version to use for the canary. For more information about runtime versions, see `Canary Runtime Versions <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_Library.html>`_ .
         :param schedule: A structure that contains information about how often the canary is to run, and when these runs are to stop.
         :param artifact_config: A structure that contains the configuration for canary artifacts, including the encryption-at-rest settings for artifacts that the canary uploads to Amazon S3.
+        :param browser_configs: A structure that specifies the browser type to use for a canary run. CloudWatch Synthetics supports running canaries on both ``CHROME`` and ``FIREFOX`` browsers. .. epigraph:: If not specified, ``browserConfigs`` defaults to Chrome.
         :param delete_lambda_resources_on_canary_deletion: (deprecated) Deletes associated lambda resources created by Synthetics if set to True. Default is False
+        :param dry_run_and_update: Specifies whether to perform a dry run before updating the canary. If set to ``true`` , CloudFormation 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. The default value is ``false`` . For more information, see `Performing safe canary updates <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/performing-safe-canary-upgrades.html>`_ .
         :param failure_retention_period: The number of days to retain data about failed runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days. This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
         :param provisioned_resource_cleanup: Specifies whether to also delete the Lambda functions and layers used by this canary when the canary is deleted. If it is ``AUTOMATIC`` , the Lambda functions and layers will be deleted when the canary is deleted. If the value of this parameter is ``OFF`` , then the value of the ``DeleteLambda`` parameter of the `DeleteCanary <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_DeleteCanary.html>`_ operation determines whether the Lambda functions and layers will be deleted.
         :param resources_to_replicate_tags: 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 ``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.
@@ -2638,7 +3312,8 @@ class CfnCanaryProps:
         :param start_canary_after_creation: Specify TRUE to have the canary start making runs immediately after it is created. A canary that you create using CloudFormation can't be used to monitor the CloudFormation stack that creates the canary or to roll back that stack if there is a failure.
         :param success_retention_period: The number of days to retain data about successful runs of this canary. If you omit this field, the default of 31 days is used. The valid range is 1 to 455 days. This setting affects the range of information returned by `GetCanaryRuns <https://docs.aws.amazon.com/AmazonSynthetics/latest/APIReference/API_GetCanaryRuns.html>`_ , as well as the range of information displayed in the Synthetics console.
         :param tags: The list of key-value pairs that are associated with the canary.
-        :param visual_reference: If this canary performs visual monitoring by comparing screenshots, this structure contains the ID of the canary run to use as the baseline for screenshots, and the coordinates of any parts of the screen to ignore during the visual monitoring comparison.
+        :param visual_reference: 
+        :param visual_references: A list of visual reference configurations for the canary, one for each browser type that the canary is configured to run on. Visual references are used for visual monitoring comparisons. ``syn-nodejs-puppeteer-11.0`` and above, and ``syn-nodejs-playwright-3.0`` and above, only supports ``visualReferences`` . ``visualReference`` field is not supported. Versions older than ``syn-nodejs-puppeteer-11.0`` supports both ``visualReference`` and ``visualReferences`` for backward compatibility. It is recommended to use ``visualReferences`` for consistency and future compatibility.
         :param vpc_config: If this canary is to test an endpoint in a VPC, this structure contains information about the subnet and security groups of the VPC endpoint. For more information, see `Running a Canary in a VPC <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Canaries_VPC.html>`_ .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html
@@ -2653,9 +3328,14 @@ class CfnCanaryProps:
             cfn_canary_props = synthetics.CfnCanaryProps(
                 artifact_s3_location="artifactS3Location",
                 code=synthetics.CfnCanary.CodeProperty(
-                    handler="handler",
+                    blueprint_types=["blueprintTypes"],
+                    dependencies=[synthetics.CfnCanary.DependencyProperty(
+                        reference="reference",
             
-                    # the properties below are optional
+                        # the properties below are optional
+                        type="type"
+                    )],
+                    handler="handler",
                     s3_bucket="s3Bucket",
                     s3_key="s3Key",
                     s3_object_version="s3ObjectVersion",
@@ -2669,7 +3349,10 @@ class CfnCanaryProps:
                     expression="expression",
             
                     # the properties below are optional
-                    duration_in_seconds="durationInSeconds"
+                    duration_in_seconds="durationInSeconds",
+                    retry_config=synthetics.CfnCanary.RetryConfigProperty(
+                        max_retries=123
+                    )
                 ),
             
                 # the properties below are optional
@@ -2679,7 +3362,11 @@ class CfnCanaryProps:
                         kms_key_arn="kmsKeyArn"
                     )
                 ),
+                browser_configs=[synthetics.CfnCanary.BrowserConfigProperty(
+                    browser_type="browserType"
+                )],
                 delete_lambda_resources_on_canary_deletion=False,
+                dry_run_and_update=False,
                 failure_retention_period=123,
                 provisioned_resource_cleanup="provisionedResourceCleanup",
                 resources_to_replicate_tags=["resourcesToReplicateTags"],
@@ -2688,6 +3375,7 @@ class CfnCanaryProps:
                     environment_variables={
                         "environment_variables_key": "environmentVariables"
                     },
+                    ephemeral_storage=123,
                     memory_in_mb=123,
                     timeout_in_seconds=123
                 ),
@@ -2706,8 +3394,21 @@ class CfnCanaryProps:
             
                         # the properties below are optional
                         ignore_coordinates=["ignoreCoordinates"]
-                    )]
+                    )],
+                    browser_type="browserType"
                 ),
+                visual_references=[synthetics.CfnCanary.VisualReferenceProperty(
+                    base_canary_run_id="baseCanaryRunId",
+            
+                    # the properties below are optional
+                    base_screenshots=[synthetics.CfnCanary.BaseScreenshotProperty(
+                        screenshot_name="screenshotName",
+            
+                        # the properties below are optional
+                        ignore_coordinates=["ignoreCoordinates"]
+                    )],
+                    browser_type="browserType"
+                )],
                 vpc_config=synthetics.CfnCanary.VPCConfigProperty(
                     security_group_ids=["securityGroupIds"],
                     subnet_ids=["subnetIds"],
@@ -2727,7 +3428,9 @@ class CfnCanaryProps:
             check_type(argname="argument runtime_version", value=runtime_version, expected_type=type_hints["runtime_version"])
             check_type(argname="argument schedule", value=schedule, expected_type=type_hints["schedule"])
             check_type(argname="argument artifact_config", value=artifact_config, expected_type=type_hints["artifact_config"])
+            check_type(argname="argument browser_configs", value=browser_configs, expected_type=type_hints["browser_configs"])
             check_type(argname="argument delete_lambda_resources_on_canary_deletion", value=delete_lambda_resources_on_canary_deletion, expected_type=type_hints["delete_lambda_resources_on_canary_deletion"])
+            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 failure_retention_period", value=failure_retention_period, expected_type=type_hints["failure_retention_period"])
             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"])
@@ -2736,6 +3439,7 @@ class CfnCanaryProps:
             check_type(argname="argument success_retention_period", value=success_retention_period, expected_type=type_hints["success_retention_period"])
             check_type(argname="argument tags", value=tags, expected_type=type_hints["tags"])
             check_type(argname="argument visual_reference", value=visual_reference, expected_type=type_hints["visual_reference"])
+            check_type(argname="argument visual_references", value=visual_references, expected_type=type_hints["visual_references"])
             check_type(argname="argument vpc_config", value=vpc_config, expected_type=type_hints["vpc_config"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "artifact_s3_location": artifact_s3_location,
@@ -2747,8 +3451,12 @@ class CfnCanaryProps:
         }
         if artifact_config is not None:
             self._values["artifact_config"] = artifact_config
+        if browser_configs is not None:
+            self._values["browser_configs"] = browser_configs
         if delete_lambda_resources_on_canary_deletion is not None:
             self._values["delete_lambda_resources_on_canary_deletion"] = delete_lambda_resources_on_canary_deletion
+        if dry_run_and_update is not None:
+            self._values["dry_run_and_update"] = dry_run_and_update
         if failure_retention_period is not None:
             self._values["failure_retention_period"] = failure_retention_period
         if provisioned_resource_cleanup is not None:
@@ -2765,6 +3473,8 @@ class CfnCanaryProps:
             self._values["tags"] = tags
         if visual_reference is not None:
             self._values["visual_reference"] = visual_reference
+        if visual_references is not None:
+            self._values["visual_references"] = visual_references
         if vpc_config is not None:
             self._values["vpc_config"] = vpc_config
 
@@ -2861,6 +3571,22 @@ class CfnCanaryProps:
         result = self._values.get("artifact_config")
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCanary.ArtifactConfigProperty]], result)
 
+    @builtins.property
+    def browser_configs(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnCanary.BrowserConfigProperty]]]]:
+        '''A structure that specifies the browser type to use for a canary run.
+
+        CloudWatch Synthetics supports running canaries on both ``CHROME`` and ``FIREFOX`` browsers.
+        .. epigraph::
+
+           If not specified, ``browserConfigs`` defaults to Chrome.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-browserconfigs
+        '''
+        result = self._values.get("browser_configs")
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnCanary.BrowserConfigProperty]]]], result)
+
     @builtins.property
     def delete_lambda_resources_on_canary_deletion(
         self,
@@ -2877,6 +3603,23 @@ class CfnCanaryProps:
         result = self._values.get("delete_lambda_resources_on_canary_deletion")
         return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
 
+    @builtins.property
+    def dry_run_and_update(
+        self,
+    ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
+        '''Specifies whether to perform a dry run before updating the canary.
+
+        If set to ``true`` , CloudFormation 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. The default value is ``false`` .
+
+        For more information, see `Performing safe canary updates <https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/performing-safe-canary-upgrades.html>`_ .
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-dryrunandupdate
+        '''
+        result = self._values.get("dry_run_and_update")
+        return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], result)
+
     @builtins.property
     def failure_retention_period(self) -> typing.Optional[jsii.Number]:
         '''The number of days to retain data about failed runs of this canary.
@@ -2966,13 +3709,32 @@ class CfnCanaryProps:
     def visual_reference(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCanary.VisualReferenceProperty]]:
-        '''If this canary performs visual monitoring by comparing screenshots, this structure contains the ID of the canary run to use as the baseline for screenshots, and the coordinates of any parts of the screen to ignore during the visual monitoring comparison.
+        '''
+        :deprecated: this property has been deprecated
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-visualreference
+        :stability: deprecated
         '''
         result = self._values.get("visual_reference")
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCanary.VisualReferenceProperty]], result)
 
+    @builtins.property
+    def visual_references(
+        self,
+    ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnCanary.VisualReferenceProperty]]]]:
+        '''A list of visual reference configurations for the canary, one for each browser type that the canary is configured to run on.
+
+        Visual references are used for visual monitoring comparisons.
+
+        ``syn-nodejs-puppeteer-11.0`` and above, and ``syn-nodejs-playwright-3.0`` and above, only supports ``visualReferences`` . ``visualReference`` field is not supported.
+
+        Versions older than ``syn-nodejs-puppeteer-11.0`` supports both ``visualReference`` and ``visualReferences`` for backward compatibility. It is recommended to use ``visualReferences`` for consistency and future compatibility.
+
+        :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-synthetics-canary.html#cfn-synthetics-canary-visualreferences
+        '''
+        result = self._values.get("visual_references")
+        return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnCanary.VisualReferenceProperty]]]], result)
+
     @builtins.property
     def vpc_config(
         self,
@@ -2998,7 +3760,7 @@ class CfnCanaryProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
+@jsii.implements(_IInspectable_c2943556, _IGroupRef_4fc55162, _ITaggable_36806126)
 class CfnGroup(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -3043,7 +3805,8 @@ class CfnGroup(
         resource_arns: typing.Optional[typing.Sequence[builtins.str]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::Synthetics::Group``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param name: A name for the group. It can include any Unicode characters. The names for all groups in your account, across all Regions, must be unique.
@@ -3102,6 +3865,12 @@ class CfnGroup(
     def _cfn_properties(self) -> typing.Mapping[builtins.str, typing.Any]:
         return typing.cast(typing.Mapping[builtins.str, typing.Any], jsii.get(self, "cfnProperties"))
 
+    @builtins.property
+    @jsii.member(jsii_name="groupRef")
+    def group_ref(self) -> _GroupReference_37835a7e:
+        '''A reference to a Group resource.'''
+        return typing.cast(_GroupReference_37835a7e, jsii.get(self, "groupRef"))
+
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> _TagManager_0a598cb3:
@@ -3274,17 +4043,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]
         )
     '''
 
@@ -3300,7 +4066,7 @@ class Code(
         deploy_time: typing.Optional[builtins.bool] = None,
         display_name: typing.Optional[builtins.str] = None,
         readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
-        source_kms_key: typing.Optional[_IKey_5f11635f] = None,
+        source_kms_key: typing.Optional[_IKeyRef_d4fc6ef3] = None,
         asset_hash: typing.Optional[builtins.str] = None,
         asset_hash_type: typing.Optional[_AssetHashType_05b67f2d] = None,
         bundling: typing.Optional[typing.Union[_BundlingOptions_588cc936, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -3350,7 +4116,7 @@ class Code(
     @builtins.classmethod
     def from_bucket(
         cls,
-        bucket: _IBucket_42e086fd,
+        bucket: _IBucketRef_3debe44e,
         key: builtins.str,
         object_version: typing.Optional[builtins.str] = None,
     ) -> "S3Code":
@@ -3650,17 +4416,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__:
@@ -3752,6 +4515,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.
 
@@ -3759,17 +4550,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]
         )
     '''
 
@@ -3801,6 +4589,70 @@ class Runtime(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_synthetics.Run
         '''
         return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_NODEJS_PLAYWRIGHT_1_0"))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="SYNTHETICS_NODEJS_PLAYWRIGHT_2_0")
+    def SYNTHETICS_NODEJS_PLAYWRIGHT_2_0(cls) -> "Runtime":
+        '''``syn-nodejs-playwright-2.0`` includes the following: - Lambda runtime Node.js 20.x - Playwright version 1.49.1 - Chromium version 131.0.6778.264.
+
+        New Features:
+
+        - The mismatch between total duration and sum of timings for a given request in HAR file is fixed.
+        - Supports dry runs for the canary which allows for adhoc executions or performing a safe canary update.
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_playwright.html#Synthetics_runtimeversion-syn-nodejs-playwright-2.0
+        '''
+        return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_NODEJS_PLAYWRIGHT_2_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="SYNTHETICS_NODEJS_PLAYWRIGHT_3_0")
+    def SYNTHETICS_NODEJS_PLAYWRIGHT_3_0(cls) -> "Runtime":
+        '''``syn-nodejs-playwright-2.0`` includes the following: - Lambda runtime Node.js 20.x - Playwright version 1.53.0 - Chromium version 138.0.7204.168.
+
+        New Features:
+
+        - Multi-browser support – You can now run your nodejs puppeteer canaries in either Firefox or Chrome
+        - Support for visual monitoring
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_playwright.html#Synthetics_runtimeversion-syn-nodejs-playwright-3.0
+        '''
+        return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_NODEJS_PLAYWRIGHT_3_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="SYNTHETICS_NODEJS_PUPPETEER_10_0")
+    def SYNTHETICS_NODEJS_PUPPETEER_10_0(cls) -> "Runtime":
+        '''``syn-nodejs-puppeteer-10.0`` includes the following: - Lambda runtime Node.js 20.x - Puppeteer-core version 24.2.0 - Chromium version 131.0.6778.264.
+
+        New Features:
+
+        - **Bug fixes**: The bug related to closing the browser that took excessively long is fixed.
+        - **Dry run**: Supports dry runs for the canary which allows for adhoc executions or performing a safe canary update.
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-10.0
+        '''
+        return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_NODEJS_PUPPETEER_10_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="SYNTHETICS_NODEJS_PUPPETEER_11_0")
+    def SYNTHETICS_NODEJS_PUPPETEER_11_0(cls) -> "Runtime":
+        '''``syn-nodejs-puppeteer-11.0`` includes the following: - Lambda runtime Node.js 20.x - Puppeteer-core version 24.15.0 - Chromium version 138.0.7204.168.
+
+        New Features:
+
+        - **Multi-browser support**: You can now run Node.js Puppeteer canaries in either Firefox or Chrome
+        - **Simplified packaging**: Package scripts directly under root without using the Node.js/node_modules directory structure
+        - **Screenshot integration**: Capture screenshots using native Puppeteer functions to visualize canary script stages. Synthetics automatically associates screenshots with canary steps and uploads them to Amazon S3
+        - **Enhanced log querying**: Query and filter logs through the CloudWatch Insights console. Each log message includes a unique canaryRunId for easier searching
+        - **Configuration file support**: Define and update Synthetics settings using a synthetics.json file. This separation of configuration from script logic improves maintenance and reusability
+        - **Multiple tabs support**: Create canaries that open multiple browser tabs and access screenshots from each tab. Build multi-tab and multi-step user workflows in Synthetics
+        - **Security fixes**
+        - **Visual monitoring bug fixes**
+        - **Added support for structured JSON logging with configurable log levels**: Logs are now emitted in JSON format to enable easier parsing and querying in CloudWatch. Log level is configurable (for example, DEBUG, INFO, TRACE) through environment variables allowing users to control verbosity based on their needs
+        - **Support for ES syntax**
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_nodejs_puppeteer.html#CloudWatch_Synthetics_runtimeversion-nodejs-puppeteer-11.0
+        '''
+        return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_NODEJS_PUPPETEER_11_0"))
+
     @jsii.python.classproperty
     @jsii.member(jsii_name="SYNTHETICS_NODEJS_PUPPETEER_3_5")
     def SYNTHETICS_NODEJS_PUPPETEER_3_5(cls) -> "Runtime":
@@ -4185,6 +5037,50 @@ class Runtime(metaclass=jsii.JSIIMeta, jsii_type="aws-cdk-lib.aws_synthetics.Run
         '''
         return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_PYTHON_SELENIUM_4_1"))
 
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="SYNTHETICS_PYTHON_SELENIUM_5_0")
+    def SYNTHETICS_PYTHON_SELENIUM_5_0(cls) -> "Runtime":
+        '''``syn-python-selenium-5.0`` includes the following: - Lambda runtime Python 3.9 - Selenium version 4.21.0 - Chromium version 131.0.6778.264.
+
+        New Features:
+
+        - Automatic retry if the browser fails to launch.
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_python_selenium.html#CloudWatch_Synthetics_runtimeversion-syn-python-selenium-5.0
+        '''
+        return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_PYTHON_SELENIUM_5_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="SYNTHETICS_PYTHON_SELENIUM_5_1")
+    def SYNTHETICS_PYTHON_SELENIUM_5_1(cls) -> "Runtime":
+        '''``syn-python-selenium-5.1`` includes the following: - Lambda runtime Python 3.9 - Selenium version 4.21.0 - Chromium version 131.0.6778.264.
+
+        New Features:
+
+        - Minor updates on metric emission.
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_python_selenium.html#CloudWatch_Synthetics_runtimeversion-syn-python-selenium-5.1
+        '''
+        return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_PYTHON_SELENIUM_5_1"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="SYNTHETICS_PYTHON_SELENIUM_6_0")
+    def SYNTHETICS_PYTHON_SELENIUM_6_0(cls) -> "Runtime":
+        '''``syn-python-selenium-6.0`` includes the following: - Lambda runtime Python 3.11 - Selenium version 4.21.0 - Chromium version 131.0.6778.264.
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_python_selenium.html#CloudWatch_Synthetics_runtimeversion-syn-python-selenium-6.0
+        '''
+        return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_PYTHON_SELENIUM_6_0"))
+
+    @jsii.python.classproperty
+    @jsii.member(jsii_name="SYNTHETICS_PYTHON_SELENIUM_7_0")
+    def SYNTHETICS_PYTHON_SELENIUM_7_0(cls) -> "Runtime":
+        '''``syn-python-selenium-7.0`` includes the following: - Lambda runtime Python 3.11 - Selenium version 4.32.0 - Chromium version 138.0.7204.168.
+
+        :see: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Synthetics_Library_python_selenium.html#CloudWatch_Synthetics_runtimeversion-syn-python-selenium-7.0
+        '''
+        return typing.cast("Runtime", jsii.sget(cls, "SYNTHETICS_PYTHON_SELENIUM_7_0"))
+
     @builtins.property
     @jsii.member(jsii_name="family")
     def family(self) -> "RuntimeFamily":
@@ -4223,17 +5119,17 @@ class S3Code(
 
         # The code below shows an example of how to instantiate this type.
         # The values are placeholders you should change.
-        from aws_cdk import aws_s3 as s3
         from aws_cdk import aws_synthetics as synthetics
+        from aws_cdk.interfaces import aws_s3 as interfaces_aws_s3
         
-        # bucket: s3.Bucket
+        # bucket_ref: interfaces_aws_s3.IBucketRef
         
-        s3_code = synthetics.S3Code(bucket, "key", "objectVersion")
+        s3_code = synthetics.S3Code(bucket_ref, "key", "objectVersion")
     '''
 
     def __init__(
         self,
-        bucket: _IBucket_42e086fd,
+        bucket: _IBucketRef_3debe44e,
         key: builtins.str,
         object_version: typing.Optional[builtins.str] = None,
     ) -> None:
@@ -4286,11 +5182,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
         )
     '''
 
@@ -4369,17 +5265,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]
         )
     '''
 
@@ -4425,12 +5318,12 @@ class AssetCode(
         # The values are placeholders you should change.
         import aws_cdk as cdk
         from aws_cdk import aws_iam as iam
-        from aws_cdk import aws_kms as kms
         from aws_cdk import aws_synthetics as synthetics
+        from aws_cdk.interfaces import aws_kms as interfaces_aws_kms
         
         # docker_image: cdk.DockerImage
         # grantable: iam.IGrantable
-        # key: kms.Key
+        # key_ref: interfaces_aws_kms.IKeyRef
         # local_bundling: cdk.ILocalBundling
         
         asset_code = synthetics.AssetCode("assetPath",
@@ -4468,7 +5361,7 @@ class AssetCode(
             follow_symlinks=cdk.SymlinkFollowMode.NEVER,
             ignore_mode=cdk.IgnoreMode.GLOB,
             readers=[grantable],
-            source_kMSKey=key
+            source_kMSKey=key_ref
         )
     '''
 
@@ -4479,7 +5372,7 @@ class AssetCode(
         deploy_time: typing.Optional[builtins.bool] = None,
         display_name: typing.Optional[builtins.str] = None,
         readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
-        source_kms_key: typing.Optional[_IKey_5f11635f] = None,
+        source_kms_key: typing.Optional[_IKeyRef_d4fc6ef3] = None,
         asset_hash: typing.Optional[builtins.str] = None,
         asset_hash_type: typing.Optional[_AssetHashType_05b67f2d] = None,
         bundling: typing.Optional[typing.Union[_BundlingOptions_588cc936, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -4546,6 +5439,7 @@ __all__ = [
     "ArtifactsBucketLocation",
     "ArtifactsEncryptionMode",
     "AssetCode",
+    "BrowserType",
     "Canary",
     "CanaryProps",
     "CfnCanary",
@@ -4558,6 +5452,7 @@ __all__ = [
     "CronOptions",
     "CustomTestOptions",
     "InlineCode",
+    "ResourceToReplicateTags",
     "Runtime",
     "RuntimeFamily",
     "S3Code",
@@ -4586,12 +5481,16 @@ def _typecheckingstub__b3b6d76e5f93e31884e16cc00a9b4fc93e6782ff7db09c74aa1ef9346
     artifact_s3_kms_key: typing.Optional[_IKey_5f11635f] = None,
     artifacts_bucket_lifecycle_rules: typing.Optional[typing.Sequence[typing.Union[_LifecycleRule_bb74e6ff, typing.Dict[builtins.str, typing.Any]]]] = None,
     artifacts_bucket_location: typing.Optional[typing.Union[ArtifactsBucketLocation, typing.Dict[builtins.str, typing.Any]]] = None,
+    browser_configs: typing.Optional[typing.Sequence[BrowserType]] = None,
     canary_name: typing.Optional[builtins.str] = None,
     cleanup: typing.Optional[Cleanup] = None,
+    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,
@@ -4614,12 +5513,16 @@ def _typecheckingstub__44ec0b14d52b66927d4daebe6f97bb070f3629bb0eb86e21668ca7862
     artifact_s3_kms_key: typing.Optional[_IKey_5f11635f] = None,
     artifacts_bucket_lifecycle_rules: typing.Optional[typing.Sequence[typing.Union[_LifecycleRule_bb74e6ff, typing.Dict[builtins.str, typing.Any]]]] = None,
     artifacts_bucket_location: typing.Optional[typing.Union[ArtifactsBucketLocation, typing.Dict[builtins.str, typing.Any]]] = None,
+    browser_configs: typing.Optional[typing.Sequence[BrowserType]] = None,
     canary_name: typing.Optional[builtins.str] = None,
     cleanup: typing.Optional[Cleanup] = None,
+    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,
@@ -4644,7 +5547,9 @@ def _typecheckingstub__b8fcb3f48eca9399b4d1d31a5ef709e22f9fa52ad1e174b75d8313ef2
     runtime_version: builtins.str,
     schedule: typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.ScheduleProperty, typing.Dict[builtins.str, typing.Any]]],
     artifact_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.ArtifactConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    browser_configs: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.BrowserConfigProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     delete_lambda_resources_on_canary_deletion: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+    dry_run_and_update: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     failure_retention_period: typing.Optional[jsii.Number] = None,
     provisioned_resource_cleanup: typing.Optional[builtins.str] = None,
     resources_to_replicate_tags: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -4653,11 +5558,20 @@ def _typecheckingstub__b8fcb3f48eca9399b4d1d31a5ef709e22f9fa52ad1e174b75d8313ef2
     success_retention_period: typing.Optional[jsii.Number] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     visual_reference: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VisualReferenceProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    visual_references: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VisualReferenceProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     vpc_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VPCConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__a9ea9a4c62ed507734c1656b5b5b9ece24a5a15e32aa598350d8dcba80710c99(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    canary_name: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__bc166bab0fcf177897c1dbb233203e39458428064bc6ff7215b01b2b3ec6f3a2(
     inspector: _TreeInspector_488e0dd5,
 ) -> None:
@@ -4712,12 +5626,24 @@ def _typecheckingstub__5946ee35eff32e4581a6d2e3e0c69d62cdc3c17f079123211f7251bc1
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__91233a90f3d4d918352b4597b2dee50c3da02176501744c2dc696dbd8a735b68(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnCanary.BrowserConfigProperty]]]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__442577c2c36e4274dca25b3d866e1aeec3f4ffc18732e01050131a31f768f2b3(
     value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
 ) -> None:
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__59860e5fb72da4da1108545c9e0b8f706d34cf83eb363fda05f04cbb14baf1fe(
+    value: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__02a7e43f45419c4cb8e909f309f8848d4ced91d17b01d14e5ea0b8cec28aab1b(
     value: typing.Optional[jsii.Number],
 ) -> None:
@@ -4766,6 +5692,12 @@ def _typecheckingstub__21e93a70969fa03a3f0aa85f6b1615a26d9a0afef8a0cf27f0888fc59
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__004341f5a58c9e6e190c4bc518ea476aac62201a1708bb1650a22fbf74c64b52(
+    value: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.List[typing.Union[_IResolvable_da3f097b, CfnCanary.VisualReferenceProperty]]]],
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__be63ed6816e3043aef63f6e7c0d0dfcc35f1249735acd4eff8530f8c2253b747(
     value: typing.Optional[typing.Union[_IResolvable_da3f097b, CfnCanary.VPCConfigProperty]],
 ) -> None:
@@ -4787,9 +5719,18 @@ def _typecheckingstub__8d401a2416919aef18322e23fb875fc37ad8f90f34f8f5708a245f22f
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__c91e35c3c240434fee052d7f899893609a9c027813412eb6312483e200412435(
+    *,
+    browser_type: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__3d403372a613babc1ab10717d050ec9a7f4055961f3545f2d0600d89c7b3dcc3(
     *,
-    handler: builtins.str,
+    blueprint_types: typing.Optional[typing.Sequence[builtins.str]] = None,
+    dependencies: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.DependencyProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
+    handler: typing.Optional[builtins.str] = None,
     s3_bucket: typing.Optional[builtins.str] = None,
     s3_key: typing.Optional[builtins.str] = None,
     s3_object_version: typing.Optional[builtins.str] = None,
@@ -4799,10 +5740,26 @@ def _typecheckingstub__3d403372a613babc1ab10717d050ec9a7f4055961f3545f2d0600d89c
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__02338e317b0b84f714774aabea98599cd96fe9cff23790733ad426e75f9984f4(
+    *,
+    reference: builtins.str,
+    type: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__e7a2c989ca2c701e49af0e8032c8c49bb52546c68c9e6359df8e7a9f2c4cf9a1(
+    *,
+    max_retries: jsii.Number,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__fa148862e82948accbbe951e7afcee721aa7014754c81106d2648fe1c5cf28e2(
     *,
     active_tracing: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     environment_variables: typing.Optional[typing.Union[typing.Mapping[builtins.str, builtins.str], _IResolvable_da3f097b]] = None,
+    ephemeral_storage: typing.Optional[jsii.Number] = None,
     memory_in_mb: typing.Optional[jsii.Number] = None,
     timeout_in_seconds: typing.Optional[jsii.Number] = None,
 ) -> None:
@@ -4821,6 +5778,7 @@ def _typecheckingstub__e4999288d0e0c5de04c56a3436208778026602dfdca27710aee93f9f4
     *,
     expression: builtins.str,
     duration_in_seconds: typing.Optional[builtins.str] = None,
+    retry_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.RetryConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -4839,6 +5797,7 @@ def _typecheckingstub__f52b6b7318141dc99f6bd36c21b91cda286b67d7dea805791a6132a2c
     *,
     base_canary_run_id: builtins.str,
     base_screenshots: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.BaseScreenshotProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
+    browser_type: typing.Optional[builtins.str] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -4852,7 +5811,9 @@ def _typecheckingstub__d869d56ce0d1d2e2add2f80bf39b28abbec2752c719e03194ee540bf1
     runtime_version: builtins.str,
     schedule: typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.ScheduleProperty, typing.Dict[builtins.str, typing.Any]]],
     artifact_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.ArtifactConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    browser_configs: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.BrowserConfigProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     delete_lambda_resources_on_canary_deletion: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
+    dry_run_and_update: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     failure_retention_period: typing.Optional[jsii.Number] = None,
     provisioned_resource_cleanup: typing.Optional[builtins.str] = None,
     resources_to_replicate_tags: typing.Optional[typing.Sequence[builtins.str]] = None,
@@ -4861,6 +5822,7 @@ def _typecheckingstub__d869d56ce0d1d2e2add2f80bf39b28abbec2752c719e03194ee540bf1
     success_retention_period: typing.Optional[jsii.Number] = None,
     tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     visual_reference: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VisualReferenceProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
+    visual_references: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VisualReferenceProperty, typing.Dict[builtins.str, typing.Any]]]]]] = None,
     vpc_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union[CfnCanary.VPCConfigProperty, typing.Dict[builtins.str, typing.Any]]]] = None,
 ) -> None:
     """Type checking stubs"""
@@ -4922,7 +5884,7 @@ def _typecheckingstub__02201c2190b076bbceced8708b435fab8189f7f505650002941cc7a50
     deploy_time: typing.Optional[builtins.bool] = None,
     display_name: typing.Optional[builtins.str] = None,
     readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
-    source_kms_key: typing.Optional[_IKey_5f11635f] = None,
+    source_kms_key: typing.Optional[_IKeyRef_d4fc6ef3] = None,
     asset_hash: typing.Optional[builtins.str] = None,
     asset_hash_type: typing.Optional[_AssetHashType_05b67f2d] = None,
     bundling: typing.Optional[typing.Union[_BundlingOptions_588cc936, typing.Dict[builtins.str, typing.Any]]] = None,
@@ -4934,7 +5896,7 @@ def _typecheckingstub__02201c2190b076bbceced8708b435fab8189f7f505650002941cc7a50
     pass
 
 def _typecheckingstub__449747bf42ca4f0c5864a72ad8bd3bcd8b8dedef173ae2e8a54e213a343068a6(
-    bucket: _IBucket_42e086fd,
+    bucket: _IBucketRef_3debe44e,
     key: builtins.str,
     object_version: typing.Optional[builtins.str] = None,
 ) -> None:
@@ -5006,7 +5968,7 @@ def _typecheckingstub__ba23a2bd20fc9334e4b0fac6e1c104de0f53b4ec265cf53ef1a80ad25
     pass
 
 def _typecheckingstub__94d1b4f54d462b3f798f1b900a1b75b486a8dc3f4f14650931bf7631ce93a5bd(
-    bucket: _IBucket_42e086fd,
+    bucket: _IBucketRef_3debe44e,
     key: builtins.str,
     object_version: typing.Optional[builtins.str] = None,
 ) -> None:
@@ -5040,7 +6002,7 @@ def _typecheckingstub__60a29a536d66536254f2ca409a65dc32f30e483b29091222d42f32106
     deploy_time: typing.Optional[builtins.bool] = None,
     display_name: typing.Optional[builtins.str] = None,
     readers: typing.Optional[typing.Sequence[_IGrantable_71c4f5de]] = None,
-    source_kms_key: typing.Optional[_IKey_5f11635f] = None,
+    source_kms_key: typing.Optional[_IKeyRef_d4fc6ef3] = None,
     asset_hash: typing.Optional[builtins.str] = None,
     asset_hash_type: typing.Optional[_AssetHashType_05b67f2d] = None,
     bundling: typing.Optional[typing.Union[_BundlingOptions_588cc936, typing.Dict[builtins.str, typing.Any]]] = None,