:doc:`MigrationHub <../../mgh>` / Client / import_migration_task

*********************
import_migration_task
*********************



.. py:method:: MigrationHub.Client.import_migration_task(**kwargs)

  

  Registers a new migration task which represents a server, database, etc., being migrated to AWS by a migration tool.

   

  This API is a prerequisite to calling the ``NotifyMigrationTaskState`` API as the migration tool must first register the migration task with Migration Hub.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/AWSMigrationHub-2017-05-31/ImportMigrationTask>`_  


  **Request Syntax**
  ::

    response = client.import_migration_task(
        ProgressUpdateStream='string',
        MigrationTaskName='string',
        DryRun=True|False
    )
    
  :type ProgressUpdateStream: string
  :param ProgressUpdateStream: **[REQUIRED]** 

    The name of the ProgressUpdateStream. >

    

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

    Unique identifier that references the migration task. *Do not store personal data in this field.*

    

  
  :type DryRun: boolean
  :param DryRun: 

    Optional boolean flag to indicate whether any effect should take place. Used to test if the caller has permission to make the call.

    

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

    
    ::

      {}
      
    **Response Structure**

    

    - *(dict) --* 
  
  **Exceptions**
  
  *   :py:class:`MigrationHub.Client.exceptions.AccessDeniedException`

  
  *   :py:class:`MigrationHub.Client.exceptions.ThrottlingException`

  
  *   :py:class:`MigrationHub.Client.exceptions.InternalServerError`

  
  *   :py:class:`MigrationHub.Client.exceptions.ServiceUnavailableException`

  
  *   :py:class:`MigrationHub.Client.exceptions.DryRunOperation`

  
  *   :py:class:`MigrationHub.Client.exceptions.UnauthorizedOperation`

  
  *   :py:class:`MigrationHub.Client.exceptions.InvalidInputException`

  
  *   :py:class:`MigrationHub.Client.exceptions.ResourceNotFoundException`

  
  *   :py:class:`MigrationHub.Client.exceptions.HomeRegionNotSetException`

  