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

aws_cdk/aws_events_targets/__init__.py

@@ -17,9 +17,11 @@ Currently supported are:
   * [Start a StepFunctions state machine](#start-a-stepfunctions-state-machine)
   * [Queue a Batch job](#queue-a-batch-job)
   * [Invoke an API Gateway REST API](#invoke-an-api-gateway-rest-api)
+  * [Invoke an AWS API](#invoke-an-aws-api)
   * [Invoke an API Destination](#invoke-an-api-destination)
   * [Invoke an AppSync GraphQL API](#invoke-an-appsync-graphql-api)
   * [Put an event on an EventBridge bus](#put-an-event-on-an-eventbridge-bus)
+  * [Put an event on a Firehose delivery stream](#put-an-event-on-a-firehose-delivery-stream)
   * [Run an ECS Task](#run-an-ecs-task)
 
     * [Tagging Tasks](#tagging-tasks)
@@ -339,6 +341,68 @@ import aws_cdk.aws_apigatewayv2 as apigwv2
 rule.add_target(targets.ApiGatewayV2(http_api))
 ```
 
+## Invoke an AWS API
+
+Use the `AwsApi` target to make direct AWS API calls from EventBridge rules. This is useful for invoking AWS services that don't have a dedicated EventBridge target.
+
+### Basic Usage
+
+The following example shows how to update an ECS service when a rule is triggered:
+
+```python
+rule = events.Rule(self, "Rule",
+    schedule=events.Schedule.rate(Duration.hours(1))
+)
+
+rule.add_target(targets.AwsApi(
+    service="ECS",
+    action="updateService",
+    parameters={
+        "service": "my-service",
+        "force_new_deployment": True
+    }
+))
+```
+
+### IAM Permissions
+
+By default, the AwsApi target automatically creates the necessary IAM permissions based on the service and action you specify. The permission format follows the pattern: `service:Action`.
+
+For example:
+
+* `ECS` service with `updateService` action → `ecs:UpdateService` permission
+* `RDS` service with `createDBSnapshot` action → `rds:CreateDBSnapshot` permission
+
+### Custom IAM Policy
+
+In some cases, you may need to provide a custom IAM policy statement, especially when:
+
+* You need to restrict permissions to specific resources (instead of `*`)
+* The service requires additional permissions beyond the main action
+* You want more granular control over the permissions
+
+```python
+import aws_cdk.aws_iam as iam
+import aws_cdk.aws_s3 as s3
+
+# rule: events.Rule
+# bucket: s3.Bucket
+
+
+rule.add_target(targets.AwsApi(
+    service="s3",
+    action="GetBucketEncryption",
+    parameters={
+        "Bucket": bucket.bucket_name
+    },
+    policy_statement=iam.PolicyStatement(
+        effect=iam.Effect.ALLOW,
+        actions=["s3:GetEncryptionConfiguration"],
+        resources=[bucket.bucket_arn]
+    )
+))
+```
+
 ## Invoke an API Destination
 
 Use the `targets.ApiDestination` target to trigger an external API. You need to
@@ -370,8 +434,13 @@ to create additional rules:
 ```python
 connection = events.Connection.from_event_bus_arn(self, "Connection", "arn:aws:events:us-east-1:123456789012:event-bus/EventBusName", "arn:aws:secretsmanager:us-east-1:123456789012:secret:SecretName-f3gDy9")
 
-api_destination_arn = "arn:aws:events:us-east-1:123456789012:api-destination/DestinationName"
-destination = events.ApiDestination.from_api_destination_attributes(self, "Destination", api_destination_arn=api_destination_arn, connection=connection)
+api_destination_arn = "arn:aws:events:us-east-1:123456789012:api-destination/DestinationName/11111111-1111-1111-1111-111111111111"
+api_destination_arn_for_policy = "arn:aws:events:us-east-1:123456789012:api-destination/DestinationName"
+destination = events.ApiDestination.from_api_destination_attributes(self, "Destination",
+    api_destination_arn=api_destination_arn,
+    connection=connection,
+    api_destination_arn_for_policy=api_destination_arn_for_policy
+)
 
 rule = events.Rule(self, "OtherRule",
     schedule=events.Schedule.rate(Duration.minutes(10)),
@@ -455,6 +524,28 @@ rule.add_target(targets.EventBus(
     events.EventBus.from_event_bus_arn(self, "External", "arn:aws:events:eu-west-1:999999999999:event-bus/test-bus")))
 ```
 
+## Put an event on a Firehose delivery stream
+
+Use the `FirehoseDeliveryStream` target to put event to an Amazon Data Firehose delivery stream.
+
+The code snippet below creates the scheduled event rule that put events to an Amazon Data Firehose delivery stream.
+
+```python
+import aws_cdk.aws_kinesisfirehose as firehose
+import aws_cdk.aws_s3 as s3
+
+# bucket: s3.Bucket
+
+stream = firehose.DeliveryStream(self, "DeliveryStream",
+    destination=firehose.S3Bucket(bucket)
+)
+
+rule = events.Rule(self, "Rule",
+    schedule=events.Schedule.expression("rate(1 minute)")
+)
+rule.add_target(targets.FirehoseDeliveryStream(stream))
+```
+
 ## Run an ECS Task
 
 Use the `EcsTask` target to run an ECS Task.
@@ -725,7 +816,10 @@ from ..aws_iam import (
     IRole as _IRole_235f5d8e, PolicyStatement as _PolicyStatement_0fe33853
 )
 from ..aws_kinesis import IStream as _IStream_4e2457d2
-from ..aws_kinesisfirehose import CfnDeliveryStream as _CfnDeliveryStream_8f3b1735
+from ..aws_kinesisfirehose import (
+    CfnDeliveryStream as _CfnDeliveryStream_8f3b1735,
+    IDeliveryStream as _IDeliveryStream_8f118861,
+)
 from ..aws_lambda import IFunction as _IFunction_6adb0ab8
 from ..aws_logs import ILogGroup as _ILogGroup_3c4fa718
 from ..aws_secretsmanager import ISecret as _ISecret_6e020e6a
@@ -1138,28 +1232,22 @@ class AwsApi(
 ):
     '''Use an AWS Lambda function that makes API calls as an event rule target.
 
-    :exampleMetadata: fixture=_generated
+    :exampleMetadata: infused
 
     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_events_targets as events_targets
-        from aws_cdk import aws_iam as iam
-        
-        # parameters: Any
-        # policy_statement: iam.PolicyStatement
-        
-        aws_api = events_targets.AwsApi(
-            action="action",
-            service="service",
-        
-            # the properties below are optional
-            api_version="apiVersion",
-            catch_error_pattern="catchErrorPattern",
-            parameters=parameters,
-            policy_statement=policy_statement
+        rule = events.Rule(self, "Rule",
+            schedule=events.Schedule.rate(Duration.hours(1))
         )
+        
+        rule.add_target(targets.AwsApi(
+            service="ECS",
+            action="updateService",
+            parameters={
+                "service": "my-service",
+                "force_new_deployment": True
+            }
+        ))
     '''
 
     def __init__(
@@ -1375,28 +1463,22 @@ class AwsApiProps(AwsApiInput):
         :param parameters: The parameters for the service action. Default: - no parameters
         :param policy_statement: The IAM policy statement to allow the API call. Use only if resource restriction is needed. Default: - extract the permission from the API call
 
-        :exampleMetadata: fixture=_generated
+        :exampleMetadata: infused
 
         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_events_targets as events_targets
-            from aws_cdk import aws_iam as iam
-            
-            # parameters: Any
-            # policy_statement: iam.PolicyStatement
-            
-            aws_api_props = events_targets.AwsApiProps(
-                action="action",
-                service="service",
-            
-                # the properties below are optional
-                api_version="apiVersion",
-                catch_error_pattern="catchErrorPattern",
-                parameters=parameters,
-                policy_statement=policy_statement
+            rule = events.Rule(self, "Rule",
+                schedule=events.Schedule.rate(Duration.hours(1))
             )
+            
+            rule.add_target(targets.AwsApi(
+                service="ECS",
+                action="updateService",
+                parameters={
+                    "service": "my-service",
+                    "force_new_deployment": True
+                }
+            ))
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__d0959cf5a09d52d03f2591de3b911528bd507126b7e2027cd7c4585de25301ad)
@@ -2316,15 +2398,142 @@ class EventBusProps:
         )
 
 
+@jsii.implements(_IRuleTarget_7a91f454)
+class FirehoseDeliveryStream(
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_events_targets.FirehoseDeliveryStream",
+):
+    '''Customize the Amazon Data Firehose Stream Event Target.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        import aws_cdk.aws_kinesisfirehose as firehose
+        import aws_cdk.aws_s3 as s3
+        
+        # bucket: s3.Bucket
+        
+        stream = firehose.DeliveryStream(self, "DeliveryStream",
+            destination=firehose.S3Bucket(bucket)
+        )
+        
+        rule = events.Rule(self, "Rule",
+            schedule=events.Schedule.expression("rate(1 minute)")
+        )
+        rule.add_target(targets.FirehoseDeliveryStream(stream))
+    '''
+
+    def __init__(
+        self,
+        delivery_stream: _IDeliveryStream_8f118861,
+        *,
+        message: typing.Optional[_RuleTargetInput_6beca786] = None,
+    ) -> None:
+        '''
+        :param delivery_stream: -
+        :param message: The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__e8b83537633e15491c91cd6cebe1eddb6bc388617c53b754a40f318f493dc48e)
+            check_type(argname="argument delivery_stream", value=delivery_stream, expected_type=type_hints["delivery_stream"])
+        props = FirehoseDeliveryStreamProps(message=message)
+
+        jsii.create(self.__class__, self, [delivery_stream, props])
+
+    @jsii.member(jsii_name="bind")
+    def bind(
+        self,
+        _rule: _IRule_af9e3d28,
+        _id: typing.Optional[builtins.str] = None,
+    ) -> _RuleTargetConfig_4e70fe03:
+        '''Returns a RuleTarget that can be used to trigger this Firehose Stream as a result from a Event Bridge event.
+
+        :param _rule: -
+        :param _id: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__45499f815ce457b36825c13b8a0a6ffd1d6994523698febc614678776c341fb7)
+            check_type(argname="argument _rule", value=_rule, expected_type=type_hints["_rule"])
+            check_type(argname="argument _id", value=_id, expected_type=type_hints["_id"])
+        return typing.cast(_RuleTargetConfig_4e70fe03, jsii.invoke(self, "bind", [_rule, _id]))
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_events_targets.FirehoseDeliveryStreamProps",
+    jsii_struct_bases=[],
+    name_mapping={"message": "message"},
+)
+class FirehoseDeliveryStreamProps:
+    def __init__(
+        self,
+        *,
+        message: typing.Optional[_RuleTargetInput_6beca786] = None,
+    ) -> None:
+        '''Customize the Amazon Data Firehose Stream Event Target.
+
+        :param message: The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
+
+        :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_events as events
+            from aws_cdk import aws_events_targets as events_targets
+            
+            # rule_target_input: events.RuleTargetInput
+            
+            firehose_delivery_stream_props = events_targets.FirehoseDeliveryStreamProps(
+                message=rule_target_input
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__c2311008fe7ae7c5e650063e35f32620f673ed3b0110bcab83f56ce21512d70c)
+            check_type(argname="argument message", value=message, expected_type=type_hints["message"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {}
+        if message is not None:
+            self._values["message"] = message
+
+    @builtins.property
+    def message(self) -> typing.Optional[_RuleTargetInput_6beca786]:
+        '''The message to send to the stream.
+
+        Must be a valid JSON text passed to the target stream.
+
+        :default: - the entire Event Bridge event
+        '''
+        result = self._values.get("message")
+        return typing.cast(typing.Optional[_RuleTargetInput_6beca786], 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 "FirehoseDeliveryStreamProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.interface(jsii_type="aws-cdk-lib.aws_events_targets.IDeliveryStream")
 class IDeliveryStream(_IResource_c80c4260, typing_extensions.Protocol):
-    '''Represents an Amazon Data Firehose delivery stream.'''
+    '''(deprecated) Represents an Amazon Data Firehose delivery stream.
+
+    :deprecated: Use aws_kinesisfirehose.IDeliveryStream
+
+    :stability: deprecated
+    '''
 
     @builtins.property
     @jsii.member(jsii_name="deliveryStreamArn")
     def delivery_stream_arn(self) -> builtins.str:
-        '''The ARN of the delivery stream.
+        '''(deprecated) The ARN of the delivery stream.
 
+        :stability: deprecated
         :attribute: true
         '''
         ...
@@ -2332,8 +2541,9 @@ class IDeliveryStream(_IResource_c80c4260, typing_extensions.Protocol):
     @builtins.property
     @jsii.member(jsii_name="deliveryStreamName")
     def delivery_stream_name(self) -> builtins.str:
-        '''The name of the delivery stream.
+        '''(deprecated) The name of the delivery stream.
 
+        :stability: deprecated
         :attribute: true
         '''
         ...
@@ -2342,15 +2552,21 @@ class IDeliveryStream(_IResource_c80c4260, typing_extensions.Protocol):
 class _IDeliveryStreamProxy(
     jsii.proxy_for(_IResource_c80c4260), # type: ignore[misc]
 ):
-    '''Represents an Amazon Data Firehose delivery stream.'''
+    '''(deprecated) Represents an Amazon Data Firehose delivery stream.
+
+    :deprecated: Use aws_kinesisfirehose.IDeliveryStream
+
+    :stability: deprecated
+    '''
 
     __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_events_targets.IDeliveryStream"
 
     @builtins.property
     @jsii.member(jsii_name="deliveryStreamArn")
     def delivery_stream_arn(self) -> builtins.str:
-        '''The ARN of the delivery stream.
+        '''(deprecated) The ARN of the delivery stream.
 
+        :stability: deprecated
         :attribute: true
         '''
         return typing.cast(builtins.str, jsii.get(self, "deliveryStreamArn"))
@@ -2358,8 +2574,9 @@ class _IDeliveryStreamProxy(
     @builtins.property
     @jsii.member(jsii_name="deliveryStreamName")
     def delivery_stream_name(self) -> builtins.str:
-        '''The name of the delivery stream.
+        '''(deprecated) The name of the delivery stream.
 
+        :stability: deprecated
         :attribute: true
         '''
         return typing.cast(builtins.str, jsii.get(self, "deliveryStreamName"))
@@ -2438,7 +2655,7 @@ class KinesisFirehoseStream(
 ):
     '''(deprecated) Customize the Amazon Data Firehose Stream Event Target.
 
-    :deprecated: Use KinesisFirehoseStreamV2
+    :deprecated: Use FirehoseDeliveryStream
 
     :stability: deprecated
     :exampleMetadata: fixture=_generated
@@ -2467,7 +2684,7 @@ class KinesisFirehoseStream(
     ) -> None:
         '''
         :param stream: -
-        :param message: The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
+        :param message: (deprecated) The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
 
         :stability: deprecated
         '''
@@ -2509,10 +2726,13 @@ class KinesisFirehoseStreamProps:
         *,
         message: typing.Optional[_RuleTargetInput_6beca786] = None,
     ) -> None:
-        '''Customize the Amazon Data Firehose Stream Event Target.
+        '''(deprecated) Customize the Amazon Data Firehose Stream Event Target.
 
-        :param message: The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
+        :param message: (deprecated) The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
 
+        :deprecated: Use FirehoseDeliveryStreamProps
+
+        :stability: deprecated
         :exampleMetadata: fixture=_generated
 
         Example::
@@ -2537,11 +2757,13 @@ class KinesisFirehoseStreamProps:
 
     @builtins.property
     def message(self) -> typing.Optional[_RuleTargetInput_6beca786]:
-        '''The message to send to the stream.
+        '''(deprecated) The message to send to the stream.
 
         Must be a valid JSON text passed to the target stream.
 
         :default: - the entire Event Bridge event
+
+        :stability: deprecated
         '''
         result = self._values.get("message")
         return typing.cast(typing.Optional[_RuleTargetInput_6beca786], result)
@@ -2563,8 +2785,11 @@ class KinesisFirehoseStreamV2(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_events_targets.KinesisFirehoseStreamV2",
 ):
-    '''Customize the Amazon Data Firehose Stream Event Target V2 to support L2 Amazon Data Firehose Delivery Stream instead of L1 Cfn Firehose Delivery Stream.
+    '''(deprecated) Customize the Amazon Data Firehose Stream Event Target V2 to support L2 Amazon Data Firehose Delivery Stream instead of L1 Cfn Firehose Delivery Stream.
 
+    :deprecated: Use FirehoseDeliveryStream
+
+    :stability: deprecated
     :exampleMetadata: fixture=_generated
 
     Example::
@@ -2590,7 +2815,9 @@ class KinesisFirehoseStreamV2(
     ) -> None:
         '''
         :param stream: -
-        :param message: The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
+        :param message: (deprecated) The message to send to the stream. Must be a valid JSON text passed to the target stream. Default: - the entire Event Bridge event
+
+        :stability: deprecated
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__e8230487c5e79599a4ad63af004c2c8350c2b25e209491350274d38019afa418)
@@ -2605,10 +2832,12 @@ class KinesisFirehoseStreamV2(
         _rule: _IRule_af9e3d28,
         _id: typing.Optional[builtins.str] = None,
     ) -> _RuleTargetConfig_4e70fe03:
-        '''Returns a RuleTarget that can be used to trigger this Firehose Stream as a result from a Event Bridge event.
+        '''(deprecated) Returns a RuleTarget that can be used to trigger this Firehose Stream as a result from a Event Bridge event.
 
         :param _rule: -
         :param _id: -
+
+        :stability: deprecated
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__3467ab0e593ed64d775dafc3b3fc1b1835fa2853c7ee8685668bf081dd189e44)
@@ -2795,7 +3024,7 @@ class LogGroupTargetInput(
         message: typing.Any = None,
         timestamp: typing.Any = None,
     ) -> _RuleTargetInput_6beca786:
-        '''(deprecated) Pass a JSON object to the the log group event target.
+        '''(deprecated) Pass a JSON object to the log group event target.
 
         May contain strings returned by ``EventField.from()`` to substitute in parts of the
         matched event.
@@ -6065,6 +6294,8 @@ __all__ = [
     "EphemeralStorageOverride",
     "EventBus",
     "EventBusProps",
+    "FirehoseDeliveryStream",
+    "FirehoseDeliveryStreamProps",
     "IDeliveryStream",
     "InferenceAcceleratorOverride",
     "KinesisFirehoseStream",
@@ -6345,6 +6576,28 @@ def _typecheckingstub__5af20e134873490c1ac4788761972ccd53cd625edbd9b75c1c1f0b1a3
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__e8b83537633e15491c91cd6cebe1eddb6bc388617c53b754a40f318f493dc48e(
+    delivery_stream: _IDeliveryStream_8f118861,
+    *,
+    message: typing.Optional[_RuleTargetInput_6beca786] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__45499f815ce457b36825c13b8a0a6ffd1d6994523698febc614678776c341fb7(
+    _rule: _IRule_af9e3d28,
+    _id: typing.Optional[builtins.str] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__c2311008fe7ae7c5e650063e35f32620f673ed3b0110bcab83f56ce21512d70c(
+    *,
+    message: typing.Optional[_RuleTargetInput_6beca786] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__04d9348fef54fca78833e3224fa6f62badc3a0e6c0bfa6af7838fe531de0ebf6(
     *,
     device_name: builtins.str,
@@ -6733,3 +6986,6 @@ def _typecheckingstub__6472cea5f7d90ec67bd493d4b2ba6bc083b2c915d8dc1da40193693c2
 ) -> None:
     """Type checking stubs"""
     pass
+
+for cls in [IDeliveryStream]:
+    typing.cast(typing.Any, cls).__protocol_attrs__ = typing.cast(typing.Any, cls).__protocol_attrs__ - set(['__jsii_proxy_class__', '__jsii_type__'])

aws_cdk/aws_eventschemas/__init__.py

@@ -66,9 +66,19 @@ from .. import (
     TagManager as _TagManager_0a598cb3,
     TreeInspector as _TreeInspector_488e0dd5,
 )
+from ..interfaces.aws_eventschemas import (
+    DiscovererReference as _DiscovererReference_52fd091c,
+    IDiscovererRef as _IDiscovererRef_40eee464,
+    IRegistryPolicyRef as _IRegistryPolicyRef_a1fe7d28,
+    IRegistryRef as _IRegistryRef_007bdb40,
+    ISchemaRef as _ISchemaRef_85adc95a,
+    RegistryPolicyReference as _RegistryPolicyReference_788dde78,
+    RegistryReference as _RegistryReference_9f962fb0,
+    SchemaReference as _SchemaReference_3c1ea018,
+)
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
+@jsii.implements(_IInspectable_c2943556, _IDiscovererRef_40eee464, _ITaggable_36806126)
 class CfnDiscoverer(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -111,7 +121,8 @@ class CfnDiscoverer(
         description: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union["CfnDiscoverer.TagsEntryProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::EventSchemas::Discoverer``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param source_arn: The ARN of the event bus.
@@ -202,6 +213,12 @@ class CfnDiscoverer(
     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="discovererRef")
+    def discoverer_ref(self) -> _DiscovererReference_52fd091c:
+        '''A reference to a Discoverer resource.'''
+        return typing.cast(_DiscovererReference_52fd091c, jsii.get(self, "discovererRef"))
+
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> _TagManager_0a598cb3:
@@ -453,7 +470,7 @@ class CfnDiscovererProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
+@jsii.implements(_IInspectable_c2943556, _IRegistryRef_007bdb40, _ITaggable_36806126)
 class CfnRegistry(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -492,7 +509,8 @@ class CfnRegistry(
         registry_name: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union["CfnRegistry.TagsEntryProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::EventSchemas::Registry``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param description: A description of the registry to be created.
@@ -562,6 +580,12 @@ class CfnRegistry(
     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="registryRef")
+    def registry_ref(self) -> _RegistryReference_9f962fb0:
+        '''A reference to a Registry resource.'''
+        return typing.cast(_RegistryReference_9f962fb0, jsii.get(self, "registryRef"))
+
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> _TagManager_0a598cb3:
@@ -677,7 +701,7 @@ class CfnRegistry(
             )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IRegistryPolicyRef_a1fe7d28)
 class CfnRegistryPolicy(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -715,7 +739,8 @@ class CfnRegistryPolicy(
         registry_name: builtins.str,
         revision_id: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::EventSchemas::RegistryPolicy``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param policy: A resource-based policy.
@@ -776,6 +801,12 @@ class CfnRegistryPolicy(
     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="registryPolicyRef")
+    def registry_policy_ref(self) -> _RegistryPolicyReference_788dde78:
+        '''A reference to a RegistryPolicy resource.'''
+        return typing.cast(_RegistryPolicyReference_788dde78, jsii.get(self, "registryPolicyRef"))
+
     @builtins.property
     @jsii.member(jsii_name="policy")
     def policy(self) -> typing.Any:
@@ -1004,7 +1035,7 @@ class CfnRegistryProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
+@jsii.implements(_IInspectable_c2943556, _ISchemaRef_85adc95a, _ITaggable_36806126)
 class CfnSchema(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -1049,7 +1080,8 @@ class CfnSchema(
         schema_name: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union["CfnSchema.TagsEntryProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::EventSchemas::Schema``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param content: The source of the schema definition.
@@ -1154,6 +1186,12 @@ class CfnSchema(
     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="schemaRef")
+    def schema_ref(self) -> _SchemaReference_3c1ea018:
+        '''A reference to a Schema resource.'''
+        return typing.cast(_SchemaReference_3c1ea018, jsii.get(self, "schemaRef"))
+
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> _TagManager_0a598cb3: