:doc:`MigrationHubStrategyRecommendations <../../migrationhubstrategy>` / Client / start_recommendation_report_generation

**************************************
start_recommendation_report_generation
**************************************



.. py:method:: MigrationHubStrategyRecommendations.Client.start_recommendation_report_generation(**kwargs)

  

  Starts generating a recommendation report.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/migrationhubstrategy-2020-02-19/StartRecommendationReportGeneration>`_  


  **Request Syntax**
  ::

    response = client.start_recommendation_report_generation(
        groupIdFilter=[
            {
                'name': 'ExternalId'|'ExternalSourceType',
                'value': 'string'
            },
        ],
        outputFormat='Excel'|'Json'
    )
    
  :type groupIdFilter: list
  :param groupIdFilter: 

    Groups the resources in the recommendation report with a unique name.

    

  
    - *(dict) --* 

      The object containing information about distinct imports or groups for Strategy Recommendations.

      

    
      - **name** *(string) --* 

        The key of the specific import group.

        

      
      - **value** *(string) --* 

        The value of the specific import group.

        

      
    

  :type outputFormat: string
  :param outputFormat: 

    The output format for the recommendation report file. The default format is Microsoft Excel.

    

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

    
    ::

      {
          'id': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **id** *(string) --* 

        The ID of the recommendation report generation task.

        
  
  **Exceptions**
  
  *   :py:class:`MigrationHubStrategyRecommendations.Client.exceptions.AccessDeniedException`

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

  
  *   :py:class:`MigrationHubStrategyRecommendations.Client.exceptions.ValidationException`

  
  *   :py:class:`MigrationHubStrategyRecommendations.Client.exceptions.ConflictException`

  
  *   :py:class:`MigrationHubStrategyRecommendations.Client.exceptions.InternalServerException`

  