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

*****************************
associate_discovered_resource
*****************************



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

  

  Associates a discovered resource ID from Application Discovery Service with a migration task.

  

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


  **Request Syntax**
  ::

    response = client.associate_discovered_resource(
        ProgressUpdateStream='string',
        MigrationTaskName='string',
        DiscoveredResource={
            'ConfigurationId': 'string',
            'Description': 'string'
        },
        DryRun=True|False
    )
    
  :type ProgressUpdateStream: string
  :param ProgressUpdateStream: **[REQUIRED]** 

    The name of the ProgressUpdateStream.

    

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

    The identifier given to the MigrationTask. *Do not store personal data in this field.*

    

  
  :type DiscoveredResource: dict
  :param DiscoveredResource: **[REQUIRED]** 

    Object representing a Resource.

    

  
    - **ConfigurationId** *(string) --* **[REQUIRED]** 

      The configurationId in Application Discovery Service that uniquely identifies the on-premise resource.

      

    
    - **Description** *(string) --* 

      A description that can be free-form text to record additional detail about the discovered resource for clarity or later reference.

      

    
  
  :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.PolicyErrorException`

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

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

  