:doc:`NetworkFlowMonitor <../../networkflowmonitor>` / Client / get_query_status_monitor_top_contributors

*****************************************
get_query_status_monitor_top_contributors
*****************************************



.. py:method:: NetworkFlowMonitor.Client.get_query_status_monitor_top_contributors(**kwargs)

  

  Returns the current status of a query for the Network Flow Monitor query interface, for a specified query ID and monitor. This call returns the query status for the top contributors for a monitor.

   

  When you create a query, use this call to check the status of the query to make sure that it has has ``SUCCEEDED`` before you review the results. Use the same query ID that you used for the corresponding API call to start (create) the query, ``StartQueryMonitorTopContributors``.

   

  When you run a query, use this call to check the status of the query to make sure that the query has ``SUCCEEDED`` before you review the results.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/networkflowmonitor-2023-04-19/GetQueryStatusMonitorTopContributors>`_  


  **Request Syntax**
  ::

    response = client.get_query_status_monitor_top_contributors(
        monitorName='string',
        queryId='string'
    )
    
  :type monitorName: string
  :param monitorName: **[REQUIRED]** 

    The name of the monitor.

    

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

    The identifier for the query. A query ID is an internally-generated identifier for a specific query returned from an API call to start a query.

    

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

    
    ::

      {
          'status': 'QUEUED'|'RUNNING'|'SUCCEEDED'|'FAILED'|'CANCELED'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **status** *(string) --* 

        When you run a query, use this call to check the status of the query to make sure that the query has ``SUCCEEDED`` before you review the results.

         

        
        * ``QUEUED``: The query is scheduled to run.
         
        * ``RUNNING``: The query is in progress but not complete.
         
        * ``SUCCEEDED``: The query completed sucessfully.
         
        * ``FAILED``: The query failed due to an error.
         
        * ``CANCELED``: The query was canceled.
        

        
  
  **Exceptions**
  
  *   :py:class:`NetworkFlowMonitor.Client.exceptions.ServiceQuotaExceededException`

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

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

  
  *   :py:class:`NetworkFlowMonitor.Client.exceptions.AccessDeniedException`

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

  