aws-cdk-lib 2.200.2__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(
@@ -2952,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.
 
@@ -3041,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
@@ -4673,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,
@@ -4757,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`` .
@@ -4808,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:
@@ -5731,7 +5765,7 @@ class CfnApi(
             )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IApiCacheRef_b621ec5d)
 class CfnApiCache(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -5775,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)
@@ -5832,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:
@@ -5905,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
@@ -5939,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
@@ -5984,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
@@ -6102,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
         '''
@@ -6129,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
         '''
@@ -6150,7 +6191,7 @@ class CfnApiCacheProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IApiKeyRef_f32c50c4)
 class CfnApiKey(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -6186,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.
@@ -6231,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:
@@ -6557,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,
@@ -6635,7 +6683,8 @@ 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: The ``Api`` ID.
@@ -6714,6 +6763,12 @@ 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:
@@ -7408,7 +7463,7 @@ class CfnChannelNamespaceProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IDataSourceRef_7564634a)
 class CfnDataSource(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -7514,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.
@@ -7606,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:
@@ -9083,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,
@@ -9124,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.
@@ -9145,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.
@@ -9222,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:
@@ -9275,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,
@@ -9307,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.
@@ -9366,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:
@@ -9481,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.
@@ -9526,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
         '''
@@ -9574,7 +9694,7 @@ class CfnDomainNameProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IFunctionConfigurationRef_6eb53e57)
 class CfnFunctionConfiguration(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -9650,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.
@@ -9762,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:
@@ -10496,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,
@@ -10611,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* .
@@ -10760,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:
@@ -12240,7 +12374,7 @@ class CfnGraphQLApiProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IGraphQLSchemaRef_8bbfb35f)
 class CfnGraphQLSchema(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -12283,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.
@@ -12346,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:
@@ -12483,7 +12624,7 @@ class CfnGraphQLSchemaProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _IResolverRef_2a44c944)
 class CfnResolver(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -12572,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.
@@ -12681,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:
@@ -13658,7 +13806,7 @@ class CfnResolverProps:
         )
 
 
-@jsii.implements(_IInspectable_c2943556)
+@jsii.implements(_IInspectable_c2943556, _ISourceApiAssociationRef_c89e9f16)
 class CfnSourceApiAssociation(
     _CfnResource_9df397a6,
     metaclass=jsii.JSIIMeta,
@@ -13698,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.
@@ -13841,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]:
@@ -14392,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,
@@ -18494,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.
 
@@ -18570,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
@@ -22725,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",
@@ -22767,7 +22922,7 @@ class AssetCode(
             follow_symlinks=cdk.SymlinkFollowMode.NEVER,
             ignore_mode=cdk.IgnoreMode.GLOB,
             readers=[grantable],
-            source_kMSKey=key
+            source_kMSKey=key_ref
         )
     '''
 
@@ -22778,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,
@@ -26490,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
@@ -27319,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:
@@ -28150,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,
@@ -28699,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
@@ -29238,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,
@@ -29875,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__'])