aws-cdk-lib 2.96.2__py3-none-any.whl → 2.97.1__py3-none-any.whl

aws_cdk/aws_appsync/__init__.py

@@ -388,21 +388,42 @@ second_api.add_none_data_source("SecondSourceDS",
 )
 
 # Merged API
-appsync.GraphqlApi(self, "MergedAPI",
+merged_api = appsync.GraphqlApi(self, "MergedAPI",
     name="MergedAPI",
     definition=appsync.Definition.from_source_apis(
         source_apis=[appsync.SourceApi(
             source_api=first_api,
             merge_type=appsync.MergeType.MANUAL_MERGE
-        ), appsync.SourceApi(
-            source_api=second_api,
-            merge_type=appsync.MergeType.AUTO_MERGE
         )
         ]
     )
 )
 ```
 
+## Merged APIs Across Different Stacks
+
+The SourceApiAssociation construct allows you to define a SourceApiAssociation to a Merged API in a different stack or account. This allows a source API owner the ability to associate it to an existing Merged API itself.
+
+```python
+source_api = appsync.GraphqlApi(self, "FirstSourceAPI",
+    name="FirstSourceAPI",
+    definition=appsync.Definition.from_file(path.join(__dirname, "appsync.merged-api-1.graphql"))
+)
+
+imported_merged_api = appsync.GraphqlApi.from_graphql_api_attributes(self, "ImportedMergedApi",
+    graphql_api_id="MyApiId",
+    graphql_api_arn="MyApiArn"
+)
+
+imported_execution_role = iam.Role.from_role_arn(self, "ExecutionRole", "arn:aws:iam::ACCOUNT:role/MyExistingRole")
+appsync.SourceApiAssociation(self, "SourceApiAssociation2",
+    source_api=source_api,
+    merged_api=imported_merged_api,
+    merge_type=appsync.MergeType.MANUAL_MERGE,
+    merged_api_execution_role=imported_execution_role
+)
+```
+
 ## Custom Domain Names
 
 For many use cases you may want to associate a custom domain name with your
@@ -9352,15 +9373,12 @@ class DataSourceOptions:
             )
             
             # Merged API
-            appsync.GraphqlApi(self, "MergedAPI",
+            merged_api = appsync.GraphqlApi(self, "MergedAPI",
                 name="MergedAPI",
                 definition=appsync.Definition.from_source_apis(
                     source_apis=[appsync.SourceApi(
                         source_api=first_api,
                         merge_type=appsync.MergeType.MANUAL_MERGE
-                    ), appsync.SourceApi(
-                        source_api=second_api,
-                        merge_type=appsync.MergeType.AUTO_MERGE
                     )
                     ]
                 )
@@ -9418,23 +9436,22 @@ class Definition(
 
     Example::
 
-        import aws_cdk.aws_events as events
-        
-        
-        api = appsync.GraphqlApi(self, "EventBridgeApi",
-            name="EventBridgeApi",
-            definition=appsync.Definition.from_file(path.join(__dirname, "appsync.eventbridge.graphql"))
+        source_api = appsync.GraphqlApi(self, "FirstSourceAPI",
+            name="FirstSourceAPI",
+            definition=appsync.Definition.from_file(path.join(__dirname, "appsync.merged-api-1.graphql"))
         )
         
-        bus = events.EventBus(self, "DestinationEventBus")
-        
-        data_source = api.add_event_bridge_data_source("NoneDS", bus)
+        imported_merged_api = appsync.GraphqlApi.from_graphql_api_attributes(self, "ImportedMergedApi",
+            graphql_api_id="MyApiId",
+            graphql_api_arn="MyApiArn"
+        )
         
-        data_source.create_resolver("EventResolver",
-            type_name="Mutation",
-            field_name="emitEvent",
-            request_mapping_template=appsync.MappingTemplate.from_file("request.vtl"),
-            response_mapping_template=appsync.MappingTemplate.from_file("response.vtl")
+        imported_execution_role = iam.Role.from_role_arn(self, "ExecutionRole", "arn:aws:iam::ACCOUNT:role/MyExistingRole")
+        appsync.SourceApiAssociation(self, "SourceApiAssociation2",
+            source_api=source_api,
+            merged_api=imported_merged_api,
+            merge_type=appsync.MergeType.MANUAL_MERGE,
+            merged_api_execution_role=imported_execution_role
         )
     '''
 
@@ -10179,14 +10196,23 @@ class GraphqlApiAttributes:
 
         Example::
 
-            # api: appsync.GraphqlApi
-            # table: dynamodb.Table
+            source_api = appsync.GraphqlApi(self, "FirstSourceAPI",
+                name="FirstSourceAPI",
+                definition=appsync.Definition.from_file(path.join(__dirname, "appsync.merged-api-1.graphql"))
+            )
             
-            imported_api = appsync.GraphqlApi.from_graphql_api_attributes(self, "IApi",
-                graphql_api_id=api.api_id,
-                graphql_api_arn=api.arn
+            imported_merged_api = appsync.GraphqlApi.from_graphql_api_attributes(self, "ImportedMergedApi",
+                graphql_api_id="MyApiId",
+                graphql_api_arn="MyApiArn"
+            )
+            
+            imported_execution_role = iam.Role.from_role_arn(self, "ExecutionRole", "arn:aws:iam::ACCOUNT:role/MyExistingRole")
+            appsync.SourceApiAssociation(self, "SourceApiAssociation2",
+                source_api=source_api,
+                merged_api=imported_merged_api,
+                merge_type=appsync.MergeType.MANUAL_MERGE,
+                merged_api_execution_role=imported_execution_role
             )
-            imported_api.add_dynamo_db_data_source("TableDataSource", table)
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__ec1fc91e210b45240155885dae82dd53ddc084048aae2724cd942ec7c5202c10)
@@ -10268,23 +10294,22 @@ class GraphqlApiProps:
 
         Example::
 
-            import aws_cdk.aws_events as events
-            
-            
-            api = appsync.GraphqlApi(self, "EventBridgeApi",
-                name="EventBridgeApi",
-                definition=appsync.Definition.from_file(path.join(__dirname, "appsync.eventbridge.graphql"))
+            source_api = appsync.GraphqlApi(self, "FirstSourceAPI",
+                name="FirstSourceAPI",
+                definition=appsync.Definition.from_file(path.join(__dirname, "appsync.merged-api-1.graphql"))
             )
             
-            bus = events.EventBus(self, "DestinationEventBus")
-            
-            data_source = api.add_event_bridge_data_source("NoneDS", bus)
+            imported_merged_api = appsync.GraphqlApi.from_graphql_api_attributes(self, "ImportedMergedApi",
+                graphql_api_id="MyApiId",
+                graphql_api_arn="MyApiArn"
+            )
             
-            data_source.create_resolver("EventResolver",
-                type_name="Mutation",
-                field_name="emitEvent",
-                request_mapping_template=appsync.MappingTemplate.from_file("request.vtl"),
-                response_mapping_template=appsync.MappingTemplate.from_file("response.vtl")
+            imported_execution_role = iam.Role.from_role_arn(self, "ExecutionRole", "arn:aws:iam::ACCOUNT:role/MyExistingRole")
+            appsync.SourceApiAssociation(self, "SourceApiAssociation2",
+                source_api=source_api,
+                merged_api=imported_merged_api,
+                merge_type=appsync.MergeType.MANUAL_MERGE,
+                merged_api_execution_role=imported_execution_role
             )
         '''
         if isinstance(authorization_config, dict):
@@ -10372,7 +10397,7 @@ class GraphqlApiProps:
 
         :default: - schema will be generated code-first (i.e. addType, addObjectType, etc.)
 
-        :deprecated: use apiSoure.schema instead
+        :deprecated: use apiSource.schema instead
 
         :stability: deprecated
         '''
@@ -11313,6 +11338,70 @@ class _ISchemaConfigProxy:
 typing.cast(typing.Any, ISchemaConfig).__jsii_proxy_class__ = lambda : _ISchemaConfigProxy
 
 
+@jsii.interface(jsii_type="aws-cdk-lib.aws_appsync.ISourceApiAssociation")
+class ISourceApiAssociation(_IResource_c80c4260, typing_extensions.Protocol):
+    '''Interface for AppSync Source Api Association.'''
+
+    @builtins.property
+    @jsii.member(jsii_name="associationArn")
+    def association_arn(self) -> builtins.str:
+        '''The association arn.'''
+        ...
+
+    @builtins.property
+    @jsii.member(jsii_name="associationId")
+    def association_id(self) -> builtins.str:
+        '''The association id.'''
+        ...
+
+    @builtins.property
+    @jsii.member(jsii_name="mergedApi")
+    def merged_api(self) -> IGraphqlApi:
+        '''The merged api in the association.'''
+        ...
+
+    @builtins.property
+    @jsii.member(jsii_name="sourceApi")
+    def source_api(self) -> IGraphqlApi:
+        '''The source api in the association.'''
+        ...
+
+
+class _ISourceApiAssociationProxy(
+    jsii.proxy_for(_IResource_c80c4260), # type: ignore[misc]
+):
+    '''Interface for AppSync Source Api Association.'''
+
+    __jsii_type__: typing.ClassVar[str] = "aws-cdk-lib.aws_appsync.ISourceApiAssociation"
+
+    @builtins.property
+    @jsii.member(jsii_name="associationArn")
+    def association_arn(self) -> builtins.str:
+        '''The association arn.'''
+        return typing.cast(builtins.str, jsii.get(self, "associationArn"))
+
+    @builtins.property
+    @jsii.member(jsii_name="associationId")
+    def association_id(self) -> builtins.str:
+        '''The association id.'''
+        return typing.cast(builtins.str, jsii.get(self, "associationId"))
+
+    @builtins.property
+    @jsii.member(jsii_name="mergedApi")
+    def merged_api(self) -> IGraphqlApi:
+        '''The merged api in the association.'''
+        return typing.cast(IGraphqlApi, jsii.get(self, "mergedApi"))
+
+    @builtins.property
+    @jsii.member(jsii_name="sourceApi")
+    def source_api(self) -> IGraphqlApi:
+        '''The source api in the association.'''
+        return typing.cast(IGraphqlApi, jsii.get(self, "sourceApi"))
+
+# Adding a "__jsii_proxy_class__(): typing.Type" function to the interface
+typing.cast(typing.Any, ISourceApiAssociation).__jsii_proxy_class__ = lambda : _ISourceApiAssociationProxy
+
+
 class IamResource(
     metaclass=jsii.JSIIMeta,
     jsii_type="aws-cdk-lib.aws_appsync.IamResource",
@@ -12003,15 +12092,12 @@ class MergeType(enum.Enum):
         )
         
         # Merged API
-        appsync.GraphqlApi(self, "MergedAPI",
+        merged_api = appsync.GraphqlApi(self, "MergedAPI",
             name="MergedAPI",
             definition=appsync.Definition.from_source_apis(
                 source_apis=[appsync.SourceApi(
                     source_api=first_api,
                     merge_type=appsync.MergeType.MANUAL_MERGE
-                ), appsync.SourceApi(
-                    source_api=second_api,
-                    merge_type=appsync.MergeType.AUTO_MERGE
                 )
                 ]
             )
@@ -13045,18 +13131,24 @@ class SortKeyStep(
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_appsync.SourceApi",
     jsii_struct_bases=[],
-    name_mapping={"source_api": "sourceApi", "merge_type": "mergeType"},
+    name_mapping={
+        "source_api": "sourceApi",
+        "description": "description",
+        "merge_type": "mergeType",
+    },
 )
 class SourceApi:
     def __init__(
         self,
         *,
-        source_api: "GraphqlApi",
+        source_api: IGraphqlApi,
+        description: typing.Optional[builtins.str] = None,
         merge_type: typing.Optional[MergeType] = None,
     ) -> None:
         '''Configuration of source API.
 
         :param source_api: Source API that is associated with the merged API.
+        :param description: Description of the Source API asssociation.
         :param merge_type: Merging option used to associate the source API to the Merged API. Default: - Auto merge. The merge is triggered automatically when the source API has changed
 
         :exampleMetadata: fixture=_generated
@@ -13073,25 +13165,35 @@ class SourceApi:
                 source_api=graphql_api,
             
                 # the properties below are optional
+                description="description",
                 merge_type=appsync.MergeType.MANUAL_MERGE
             )
         '''
         if __debug__:
             type_hints = typing.get_type_hints(_typecheckingstub__7bef1ce1bd423a1d4c0b7f6f65a108a4af8b5372e92c20ee3f9f4648fb4f24f1)
             check_type(argname="argument source_api", value=source_api, expected_type=type_hints["source_api"])
+            check_type(argname="argument description", value=description, expected_type=type_hints["description"])
             check_type(argname="argument merge_type", value=merge_type, expected_type=type_hints["merge_type"])
         self._values: typing.Dict[builtins.str, typing.Any] = {
             "source_api": source_api,
         }
+        if description is not None:
+            self._values["description"] = description
         if merge_type is not None:
             self._values["merge_type"] = merge_type
 
     @builtins.property
-    def source_api(self) -> "GraphqlApi":
+    def source_api(self) -> IGraphqlApi:
         '''Source API that is associated with the merged API.'''
         result = self._values.get("source_api")
         assert result is not None, "Required property 'source_api' is missing"
-        return typing.cast("GraphqlApi", result)
+        return typing.cast(IGraphqlApi, result)
+
+    @builtins.property
+    def description(self) -> typing.Optional[builtins.str]:
+        '''Description of the Source API asssociation.'''
+        result = self._values.get("description")
+        return typing.cast(typing.Optional[builtins.str], result)
 
     @builtins.property
     def merge_type(self) -> typing.Optional[MergeType]:
@@ -13114,6 +13216,343 @@ class SourceApi:
         )
 
 
+@jsii.implements(ISourceApiAssociation)
+class SourceApiAssociation(
+    _Resource_45bc6135,
+    metaclass=jsii.JSIIMeta,
+    jsii_type="aws-cdk-lib.aws_appsync.SourceApiAssociation",
+):
+    '''AppSync SourceApiAssociation which associates an AppSync source API to an AppSync Merged API.
+
+    The initial creation of the SourceApiAssociation merges the source API into the Merged API schema.
+
+    :exampleMetadata: infused
+
+    Example::
+
+        source_api = appsync.GraphqlApi(self, "FirstSourceAPI",
+            name="FirstSourceAPI",
+            definition=appsync.Definition.from_file(path.join(__dirname, "appsync.merged-api-1.graphql"))
+        )
+        
+        imported_merged_api = appsync.GraphqlApi.from_graphql_api_attributes(self, "ImportedMergedApi",
+            graphql_api_id="MyApiId",
+            graphql_api_arn="MyApiArn"
+        )
+        
+        imported_execution_role = iam.Role.from_role_arn(self, "ExecutionRole", "arn:aws:iam::ACCOUNT:role/MyExistingRole")
+        appsync.SourceApiAssociation(self, "SourceApiAssociation2",
+            source_api=source_api,
+            merged_api=imported_merged_api,
+            merge_type=appsync.MergeType.MANUAL_MERGE,
+            merged_api_execution_role=imported_execution_role
+        )
+    '''
+
+    def __init__(
+        self,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        merged_api: IGraphqlApi,
+        merged_api_execution_role: _IRole_235f5d8e,
+        source_api: IGraphqlApi,
+        description: typing.Optional[builtins.str] = None,
+        merge_type: typing.Optional[MergeType] = None,
+    ) -> None:
+        '''
+        :param scope: -
+        :param id: -
+        :param merged_api: The merged api to associate.
+        :param merged_api_execution_role: The merged api execution role for adding the access policy for the source api.
+        :param source_api: The source api to associate.
+        :param description: The description of the source api association. Default: - None
+        :param merge_type: The merge type for the source. Default: - AUTO_MERGE
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__eb8c3f70027957b4b96a01531a87b7bf27655f1ee553c04a4278093ceefb6f72)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        props = SourceApiAssociationProps(
+            merged_api=merged_api,
+            merged_api_execution_role=merged_api_execution_role,
+            source_api=source_api,
+            description=description,
+            merge_type=merge_type,
+        )
+
+        jsii.create(self.__class__, self, [scope, id, props])
+
+    @jsii.member(jsii_name="fromSourceApiAssociationAttributes")
+    @builtins.classmethod
+    def from_source_api_association_attributes(
+        cls,
+        scope: _constructs_77d1e7e8.Construct,
+        id: builtins.str,
+        *,
+        association_arn: builtins.str,
+        merged_api: IGraphqlApi,
+        source_api: IGraphqlApi,
+    ) -> ISourceApiAssociation:
+        '''Import Appsync Source Api Association from source API, merged api, and merge type.
+
+        :param scope: -
+        :param id: -
+        :param association_arn: The association arn.
+        :param merged_api: The merged api in the association.
+        :param source_api: The source api in the association.
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__97507ab2610d2a6fffaf16c3f218200d2564b3e5f13f6d40b0ed78d53615af87)
+            check_type(argname="argument scope", value=scope, expected_type=type_hints["scope"])
+            check_type(argname="argument id", value=id, expected_type=type_hints["id"])
+        attrs = SourceApiAssociationAttributes(
+            association_arn=association_arn,
+            merged_api=merged_api,
+            source_api=source_api,
+        )
+
+        return typing.cast(ISourceApiAssociation, jsii.sinvoke(cls, "fromSourceApiAssociationAttributes", [scope, id, attrs]))
+
+    @builtins.property
+    @jsii.member(jsii_name="association")
+    def association(self) -> CfnSourceApiAssociation:
+        '''The underlying CFN source api association resource.'''
+        return typing.cast(CfnSourceApiAssociation, jsii.get(self, "association"))
+
+    @builtins.property
+    @jsii.member(jsii_name="associationArn")
+    def association_arn(self) -> builtins.str:
+        '''The association arn.'''
+        return typing.cast(builtins.str, jsii.get(self, "associationArn"))
+
+    @builtins.property
+    @jsii.member(jsii_name="associationId")
+    def association_id(self) -> builtins.str:
+        '''The association id.'''
+        return typing.cast(builtins.str, jsii.get(self, "associationId"))
+
+    @builtins.property
+    @jsii.member(jsii_name="mergedApi")
+    def merged_api(self) -> IGraphqlApi:
+        '''The merged api in the association.'''
+        return typing.cast(IGraphqlApi, jsii.get(self, "mergedApi"))
+
+    @builtins.property
+    @jsii.member(jsii_name="mergeType")
+    def merge_type(self) -> MergeType:
+        '''The merge type for the source api association.'''
+        return typing.cast(MergeType, jsii.get(self, "mergeType"))
+
+    @builtins.property
+    @jsii.member(jsii_name="sourceApi")
+    def source_api(self) -> IGraphqlApi:
+        '''The source api in the association.'''
+        return typing.cast(IGraphqlApi, jsii.get(self, "sourceApi"))
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_appsync.SourceApiAssociationAttributes",
+    jsii_struct_bases=[],
+    name_mapping={
+        "association_arn": "associationArn",
+        "merged_api": "mergedApi",
+        "source_api": "sourceApi",
+    },
+)
+class SourceApiAssociationAttributes:
+    def __init__(
+        self,
+        *,
+        association_arn: builtins.str,
+        merged_api: IGraphqlApi,
+        source_api: IGraphqlApi,
+    ) -> None:
+        '''The attributes for imported AppSync Source Api Association.
+
+        :param association_arn: The association arn.
+        :param merged_api: The merged api in the association.
+        :param source_api: The source api in the association.
+
+        :exampleMetadata: fixture=_generated
+
+        Example::
+
+            # The code below shows an example of how to instantiate this type.
+            # The values are placeholders you should change.
+            from aws_cdk import aws_appsync as appsync
+            
+            # graphql_api: appsync.GraphqlApi
+            
+            source_api_association_attributes = appsync.SourceApiAssociationAttributes(
+                association_arn="associationArn",
+                merged_api=graphql_api,
+                source_api=graphql_api
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__c9c0d0a1defd3bbf92ca52dcdeaed177c69409cf14746681e1abf485713c7e29)
+            check_type(argname="argument association_arn", value=association_arn, expected_type=type_hints["association_arn"])
+            check_type(argname="argument merged_api", value=merged_api, expected_type=type_hints["merged_api"])
+            check_type(argname="argument source_api", value=source_api, expected_type=type_hints["source_api"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "association_arn": association_arn,
+            "merged_api": merged_api,
+            "source_api": source_api,
+        }
+
+    @builtins.property
+    def association_arn(self) -> builtins.str:
+        '''The association arn.'''
+        result = self._values.get("association_arn")
+        assert result is not None, "Required property 'association_arn' is missing"
+        return typing.cast(builtins.str, result)
+
+    @builtins.property
+    def merged_api(self) -> IGraphqlApi:
+        '''The merged api in the association.'''
+        result = self._values.get("merged_api")
+        assert result is not None, "Required property 'merged_api' is missing"
+        return typing.cast(IGraphqlApi, result)
+
+    @builtins.property
+    def source_api(self) -> IGraphqlApi:
+        '''The source api in the association.'''
+        result = self._values.get("source_api")
+        assert result is not None, "Required property 'source_api' is missing"
+        return typing.cast(IGraphqlApi, result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "SourceApiAssociationAttributes(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
+@jsii.data_type(
+    jsii_type="aws-cdk-lib.aws_appsync.SourceApiAssociationProps",
+    jsii_struct_bases=[],
+    name_mapping={
+        "merged_api": "mergedApi",
+        "merged_api_execution_role": "mergedApiExecutionRole",
+        "source_api": "sourceApi",
+        "description": "description",
+        "merge_type": "mergeType",
+    },
+)
+class SourceApiAssociationProps:
+    def __init__(
+        self,
+        *,
+        merged_api: IGraphqlApi,
+        merged_api_execution_role: _IRole_235f5d8e,
+        source_api: IGraphqlApi,
+        description: typing.Optional[builtins.str] = None,
+        merge_type: typing.Optional[MergeType] = None,
+    ) -> None:
+        '''Properties for SourceApiAssociation which associates an AppSync Source API with an AppSync Merged API.
+
+        :param merged_api: The merged api to associate.
+        :param merged_api_execution_role: The merged api execution role for adding the access policy for the source api.
+        :param source_api: The source api to associate.
+        :param description: The description of the source api association. Default: - None
+        :param merge_type: The merge type for the source. Default: - AUTO_MERGE
+
+        :exampleMetadata: infused
+
+        Example::
+
+            source_api = appsync.GraphqlApi(self, "FirstSourceAPI",
+                name="FirstSourceAPI",
+                definition=appsync.Definition.from_file(path.join(__dirname, "appsync.merged-api-1.graphql"))
+            )
+            
+            imported_merged_api = appsync.GraphqlApi.from_graphql_api_attributes(self, "ImportedMergedApi",
+                graphql_api_id="MyApiId",
+                graphql_api_arn="MyApiArn"
+            )
+            
+            imported_execution_role = iam.Role.from_role_arn(self, "ExecutionRole", "arn:aws:iam::ACCOUNT:role/MyExistingRole")
+            appsync.SourceApiAssociation(self, "SourceApiAssociation2",
+                source_api=source_api,
+                merged_api=imported_merged_api,
+                merge_type=appsync.MergeType.MANUAL_MERGE,
+                merged_api_execution_role=imported_execution_role
+            )
+        '''
+        if __debug__:
+            type_hints = typing.get_type_hints(_typecheckingstub__e215501a2f432c85820a368719d981a2f3c089240865ac59cc9b60be45218d44)
+            check_type(argname="argument merged_api", value=merged_api, expected_type=type_hints["merged_api"])
+            check_type(argname="argument merged_api_execution_role", value=merged_api_execution_role, expected_type=type_hints["merged_api_execution_role"])
+            check_type(argname="argument source_api", value=source_api, expected_type=type_hints["source_api"])
+            check_type(argname="argument description", value=description, expected_type=type_hints["description"])
+            check_type(argname="argument merge_type", value=merge_type, expected_type=type_hints["merge_type"])
+        self._values: typing.Dict[builtins.str, typing.Any] = {
+            "merged_api": merged_api,
+            "merged_api_execution_role": merged_api_execution_role,
+            "source_api": source_api,
+        }
+        if description is not None:
+            self._values["description"] = description
+        if merge_type is not None:
+            self._values["merge_type"] = merge_type
+
+    @builtins.property
+    def merged_api(self) -> IGraphqlApi:
+        '''The merged api to associate.'''
+        result = self._values.get("merged_api")
+        assert result is not None, "Required property 'merged_api' is missing"
+        return typing.cast(IGraphqlApi, result)
+
+    @builtins.property
+    def merged_api_execution_role(self) -> _IRole_235f5d8e:
+        '''The merged api execution role for adding the access policy for the source api.'''
+        result = self._values.get("merged_api_execution_role")
+        assert result is not None, "Required property 'merged_api_execution_role' is missing"
+        return typing.cast(_IRole_235f5d8e, result)
+
+    @builtins.property
+    def source_api(self) -> IGraphqlApi:
+        '''The source api to associate.'''
+        result = self._values.get("source_api")
+        assert result is not None, "Required property 'source_api' is missing"
+        return typing.cast(IGraphqlApi, result)
+
+    @builtins.property
+    def description(self) -> typing.Optional[builtins.str]:
+        '''The description of the source api association.
+
+        :default: - None
+        '''
+        result = self._values.get("description")
+        return typing.cast(typing.Optional[builtins.str], result)
+
+    @builtins.property
+    def merge_type(self) -> typing.Optional[MergeType]:
+        '''The merge type for the source.
+
+        :default: - AUTO_MERGE
+        '''
+        result = self._values.get("merge_type")
+        return typing.cast(typing.Optional[MergeType], result)
+
+    def __eq__(self, rhs: typing.Any) -> builtins.bool:
+        return isinstance(rhs, self.__class__) and rhs._values == self._values
+
+    def __ne__(self, rhs: typing.Any) -> builtins.bool:
+        return not (rhs == self)
+
+    def __repr__(self) -> str:
+        return "SourceApiAssociationProps(%s)" % ", ".join(
+            k + "=" + repr(v) for k, v in self._values.items()
+        )
+
+
 @jsii.data_type(
     jsii_type="aws-cdk-lib.aws_appsync.SourceApiOptions",
     jsii_struct_bases=[],
@@ -13129,7 +13568,7 @@ class SourceApiOptions:
         source_apis: typing.Sequence[typing.Union[SourceApi, typing.Dict[builtins.str, typing.Any]]],
         merged_api_execution_role: typing.Optional[_Role_e8c6e11f] = None,
     ) -> None:
-        '''Source API configuration for creating a AppSync Merged API.
+        '''Additional API configuration for creating a AppSync Merged API.
 
         :param source_apis: Definition of source APIs associated with this Merged API.
         :param merged_api_execution_role: IAM Role used to validate access to source APIs at runtime and to update the merged API endpoint with the source API changes. Default: - An IAM Role with acccess to source schemas will be created
@@ -13160,15 +13599,12 @@ class SourceApiOptions:
             )
             
             # Merged API
-            appsync.GraphqlApi(self, "MergedAPI",
+            merged_api = appsync.GraphqlApi(self, "MergedAPI",
                 name="MergedAPI",
                 definition=appsync.Definition.from_source_apis(
                     source_apis=[appsync.SourceApi(
                         source_api=first_api,
                         merge_type=appsync.MergeType.MANUAL_MERGE
-                    ), appsync.SourceApi(
-                        source_api=second_api,
-                        merge_type=appsync.MergeType.AUTO_MERGE
                     )
                     ]
                 )
@@ -15790,23 +16226,22 @@ class GraphqlApi(
 
     Example::
 
-        import aws_cdk.aws_events as events
-        
-        
-        api = appsync.GraphqlApi(self, "EventBridgeApi",
-            name="EventBridgeApi",
-            definition=appsync.Definition.from_file(path.join(__dirname, "appsync.eventbridge.graphql"))
+        source_api = appsync.GraphqlApi(self, "FirstSourceAPI",
+            name="FirstSourceAPI",
+            definition=appsync.Definition.from_file(path.join(__dirname, "appsync.merged-api-1.graphql"))
         )
         
-        bus = events.EventBus(self, "DestinationEventBus")
-        
-        data_source = api.add_event_bridge_data_source("NoneDS", bus)
+        imported_merged_api = appsync.GraphqlApi.from_graphql_api_attributes(self, "ImportedMergedApi",
+            graphql_api_id="MyApiId",
+            graphql_api_arn="MyApiArn"
+        )
         
-        data_source.create_resolver("EventResolver",
-            type_name="Mutation",
-            field_name="emitEvent",
-            request_mapping_template=appsync.MappingTemplate.from_file("request.vtl"),
-            response_mapping_template=appsync.MappingTemplate.from_file("response.vtl")
+        imported_execution_role = iam.Role.from_role_arn(self, "ExecutionRole", "arn:aws:iam::ACCOUNT:role/MyExistingRole")
+        appsync.SourceApiAssociation(self, "SourceApiAssociation2",
+            source_api=source_api,
+            merged_api=imported_merged_api,
+            merge_type=appsync.MergeType.MANUAL_MERGE,
+            merged_api_execution_role=imported_execution_role
         )
     '''
 
@@ -16090,6 +16525,7 @@ __all__ = [
     "IGraphqlApi",
     "ISchema",
     "ISchemaConfig",
+    "ISourceApiAssociation",
     "IamResource",
     "InlineCode",
     "KeyCondition",
@@ -16117,6 +16553,9 @@ __all__ = [
     "SchemaProps",
     "SortKeyStep",
     "SourceApi",
+    "SourceApiAssociation",
+    "SourceApiAssociationAttributes",
+    "SourceApiAssociationProps",
     "SourceApiOptions",
     "UserPoolConfig",
     "UserPoolDefaultAction",
@@ -17972,7 +18411,52 @@ def _typecheckingstub__684d8cf05e18cc8e70df256c4f02edd1174c86389940b94860ac8d3c8
 
 def _typecheckingstub__7bef1ce1bd423a1d4c0b7f6f65a108a4af8b5372e92c20ee3f9f4648fb4f24f1(
     *,
-    source_api: GraphqlApi,
+    source_api: IGraphqlApi,
+    description: typing.Optional[builtins.str] = None,
+    merge_type: typing.Optional[MergeType] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__eb8c3f70027957b4b96a01531a87b7bf27655f1ee553c04a4278093ceefb6f72(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    merged_api: IGraphqlApi,
+    merged_api_execution_role: _IRole_235f5d8e,
+    source_api: IGraphqlApi,
+    description: typing.Optional[builtins.str] = None,
+    merge_type: typing.Optional[MergeType] = None,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__97507ab2610d2a6fffaf16c3f218200d2564b3e5f13f6d40b0ed78d53615af87(
+    scope: _constructs_77d1e7e8.Construct,
+    id: builtins.str,
+    *,
+    association_arn: builtins.str,
+    merged_api: IGraphqlApi,
+    source_api: IGraphqlApi,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__c9c0d0a1defd3bbf92ca52dcdeaed177c69409cf14746681e1abf485713c7e29(
+    *,
+    association_arn: builtins.str,
+    merged_api: IGraphqlApi,
+    source_api: IGraphqlApi,
+) -> None:
+    """Type checking stubs"""
+    pass
+
+def _typecheckingstub__e215501a2f432c85820a368719d981a2f3c089240865ac59cc9b60be45218d44(
+    *,
+    merged_api: IGraphqlApi,
+    merged_api_execution_role: _IRole_235f5d8e,
+    source_api: IGraphqlApi,
+    description: typing.Optional[builtins.str] = None,
     merge_type: typing.Optional[MergeType] = None,
 ) -> None:
     """Type checking stubs"""