:doc:`AppSync <../../appsync>` / Client / start_schema_merge

******************
start_schema_merge
******************



.. py:method:: AppSync.Client.start_schema_merge(**kwargs)

  

  Initiates a merge operation. Returns a status that shows the result of the merge operation.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/appsync-2017-07-25/StartSchemaMerge>`_  


  **Request Syntax**
  ::

    response = client.start_schema_merge(
        associationId='string',
        mergedApiIdentifier='string'
    )
    
  :type associationId: string
  :param associationId: **[REQUIRED]** 

    The ID generated by the AppSync service for the source API association.

    

  
  :type mergedApiIdentifier: string
  :param mergedApiIdentifier: **[REQUIRED]** 

    The identifier of the AppSync Merged API. This is generated by the AppSync service. In most cases, Merged APIs (especially in your account) only require the API ID value or ARN of the merged API. However, Merged APIs in other accounts (cross-account use cases) strictly require the full resource ARN of the merged API.

    

  
  
  :rtype: dict
  :returns: 
    
    **Response Syntax**

    
    ::

      {
          'sourceApiAssociationStatus': 'MERGE_SCHEDULED'|'MERGE_FAILED'|'MERGE_SUCCESS'|'MERGE_IN_PROGRESS'|'AUTO_MERGE_SCHEDULE_FAILED'|'DELETION_SCHEDULED'|'DELETION_IN_PROGRESS'|'DELETION_FAILED'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **sourceApiAssociationStatus** *(string) --* 

        The state of the source API association.

        
  
  **Exceptions**
  
  *   :py:class:`AppSync.Client.exceptions.UnauthorizedException`

  
  *   :py:class:`AppSync.Client.exceptions.BadRequestException`

  
  *   :py:class:`AppSync.Client.exceptions.InternalFailureException`

  
  *   :py:class:`AppSync.Client.exceptions.NotFoundException`

  
  *   :py:class:`AppSync.Client.exceptions.ConcurrentModificationException`

  