:doc:`SecurityHub <../../securityhub>` / Client / get_insight_results

*******************
get_insight_results
*******************



.. py:method:: SecurityHub.Client.get_insight_results(**kwargs)

  

  Lists the results of the Security Hub insight specified by the insight ARN.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/securityhub-2018-10-26/GetInsightResults>`_  


  **Request Syntax**
  ::

    response = client.get_insight_results(
        InsightArn='string'
    )
    
  :type InsightArn: string
  :param InsightArn: **[REQUIRED]** 

    The ARN of the insight for which to return results.

    

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

    
    ::

      {
          'InsightResults': {
              'InsightArn': 'string',
              'GroupByAttribute': 'string',
              'ResultValues': [
                  {
                      'GroupByAttributeValue': 'string',
                      'Count': 123
                  },
              ]
          }
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **InsightResults** *(dict) --* 

        The insight results returned by the operation.

        
        

        - **InsightArn** *(string) --* 

          The ARN of the insight whose results are returned by the ``GetInsightResults`` operation.

          
        

        - **GroupByAttribute** *(string) --* 

          The attribute that the findings are grouped by for the insight whose results are returned by the ``GetInsightResults`` operation.

          
        

        - **ResultValues** *(list) --* 

          The list of insight result values returned by the ``GetInsightResults`` operation.

          
          

          - *(dict) --* 

            The insight result values returned by the ``GetInsightResults`` operation.

            
            

            - **GroupByAttributeValue** *(string) --* 

              The value of the attribute that the findings are grouped by for the insight whose results are returned by the ``GetInsightResults`` operation.

              
            

            - **Count** *(integer) --* 

              The number of findings returned for each ``GroupByAttributeValue``.

              
        
      
    
  
  **Exceptions**
  
  *   :py:class:`SecurityHub.Client.exceptions.InternalException`

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

  
  *   :py:class:`SecurityHub.Client.exceptions.InvalidAccessException`

  
  *   :py:class:`SecurityHub.Client.exceptions.LimitExceededException`

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

  