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

aws_cdk/aws_appsync/__init__.py

@@ -1483,7 +1483,6 @@ from ..aws_iam import (
     IRole as _IRole_235f5d8e,
     Role as _Role_e8c6e11f,
 )
-from ..aws_kms import IKey as _IKey_5f11635f
 from ..aws_lambda import IFunction as _IFunction_6adb0ab8
 from ..aws_logs import (
     ILogGroup as _ILogGroup_3c4fa718, RetentionDays as _RetentionDays_070f99f0
@@ -1495,6 +1494,34 @@ from ..aws_rds import (
 )
 from ..aws_s3_assets import AssetOptions as _AssetOptions_2aa69621
 from ..aws_secretsmanager import ISecret as _ISecret_6e020e6a
+from ..interfaces.aws_appsync import (
+    ApiCacheReference as _ApiCacheReference_7deb2c07,
+    ApiKeyReference as _ApiKeyReference_0d3e4a31,
+    ApiReference as _ApiReference_f9af25ed,
+    ChannelNamespaceReference as _ChannelNamespaceReference_be895f9c,
+    DataSourceReference as _DataSourceReference_226e115b,
+    DomainNameApiAssociationReference as _DomainNameApiAssociationReference_7ae2b882,
+    DomainNameReference as _DomainNameReference_e0f7e463,
+    FunctionConfigurationReference as _FunctionConfigurationReference_8b9e75dc,
+    GraphQLApiReference as _GraphQLApiReference_833f473c,
+    GraphQLSchemaReference as _GraphQLSchemaReference_af442698,
+    IApiCacheRef as _IApiCacheRef_b621ec5d,
+    IApiKeyRef as _IApiKeyRef_f32c50c4,
+    IApiRef as _IApiRef_f01990a1,
+    IChannelNamespaceRef as _IChannelNamespaceRef_68af2ba2,
+    IDataSourceRef as _IDataSourceRef_7564634a,
+    IDomainNameApiAssociationRef as _IDomainNameApiAssociationRef_1dfe71c1,
+    IDomainNameRef as _IDomainNameRef_15b9da81,
+    IFunctionConfigurationRef as _IFunctionConfigurationRef_6eb53e57,
+    IGraphQLApiRef as _IGraphQLApiRef_d46d77ba,
+    IGraphQLSchemaRef as _IGraphQLSchemaRef_8bbfb35f,
+    IResolverRef as _IResolverRef_2a44c944,
+    ISourceApiAssociationRef as _ISourceApiAssociationRef_c89e9f16,
+    ResolverReference as _ResolverReference_1c237cfb,
+    SourceApiAssociationReference as _SourceApiAssociationReference_1d1f2085,
+)
+from ..interfaces.aws_iam import IRoleRef as _IRoleRef_8400221f
+from ..interfaces.aws_kms import IKeyRef as _IKeyRef_d4fc6ef3
 
 
 @jsii.data_type(
@@ -2296,6 +2323,8 @@ class AppSyncDataSourceType(enum.Enum):
     '''Relational DB data source type.'''
     BEDROCK = "BEDROCK"
     '''Bedrock runtime data source type.'''
+    ELASTICSEARCH = "ELASTICSEARCH"
+    '''Elasticsearch data source type.'''
 
 
 @jsii.data_type(
@@ -2950,7 +2979,7 @@ class AppSyncLogConfig:
         exclude_verbose_content: typing.Optional[builtins.bool] = None,
         field_log_level: typing.Optional[AppSyncFieldLogLevel] = None,
         retention: typing.Optional[_RetentionDays_070f99f0] = None,
-        role: typing.Optional[_IRole_235f5d8e] = None,
+        role: typing.Optional[_IRoleRef_8400221f] = None,
     ) -> None:
         '''Logging configuration for AppSync.
 
@@ -3039,13 +3068,13 @@ class AppSyncLogConfig:
         return typing.cast(typing.Optional[_RetentionDays_070f99f0], result)
 
     @builtins.property
-    def role(self) -> typing.Optional[_IRole_235f5d8e]:
+    def role(self) -> typing.Optional[_IRoleRef_8400221f]:
         '''The role for CloudWatch Logs.
 
         :default: - None
         '''
         result = self._values.get("role")
-        return typing.cast(typing.Optional[_IRole_235f5d8e], result)
+        return typing.cast(typing.Optional[_IRoleRef_8400221f], result)
 
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -4671,7 +4700,7 @@ class CachingConfig:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
+@jsii.implements(_IInspectable_c2943556, _IApiRef_f01990a1, _ITaggableV2_4e6798f8)
 class CfnApi(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -4755,7 +4784,8 @@ class CfnApi(
         owner_contact: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::Api``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param name: The name of the ``Api`` .
@@ -4806,6 +4836,12 @@ class CfnApi(
         '''The CloudFormation resource type name for this resource class.'''
         return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
 
+    @builtins.property
+    @jsii.member(jsii_name="apiRef")
+    def api_ref(self) -> _ApiReference_f9af25ed:
+        '''A reference to a Api resource.'''
+        return typing.cast(_ApiReference_f9af25ed, jsii.get(self, "apiRef"))
+
     @builtins.property
     @jsii.member(jsii_name="attrApiArn")
     def attr_api_arn(self) -> builtins.str:
@@ -5729,7 +5765,7 @@ class CfnApi(
             )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IApiCacheRef_b621ec5d)
 class CfnApiCache(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -5773,16 +5809,17 @@ class CfnApiCache(
         health_metrics_config: typing.Optional[builtins.str] = None,
         transit_encryption_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::ApiCache``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param api_caching_behavior: Caching behavior. - *FULL_REQUEST_CACHING* : All requests from the same user are cached. Individual resolvers are automatically cached. All API calls will try to return responses from the cache. - *PER_RESOLVER_CACHING* : Individual resolvers that you specify are cached. - *OPERATION_LEVEL_CACHING* : Full requests are cached together and returned without executing resolvers.
         :param api_id: The GraphQL API ID.
         :param ttl: TTL in seconds for cache entries. Valid values are 1–3,600 seconds.
         :param type: The cache instance type. Valid values are. - ``SMALL`` - ``MEDIUM`` - ``LARGE`` - ``XLARGE`` - ``LARGE_2X`` - ``LARGE_4X`` - ``LARGE_8X`` (not available in all regions) - ``LARGE_12X`` Historically, instance types were identified by an EC2-style value. As of July 2020, this is deprecated, and the generic identifiers above should be used. The following legacy instance types are available, but their use is discouraged: - *T2_SMALL* : A t2.small instance type. - *T2_MEDIUM* : A t2.medium instance type. - *R4_LARGE* : A r4.large instance type. - *R4_XLARGE* : A r4.xlarge instance type. - *R4_2XLARGE* : A r4.2xlarge instance type. - *R4_4XLARGE* : A r4.4xlarge instance type. - *R4_8XLARGE* : A r4.8xlarge instance type.
-        :param at_rest_encryption_enabled: At-rest encryption flag for cache. You cannot update this setting after creation.
+        :param at_rest_encryption_enabled: *This parameter has been deprecated* . At-rest encryption flag for cache. You cannot update this setting after creation.
         :param health_metrics_config: Controls how cache health metrics will be emitted to CloudWatch. Cache health metrics include:. - *NetworkBandwidthOutAllowanceExceeded* : The network packets dropped because the throughput exceeded the aggregated bandwidth limit. This is useful for diagnosing bottlenecks in a cache configuration. - *EngineCPUUtilization* : The CPU utilization (percentage) allocated to the Redis process. This is useful for diagnosing bottlenecks in a cache configuration. Metrics will be recorded by API ID. You can set the value to ``ENABLED`` or ``DISABLED`` .
-        :param transit_encryption_enabled: Transit encryption flag when connecting to cache. You cannot update this setting after creation.
+        :param transit_encryption_enabled: *This parameter has been deprecated* . Transit encryption flag when connecting to cache. You cannot update this setting after creation.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__e9d92b7b2abdac7341eb92f7ac10d2d67dd2700af68eaf42c72c47ffdaacc344)
@@ -5830,6 +5867,12 @@ class CfnApiCache(
         '''The CloudFormation resource type name for this resource class.'''
         return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
 
+    @builtins.property
+    @jsii.member(jsii_name="apiCacheRef")
+    def api_cache_ref(self) -> _ApiCacheReference_7deb2c07:
+        '''A reference to a ApiCache resource.'''
+        return typing.cast(_ApiCacheReference_7deb2c07, jsii.get(self, "apiCacheRef"))
+
     @builtins.property
     @jsii.member(jsii_name="attrId")
     def attr_id(self) -> builtins.str:
@@ -5903,7 +5946,7 @@ class CfnApiCache(
     def at_rest_encryption_enabled(
         self,
     ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-        '''At-rest encryption flag for cache.'''
+        '''*This parameter has been deprecated* .'''
         return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "atRestEncryptionEnabled"))
 
     @at_rest_encryption_enabled.setter
@@ -5937,7 +5980,7 @@ class CfnApiCache(
     def transit_encryption_enabled(
         self,
     ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-        '''Transit encryption flag when connecting to cache.'''
+        '''*This parameter has been deprecated* .'''
         return typing.cast(typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]], jsii.get(self, "transitEncryptionEnabled"))
 
     @transit_encryption_enabled.setter
@@ -5982,9 +6025,9 @@ class CfnApiCacheProps:
         :param api_id: The GraphQL API ID.
         :param ttl: TTL in seconds for cache entries. Valid values are 1–3,600 seconds.
         :param type: The cache instance type. Valid values are. - ``SMALL`` - ``MEDIUM`` - ``LARGE`` - ``XLARGE`` - ``LARGE_2X`` - ``LARGE_4X`` - ``LARGE_8X`` (not available in all regions) - ``LARGE_12X`` Historically, instance types were identified by an EC2-style value. As of July 2020, this is deprecated, and the generic identifiers above should be used. The following legacy instance types are available, but their use is discouraged: - *T2_SMALL* : A t2.small instance type. - *T2_MEDIUM* : A t2.medium instance type. - *R4_LARGE* : A r4.large instance type. - *R4_XLARGE* : A r4.xlarge instance type. - *R4_2XLARGE* : A r4.2xlarge instance type. - *R4_4XLARGE* : A r4.4xlarge instance type. - *R4_8XLARGE* : A r4.8xlarge instance type.
-        :param at_rest_encryption_enabled: At-rest encryption flag for cache. You cannot update this setting after creation.
+        :param at_rest_encryption_enabled: *This parameter has been deprecated* . At-rest encryption flag for cache. You cannot update this setting after creation.
         :param health_metrics_config: Controls how cache health metrics will be emitted to CloudWatch. Cache health metrics include:. - *NetworkBandwidthOutAllowanceExceeded* : The network packets dropped because the throughput exceeded the aggregated bandwidth limit. This is useful for diagnosing bottlenecks in a cache configuration. - *EngineCPUUtilization* : The CPU utilization (percentage) allocated to the Redis process. This is useful for diagnosing bottlenecks in a cache configuration. Metrics will be recorded by API ID. You can set the value to ``ENABLED`` or ``DISABLED`` .
-        :param transit_encryption_enabled: Transit encryption flag when connecting to cache. You cannot update this setting after creation.
+        :param transit_encryption_enabled: *This parameter has been deprecated* . Transit encryption flag when connecting to cache. You cannot update this setting after creation.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apicache.html
         :exampleMetadata: fixture=_generated
@@ -6100,9 +6143,9 @@ class CfnApiCacheProps:
     def at_rest_encryption_enabled(
         self,
     ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-        '''At-rest encryption flag for cache.
+        '''*This parameter has been deprecated* .
 
-        You cannot update this setting after creation.
+        At-rest encryption flag for cache. You cannot update this setting after creation.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apicache.html#cfn-appsync-apicache-atrestencryptionenabled
         '''
@@ -6127,9 +6170,9 @@ class CfnApiCacheProps:
     def transit_encryption_enabled(
         self,
     ) -> typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]]:
-        '''Transit encryption flag when connecting to cache.
+        '''*This parameter has been deprecated* .
 
-        You cannot update this setting after creation.
+        Transit encryption flag when connecting to cache. You cannot update this setting after creation.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-apicache.html#cfn-appsync-apicache-transitencryptionenabled
         '''
@@ -6148,7 +6191,7 @@ class CfnApiCacheProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IApiKeyRef_f32c50c4)
 class CfnApiKey(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -6184,7 +6227,8 @@ class CfnApiKey(
         description: typing.Optional[builtins.str] = None,
         expires: typing.Optional[jsii.Number] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::ApiKey``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param api_id: Unique AWS AppSync GraphQL API ID for this API key.
@@ -6229,6 +6273,12 @@ class CfnApiKey(
         '''The CloudFormation resource type name for this resource class.'''
         return typing.cast(builtins.str, jsii.sget(cls, "CFN_RESOURCE_TYPE_NAME"))
 
+    @builtins.property
+    @jsii.member(jsii_name="apiKeyRef")
+    def api_key_ref(self) -> _ApiKeyReference_0d3e4a31:
+        '''A reference to a ApiKey resource.'''
+        return typing.cast(_ApiKeyReference_0d3e4a31, jsii.get(self, "apiKeyRef"))
+
     @builtins.property
     @jsii.member(jsii_name="attrApiKey")
     def attr_api_key(self) -> builtins.str:
@@ -6555,7 +6605,7 @@ class CfnApiProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
+@jsii.implements(_IInspectable_c2943556, _IChannelNamespaceRef_68af2ba2, _ITaggableV2_4e6798f8)
 class CfnChannelNamespace(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -6633,17 +6683,18 @@ class CfnChannelNamespace(
         subscribe_auth_modes: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Sequence[typing.Union[_IResolvable_da3f097b, typing.Union["CfnChannelNamespace.AuthModeProperty", typing.Dict[builtins.str, typing.Any]]]]]] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::ChannelNamespace``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param api_id: AppSync Api Id that this Channel Namespace belongs to.
-        :param name: Namespace indentifier.
-        :param code_handlers: String of APPSYNC_JS code to be used by the handlers.
+        :param api_id: The ``Api`` ID.
+        :param name: The name of the channel namespace. This name must be unique within the ``Api`` .
+        :param code_handlers: The event handler functions that run custom business logic to process published events and subscribe requests.
         :param code_s3_location: The Amazon S3 endpoint where the code is located.
-        :param handler_configs: 
+        :param handler_configs: The configuration for the ``OnPublish`` and ``OnSubscribe`` handlers.
         :param publish_auth_modes: The authorization mode to use for publishing messages on the channel namespace. This configuration overrides the default ``Api`` authorization configuration.
         :param subscribe_auth_modes: The authorization mode to use for subscribing to messages on the channel namespace. This configuration overrides the default ``Api`` authorization configuration.
-        :param tags: An arbitrary set of tags (key-value pairs) for this AppSync API.
+        :param tags: A set of tags (key-value pairs) for this channel namespace.
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__a093c57f7353830d56f8cde41e8653e333d0f0b91da87dd9ca86d72460c39119)
@@ -6695,7 +6746,7 @@ class CfnChannelNamespace(
     @builtins.property
     @jsii.member(jsii_name="attrChannelNamespaceArn")
     def attr_channel_namespace_arn(self) -> builtins.str:
-        '''The Amazon Resource Name (ARN) for the Channel Namespace.
+        '''The Amazon Resource Name (ARN) of the channel namespace.
 
         :cloudformationAttribute: ChannelNamespaceArn
         '''
@@ -6712,10 +6763,16 @@ class CfnChannelNamespace(
     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="channelNamespaceRef")
+    def channel_namespace_ref(self) -> _ChannelNamespaceReference_be895f9c:
+        '''A reference to a ChannelNamespace resource.'''
+        return typing.cast(_ChannelNamespaceReference_be895f9c, jsii.get(self, "channelNamespaceRef"))
+
     @builtins.property
     @jsii.member(jsii_name="apiId")
     def api_id(self) -> builtins.str:
-        '''AppSync Api Id that this Channel Namespace belongs to.'''
+        '''The ``Api`` ID.'''
         return typing.cast(builtins.str, jsii.get(self, "apiId"))
 
     @api_id.setter
@@ -6728,7 +6785,7 @@ class CfnChannelNamespace(
     @builtins.property
     @jsii.member(jsii_name="name")
     def name(self) -> builtins.str:
-        '''Namespace indentifier.'''
+        '''The name of the channel namespace.'''
         return typing.cast(builtins.str, jsii.get(self, "name"))
 
     @name.setter
@@ -6741,7 +6798,7 @@ class CfnChannelNamespace(
     @builtins.property
     @jsii.member(jsii_name="codeHandlers")
     def code_handlers(self) -> typing.Optional[builtins.str]:
-        '''String of APPSYNC_JS code to be used by the handlers.'''
+        '''The event handler functions that run custom business logic to process published events and subscribe requests.'''
         return typing.cast(typing.Optional[builtins.str], jsii.get(self, "codeHandlers"))
 
     @code_handlers.setter
@@ -6769,6 +6826,7 @@ class CfnChannelNamespace(
     def handler_configs(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnChannelNamespace.HandlerConfigsProperty"]]:
+        '''The configuration for the ``OnPublish`` and ``OnSubscribe`` handlers.'''
         return typing.cast(typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnChannelNamespace.HandlerConfigsProperty"]], jsii.get(self, "handlerConfigs"))
 
     @handler_configs.setter
@@ -6820,7 +6878,7 @@ class CfnChannelNamespace(
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An arbitrary set of tags (key-value pairs) for this AppSync API.'''
+        '''A set of tags (key-value pairs) for this channel namespace.'''
         return typing.cast(typing.Optional[typing.List[_CfnTag_f6864754]], jsii.get(self, "tags"))
 
     @tags.setter
@@ -6837,9 +6895,11 @@ class CfnChannelNamespace(
     )
     class AuthModeProperty:
         def __init__(self, *, auth_type: typing.Optional[builtins.str] = None) -> None:
-            '''An auth mode.
+            '''Describes an authorization configuration.
 
-            :param auth_type: Security configuration for your AppSync API.
+            Use ``AuthMode`` to specify the publishing and subscription authorization configuration for an Event API.
+
+            :param auth_type: The authorization type.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-authmode.html
             :exampleMetadata: fixture=_generated
@@ -6863,7 +6923,7 @@ class CfnChannelNamespace(
 
         @builtins.property
         def auth_type(self) -> typing.Optional[builtins.str]:
-            '''Security configuration for your AppSync API.
+            '''The authorization type.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-authmode.html#cfn-appsync-channelnamespace-authmode-authtype
             '''
@@ -6893,9 +6953,10 @@ class CfnChannelNamespace(
             behavior: builtins.str,
             integration: typing.Union[_IResolvable_da3f097b, typing.Union["CfnChannelNamespace.IntegrationProperty", typing.Dict[builtins.str, typing.Any]]],
         ) -> None:
-            '''
-            :param behavior: Integration behavior for a handler configuration.
-            :param integration: 
+            '''The ``HandlerConfig`` property type specifies the configuration for the handler.
+
+            :param behavior: The behavior for the handler.
+            :param integration: The integration data source configuration for the handler.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-handlerconfig.html
             :exampleMetadata: fixture=_generated
@@ -6929,7 +6990,7 @@ class CfnChannelNamespace(
 
         @builtins.property
         def behavior(self) -> builtins.str:
-            '''Integration behavior for a handler configuration.
+            '''The behavior for the handler.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-handlerconfig.html#cfn-appsync-channelnamespace-handlerconfig-behavior
             '''
@@ -6941,7 +7002,8 @@ class CfnChannelNamespace(
         def integration(
             self,
         ) -> typing.Union[_IResolvable_da3f097b, "CfnChannelNamespace.IntegrationProperty"]:
-            '''
+            '''The integration data source configuration for the handler.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-handlerconfig.html#cfn-appsync-channelnamespace-handlerconfig-integration
             '''
             result = self._values.get("integration")
@@ -6971,9 +7033,10 @@ class CfnChannelNamespace(
             on_publish: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnChannelNamespace.HandlerConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
             on_subscribe: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnChannelNamespace.HandlerConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''
-            :param on_publish: 
-            :param on_subscribe: 
+            '''The ``HandlerConfigs`` property type specifies the configuration for the ``OnPublish`` and ``OnSubscribe`` handlers.
+
+            :param on_publish: The configuration for the ``OnPublish`` handler.
+            :param on_subscribe: The configuration for the ``OnSubscribe`` handler.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-handlerconfigs.html
             :exampleMetadata: fixture=_generated
@@ -7023,7 +7086,8 @@ class CfnChannelNamespace(
         def on_publish(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnChannelNamespace.HandlerConfigProperty"]]:
-            '''
+            '''The configuration for the ``OnPublish`` handler.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-handlerconfigs.html#cfn-appsync-channelnamespace-handlerconfigs-onpublish
             '''
             result = self._values.get("on_publish")
@@ -7033,7 +7097,8 @@ class CfnChannelNamespace(
         def on_subscribe(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnChannelNamespace.HandlerConfigProperty"]]:
-            '''
+            '''The configuration for the ``OnSubscribe`` handler.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-handlerconfigs.html#cfn-appsync-channelnamespace-handlerconfigs-onsubscribe
             '''
             result = self._values.get("on_subscribe")
@@ -7065,9 +7130,10 @@ class CfnChannelNamespace(
             data_source_name: builtins.str,
             lambda_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnChannelNamespace.LambdaConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         ) -> None:
-            '''
-            :param data_source_name: Data source to invoke for this integration.
-            :param lambda_config: 
+            '''The ``Integration`` property type specifies the integration data source configuration for the handler.
+
+            :param data_source_name: The unique name of the data source that has been configured on the API.
+            :param lambda_config: The configuration for a Lambda data source.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-integration.html
             :exampleMetadata: fixture=_generated
@@ -7099,7 +7165,7 @@ class CfnChannelNamespace(
 
         @builtins.property
         def data_source_name(self) -> builtins.str:
-            '''Data source to invoke for this integration.
+            '''The unique name of the data source that has been configured on the API.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-integration.html#cfn-appsync-channelnamespace-integration-datasourcename
             '''
@@ -7111,7 +7177,8 @@ class CfnChannelNamespace(
         def lambda_config(
             self,
         ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, "CfnChannelNamespace.LambdaConfigProperty"]]:
-            '''
+            '''The configuration for a Lambda data source.
+
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-integration.html#cfn-appsync-channelnamespace-integration-lambdaconfig
             '''
             result = self._values.get("lambda_config")
@@ -7135,8 +7202,9 @@ class CfnChannelNamespace(
     )
     class LambdaConfigProperty:
         def __init__(self, *, invoke_type: builtins.str) -> None:
-            '''
-            :param invoke_type: Invocation type for direct lambda integrations.
+            '''The ``LambdaConfig`` property type specifies the integration configuration for a Lambda data source.
+
+            :param invoke_type: The invocation type for a Lambda data source.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-lambdaconfig.html
             :exampleMetadata: fixture=_generated
@@ -7160,7 +7228,7 @@ class CfnChannelNamespace(
 
         @builtins.property
         def invoke_type(self) -> builtins.str:
-            '''Invocation type for direct lambda integrations.
+            '''The invocation type for a Lambda data source.
 
             :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-appsync-channelnamespace-lambdaconfig.html#cfn-appsync-channelnamespace-lambdaconfig-invoketype
             '''
@@ -7209,14 +7277,14 @@ class CfnChannelNamespaceProps:
     ) -> None:
         '''Properties for defining a ``CfnChannelNamespace``.
 
-        :param api_id: AppSync Api Id that this Channel Namespace belongs to.
-        :param name: Namespace indentifier.
-        :param code_handlers: String of APPSYNC_JS code to be used by the handlers.
+        :param api_id: The ``Api`` ID.
+        :param name: The name of the channel namespace. This name must be unique within the ``Api`` .
+        :param code_handlers: The event handler functions that run custom business logic to process published events and subscribe requests.
         :param code_s3_location: The Amazon S3 endpoint where the code is located.
-        :param handler_configs: 
+        :param handler_configs: The configuration for the ``OnPublish`` and ``OnSubscribe`` handlers.
         :param publish_auth_modes: The authorization mode to use for publishing messages on the channel namespace. This configuration overrides the default ``Api`` authorization configuration.
         :param subscribe_auth_modes: The authorization mode to use for subscribing to messages on the channel namespace. This configuration overrides the default ``Api`` authorization configuration.
-        :param tags: An arbitrary set of tags (key-value pairs) for this AppSync API.
+        :param tags: A set of tags (key-value pairs) for this channel namespace.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-channelnamespace.html
         :exampleMetadata: fixture=_generated
@@ -7299,7 +7367,7 @@ class CfnChannelNamespaceProps:
 
     @builtins.property
     def api_id(self) -> builtins.str:
-        '''AppSync Api Id that this Channel Namespace belongs to.
+        '''The ``Api`` ID.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-channelnamespace.html#cfn-appsync-channelnamespace-apiid
         '''
@@ -7309,7 +7377,9 @@ class CfnChannelNamespaceProps:
 
     @builtins.property
     def name(self) -> builtins.str:
-        '''Namespace indentifier.
+        '''The name of the channel namespace.
+
+        This name must be unique within the ``Api`` .
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-channelnamespace.html#cfn-appsync-channelnamespace-name
         '''
@@ -7319,7 +7389,7 @@ class CfnChannelNamespaceProps:
 
     @builtins.property
     def code_handlers(self) -> typing.Optional[builtins.str]:
-        '''String of APPSYNC_JS code to be used by the handlers.
+        '''The event handler functions that run custom business logic to process published events and subscribe requests.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-channelnamespace.html#cfn-appsync-channelnamespace-codehandlers
         '''
@@ -7339,7 +7409,8 @@ class CfnChannelNamespaceProps:
     def handler_configs(
         self,
     ) -> typing.Optional[typing.Union[_IResolvable_da3f097b, CfnChannelNamespace.HandlerConfigsProperty]]:
-        '''
+        '''The configuration for the ``OnPublish`` and ``OnSubscribe`` handlers.
+
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-channelnamespace.html#cfn-appsync-channelnamespace-handlerconfigs
         '''
         result = self._values.get("handler_configs")
@@ -7373,7 +7444,7 @@ class CfnChannelNamespaceProps:
 
     @builtins.property
     def tags(self) -> typing.Optional[typing.List[_CfnTag_f6864754]]:
-        '''An arbitrary set of tags (key-value pairs) for this AppSync API.
+        '''A set of tags (key-value pairs) for this channel namespace.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-channelnamespace.html#cfn-appsync-channelnamespace-tags
         '''
@@ -7392,7 +7463,7 @@ class CfnChannelNamespaceProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IDataSourceRef_7564634a)
 class CfnDataSource(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -7498,7 +7569,8 @@ class CfnDataSource(
         relational_database_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnDataSource.RelationalDatabaseConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         service_role_arn: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::DataSource``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param api_id: Unique AWS AppSync GraphQL API identifier where this data source will be created.
@@ -7590,6 +7662,12 @@ class CfnDataSource(
     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="dataSourceRef")
+    def data_source_ref(self) -> _DataSourceReference_226e115b:
+        '''A reference to a DataSource resource.'''
+        return typing.cast(_DataSourceReference_226e115b, jsii.get(self, "dataSourceRef"))
+
     @builtins.property
     @jsii.member(jsii_name="apiId")
     def api_id(self) -> builtins.str:
@@ -9067,7 +9145,7 @@ class CfnDataSourceProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggableV2_4e6798f8)
+@jsii.implements(_IInspectable_c2943556, _IDomainNameRef_15b9da81, _ITaggableV2_4e6798f8)
 class CfnDomainName(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -9108,10 +9186,11 @@ class CfnDomainName(
         description: typing.Optional[builtins.str] = None,
         tags: typing.Optional[typing.Sequence[typing.Union[_CfnTag_f6864754, typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::DomainName``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
-        :param certificate_arn: The Amazon Resource Name (ARN) of the certificate. This will be an AWS Certificate Manager certificate.
+        :param certificate_arn: The Amazon Resource Name (ARN) of the certificate. This will be an Certificate Manager certificate.
         :param domain_name: The domain name.
         :param description: The decription for your domain name.
         :param tags: A set of tags (key-value pairs) for this domain name.
@@ -9129,6 +9208,48 @@ class CfnDomainName(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @jsii.member(jsii_name="fromDomainName")
+    @builtins.classmethod
+    def from_domain_name(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        domain_name: builtins.str,
+    ) -> _IDomainNameRef_15b9da81:
+        '''Creates a new IDomainNameRef from a domainName.
+
+        :param scope: -
+        :param id: -
+        :param domain_name: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__08c6def9587107d2278647a6d441c9caf964fa2d78a1d3deaea83b39bee09293)
+            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 domain_name", value=domain_name, expected_type=type_hints["domain_name"])
+        return typing.cast(_IDomainNameRef_15b9da81, jsii.sinvoke(cls, "fromDomainName", [scope, id, domain_name]))
+
+    @jsii.member(jsii_name="fromDomainNameArn")
+    @builtins.classmethod
+    def from_domain_name_arn(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        arn: builtins.str,
+    ) -> _IDomainNameRef_15b9da81:
+        '''Creates a new IDomainNameRef from an ARN.
+
+        :param scope: -
+        :param id: -
+        :param arn: -
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__749c3931247d77e821eae72c97fb9d854d79132a8471c8a0dbc46bb29336cbda)
+            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 arn", value=arn, expected_type=type_hints["arn"])
+        return typing.cast(_IDomainNameRef_15b9da81, jsii.sinvoke(cls, "fromDomainNameArn", [scope, id, arn]))
+
     @jsii.member(jsii_name="inspect")
     def inspect(self, inspector: _TreeInspector_488e0dd5) -> None:
         '''Examines the CloudFormation resource and discloses attributes.
@@ -9206,6 +9327,12 @@ class CfnDomainName(
     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="domainNameRef")
+    def domain_name_ref(self) -> _DomainNameReference_e0f7e463:
+        '''A reference to a DomainName resource.'''
+        return typing.cast(_DomainNameReference_e0f7e463, jsii.get(self, "domainNameRef"))
+
     @builtins.property
     @jsii.member(jsii_name="certificateArn")
     def certificate_arn(self) -> builtins.str:
@@ -9259,7 +9386,7 @@ class CfnDomainName(
         jsii.set(self, "tags", value) # pyright: ignore[reportArgumentType]
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IDomainNameApiAssociationRef_1dfe71c1)
 class CfnDomainNameApiAssociation(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -9291,7 +9418,8 @@ class CfnDomainNameApiAssociation(
         api_id: builtins.str,
         domain_name: builtins.str,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::DomainNameApiAssociation``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param api_id: The API ID.
@@ -9350,6 +9478,14 @@ class CfnDomainNameApiAssociation(
     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="domainNameApiAssociationRef")
+    def domain_name_api_association_ref(
+        self,
+    ) -> _DomainNameApiAssociationReference_7ae2b882:
+        '''A reference to a DomainNameApiAssociation resource.'''
+        return typing.cast(_DomainNameApiAssociationReference_7ae2b882, jsii.get(self, "domainNameApiAssociationRef"))
+
     @builtins.property
     @jsii.member(jsii_name="apiId")
     def api_id(self) -> builtins.str:
@@ -9465,7 +9601,7 @@ class CfnDomainNameProps:
     ) -> None:
         '''Properties for defining a ``CfnDomainName``.
 
-        :param certificate_arn: The Amazon Resource Name (ARN) of the certificate. This will be an AWS Certificate Manager certificate.
+        :param certificate_arn: The Amazon Resource Name (ARN) of the certificate. This will be an Certificate Manager certificate.
         :param domain_name: The domain name.
         :param description: The decription for your domain name.
         :param tags: A set of tags (key-value pairs) for this domain name.
@@ -9510,7 +9646,7 @@ class CfnDomainNameProps:
     def certificate_arn(self) -> builtins.str:
         '''The Amazon Resource Name (ARN) of the certificate.
 
-        This will be an AWS Certificate Manager certificate.
+        This will be an Certificate Manager certificate.
 
         :see: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-appsync-domainname.html#cfn-appsync-domainname-certificatearn
         '''
@@ -9558,7 +9694,7 @@ class CfnDomainNameProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IFunctionConfigurationRef_6eb53e57)
 class CfnFunctionConfiguration(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -9634,7 +9770,8 @@ class CfnFunctionConfiguration(
         runtime: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnFunctionConfiguration.AppSyncRuntimeProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         sync_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnFunctionConfiguration.SyncConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::FunctionConfiguration``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param api_id: The AWS AppSync GraphQL API that you want to attach using this function.
@@ -9746,6 +9883,12 @@ class CfnFunctionConfiguration(
     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="functionConfigurationRef")
+    def function_configuration_ref(self) -> _FunctionConfigurationReference_8b9e75dc:
+        '''A reference to a FunctionConfiguration resource.'''
+        return typing.cast(_FunctionConfigurationReference_8b9e75dc, jsii.get(self, "functionConfigurationRef"))
+
     @builtins.property
     @jsii.member(jsii_name="apiId")
     def api_id(self) -> builtins.str:
@@ -10480,7 +10623,7 @@ class CfnFunctionConfigurationProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556, _ITaggable_36806126)
+@jsii.implements(_IInspectable_c2943556, _IGraphQLApiRef_d46d77ba, _ITaggable_36806126)
 class CfnGraphQLApi(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -10595,7 +10738,8 @@ class CfnGraphQLApi(
         visibility: typing.Optional[builtins.str] = None,
         xray_enabled: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::GraphQLApi``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param authentication_type: Security configuration for your GraphQL API. For allowed values (such as ``API_KEY`` , ``AWS_IAM`` , ``AMAZON_COGNITO_USER_POOLS`` , ``OPENID_CONNECT`` , or ``AWS_LAMBDA`` ), see `Security <https://docs.aws.amazon.com/appsync/latest/devguide/security.html>`_ in the *AWS AppSync Developer Guide* .
@@ -10744,6 +10888,12 @@ class CfnGraphQLApi(
     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="graphQlApiRef")
+    def graph_ql_api_ref(self) -> _GraphQLApiReference_833f473c:
+        '''A reference to a GraphQLApi resource.'''
+        return typing.cast(_GraphQLApiReference_833f473c, jsii.get(self, "graphQlApiRef"))
+
     @builtins.property
     @jsii.member(jsii_name="tags")
     def tags(self) -> _TagManager_0a598cb3:
@@ -12224,7 +12374,7 @@ class CfnGraphQLApiProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IGraphQLSchemaRef_8bbfb35f)
 class CfnGraphQLSchema(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -12267,7 +12417,8 @@ class CfnGraphQLSchema(
         definition: typing.Optional[builtins.str] = None,
         definition_s3_location: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::GraphQLSchema``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param api_id: The AWS AppSync GraphQL API identifier to which you want to apply this schema.
@@ -12330,6 +12481,12 @@ class CfnGraphQLSchema(
     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="graphQlSchemaRef")
+    def graph_ql_schema_ref(self) -> _GraphQLSchemaReference_af442698:
+        '''A reference to a GraphQLSchema resource.'''
+        return typing.cast(_GraphQLSchemaReference_af442698, jsii.get(self, "graphQlSchemaRef"))
+
     @builtins.property
     @jsii.member(jsii_name="apiId")
     def api_id(self) -> builtins.str:
@@ -12467,7 +12624,7 @@ class CfnGraphQLSchemaProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IResolverRef_2a44c944)
 class CfnResolver(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -12556,7 +12713,8 @@ class CfnResolver(
         runtime: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnResolver.AppSyncRuntimeProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         sync_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnResolver.SyncConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::Resolver``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param api_id: The AWS AppSync GraphQL API to which you want to attach this resolver.
@@ -12665,6 +12823,12 @@ class CfnResolver(
     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="resolverRef")
+    def resolver_ref(self) -> _ResolverReference_1c237cfb:
+        '''A reference to a Resolver resource.'''
+        return typing.cast(_ResolverReference_1c237cfb, jsii.get(self, "resolverRef"))
+
     @builtins.property
     @jsii.member(jsii_name="apiId")
     def api_id(self) -> builtins.str:
@@ -13642,7 +13806,7 @@ class CfnResolverProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _ISourceApiAssociationRef_c89e9f16)
 class CfnSourceApiAssociation(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -13682,7 +13846,8 @@ class CfnSourceApiAssociation(
         source_api_association_config: typing.Optional[typing.Union[_IResolvable_da3f097b, typing.Union["CfnSourceApiAssociation.SourceApiAssociationConfigProperty", typing.Dict[builtins.str, typing.Any]]]] = None,
         source_api_identifier: typing.Optional[builtins.str] = None,
     ) -> None:
-        '''
+        '''Create a new ``AWS::AppSync::SourceApiAssociation``.
+
         :param scope: Scope in which this resource is defined.
         :param id: Construct identifier for this resource (unique in its scope).
         :param description: The description field of the association configuration.
@@ -13825,6 +13990,12 @@ class CfnSourceApiAssociation(
     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="sourceApiAssociationRef")
+    def source_api_association_ref(self) -> _SourceApiAssociationReference_1d1f2085:
+        '''A reference to a SourceApiAssociation resource.'''
+        return typing.cast(_SourceApiAssociationReference_1d1f2085, jsii.get(self, "sourceApiAssociationRef"))
+
     @builtins.property
     @jsii.member(jsii_name="description")
     def description(self) -> typing.Optional[builtins.str]:
@@ -14376,7 +14547,7 @@ class Code(metaclass=jsii.JSIIAbstractClass, jsii_type="aws-cdk-lib.aws_appsync.
         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,
@@ -18478,7 +18649,7 @@ class LogConfig:
         exclude_verbose_content: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
         field_log_level: typing.Optional[FieldLogLevel] = None,
         retention: typing.Optional[_RetentionDays_070f99f0] = None,
-        role: typing.Optional[_IRole_235f5d8e] = None,
+        role: typing.Optional[_IRoleRef_8400221f] = None,
     ) -> None:
         '''Logging configuration for AppSync.
 
@@ -18554,13 +18725,13 @@ class LogConfig:
         return typing.cast(typing.Optional[_RetentionDays_070f99f0], result)
 
     @builtins.property
-    def role(self) -> typing.Optional[_IRole_235f5d8e]:
+    def role(self) -> typing.Optional[_IRoleRef_8400221f]:
         '''The role for CloudWatch Logs.
 
         :default: - None
         '''
         result = self._values.get("role")
-        return typing.cast(typing.Optional[_IRole_235f5d8e], result)
+        return typing.cast(typing.Optional[_IRoleRef_8400221f], result)
 
     def __eq__(self, rhs: typing.Any) -> builtins.bool:
         return isinstance(rhs, self.__class__) and rhs._values == self._values
@@ -20147,6 +20318,12 @@ class SourceApiAssociation(
 
         return typing.cast(ISourceApiAssociation, jsii.sinvoke(cls, "fromSourceApiAssociationAttributes", [scope, id, attrs]))
 
+    @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="association")
     def association(self) -> CfnSourceApiAssociation:
@@ -22470,6 +22647,12 @@ class AppsyncFunction(
 
         return typing.cast(IAppsyncFunction, jsii.sinvoke(cls, "fromAppsyncFunctionAttributes", [scope, id, attrs]))
 
+    @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="dataSource")
     def data_source(self) -> BaseDataSource:
@@ -22697,11 +22880,11 @@ class AssetCode(
         import aws_cdk as cdk
         from aws_cdk import aws_appsync as appsync
         from aws_cdk import aws_iam as iam
-        from aws_cdk import aws_kms as kms
+        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 = appsync.AssetCode("path",
@@ -22739,7 +22922,7 @@ class AssetCode(
             follow_symlinks=cdk.SymlinkFollowMode.NEVER,
             ignore_mode=cdk.IgnoreMode.GLOB,
             readers=[grantable],
-            source_kMSKey=key
+            source_kMSKey=key_ref
         )
     '''
 
@@ -22750,7 +22933,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,
@@ -23110,6 +23293,12 @@ class ChannelNamespace(
             check_type(argname="argument grantee", value=grantee, expected_type=type_hints["grantee"])
         return typing.cast(_Grant_a7ae64f8, jsii.invoke(self, "grantSubscribe", [grantee]))
 
+    @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="channelNamespaceArn")
     def channel_namespace_arn(self) -> builtins.str:
@@ -23217,6 +23406,12 @@ class DynamoDbDataSource(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @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"))
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_appsync.DynamoDbDataSourceProps",
@@ -23990,6 +24185,12 @@ class EventBridgeDataSource(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @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"))
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_appsync.EventBridgeDataSourceProps",
@@ -24666,6 +24867,12 @@ class HttpDataSource(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @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"))
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_appsync.HttpDataSourceProps",
@@ -24876,6 +25083,12 @@ class LambdaDataSource(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @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"))
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_appsync.LambdaDataSourceProps",
@@ -25084,6 +25297,12 @@ class OpenSearchDataSource(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @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"))
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_appsync.OpenSearchDataSourceProps",
@@ -25364,6 +25583,12 @@ class RdsDataSource(
 
         jsii.create(self.__class__, self, [scope, id, props])
 
+    @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"))
+
 
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_appsync.RdsDataSourceProps",
@@ -25789,6 +26014,12 @@ class EventApi(
 
         return typing.cast(IEventApi, jsii.sinvoke(cls, "fromEventApiAttributes", [scope, id, attrs]))
 
+    @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="apiArn")
     def api_arn(self) -> builtins.str:
@@ -26026,6 +26257,12 @@ class GraphqlApi(
             check_type(argname="argument construct", value=construct, expected_type=type_hints["construct"])
         return typing.cast(builtins.bool, jsii.invoke(self, "addSchemaDependency", [construct]))
 
+    @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="apiId")
     def api_id(self) -> builtins.str:
@@ -26408,7 +26645,7 @@ def _typecheckingstub__1f071c5d78b2c37c516b5230a27a665e8b9516682c1dc9b40977c1312
     exclude_verbose_content: typing.Optional[builtins.bool] = None,
     field_log_level: typing.Optional[AppSyncFieldLogLevel] = None,
     retention: typing.Optional[_RetentionDays_070f99f0] = None,
-    role: typing.Optional[_IRole_235f5d8e] = None,
+    role: typing.Optional[_IRoleRef_8400221f] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -27237,6 +27474,22 @@ def _typecheckingstub__678693553586e835af6ffdc6ac5860f81ffd96791de73368d44d41d3a
     """Type checking stubs"""
     pass
 
+def _typecheckingstub__08c6def9587107d2278647a6d441c9caf964fa2d78a1d3deaea83b39bee09293(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    domain_name: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__749c3931247d77e821eae72c97fb9d854d79132a8471c8a0dbc46bb29336cbda(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    arn: builtins.str,
+) -> None:
+    """Type checking stubs"""
+    pass
+
 def _typecheckingstub__a1bb36f58b6037c649f6de5b27bf9555b52f554bb5fe4108f80d1e6143cb6f24(
     inspector: _TreeInspector_488e0dd5,
 ) -> None:
@@ -28068,7 +28321,7 @@ def _typecheckingstub__8eafa9f4fd31cdfcc23e497d115c1733ce980674eb036dad379eb9102
     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,
@@ -28617,7 +28870,7 @@ def _typecheckingstub__d73860e597bcfca4336f77cac0c6ce67113883e4171d802987f80c349
     exclude_verbose_content: typing.Optional[typing.Union[builtins.bool, _IResolvable_da3f097b]] = None,
     field_log_level: typing.Optional[FieldLogLevel] = None,
     retention: typing.Optional[_RetentionDays_070f99f0] = None,
-    role: typing.Optional[_IRole_235f5d8e] = None,
+    role: typing.Optional[_IRoleRef_8400221f] = None,
 ) -> None:
     """Type checking stubs"""
     pass
@@ -29156,7 +29409,7 @@ def _typecheckingstub__f64c3b5b60096d2f072c0237f4540425eb18b7539e311bcd346760100
     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,
@@ -29793,3 +30046,6 @@ def _typecheckingstub__fca5d6afc67603703e938a4f127d82a052b1172c6c07cab72c6e3bded
 ) -> None:
     """Type checking stubs"""
     pass
+
+for cls in [IApi, IAppSyncAuthConfig, IAppsyncFunction, IChannelNamespace, IEventApi, IGraphqlApi, ISchema, ISchemaConfig, ISourceApiAssociation]:
+    typing.cast(typing.Any, cls).__protocol_attrs__ = typing.cast(typing.Any, cls).__protocol_attrs__ - set(['__jsii_proxy_class__', '__jsii_type__'])