:doc:`ConfigService <../../config>` / Client / list_resource_evaluations

*************************
list_resource_evaluations
*************************



.. py:method:: ConfigService.Client.list_resource_evaluations(**kwargs)

  

  Returns a list of proactive resource evaluations.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/config-2014-11-12/ListResourceEvaluations>`_  


  **Request Syntax**
  ::

    response = client.list_resource_evaluations(
        Filters={
            'EvaluationMode': 'DETECTIVE'|'PROACTIVE',
            'TimeWindow': {
                'StartTime': datetime(2015, 1, 1),
                'EndTime': datetime(2015, 1, 1)
            },
            'EvaluationContextIdentifier': 'string'
        },
        Limit=123,
        NextToken='string'
    )
    
  :type Filters: dict
  :param Filters: 

    Returns a ``ResourceEvaluationFilters`` object.

    

  
    - **EvaluationMode** *(string) --* 

      Filters all resource evaluations results based on an evaluation mode.

       

      .. warning::

         

        Currently, ``DECTECTIVE`` is not supported as a valid value. Ignore other documentation stating otherwise.

        

      

    
    - **TimeWindow** *(dict) --* 

      Returns a ``TimeWindow`` object.

      

    
      - **StartTime** *(datetime) --* 

        The start time of an execution.

        

      
      - **EndTime** *(datetime) --* 

        The end time of an execution. The end time must be after the start date.

        

      
    
    - **EvaluationContextIdentifier** *(string) --* 

      Filters evaluations for a given infrastructure deployment. For example: CFN Stack.

      

    
  
  :type Limit: integer
  :param Limit: 

    The maximum number of evaluations returned on each page. The default is 10. You cannot specify a number greater than 100. If you specify 0, Config uses the default.

    

  
  :type NextToken: string
  :param NextToken: 

    The ``nextToken`` string returned on a previous page that you use to get the next page of results in a paginated response.

    

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

    
    ::

      {
          'ResourceEvaluations': [
              {
                  'ResourceEvaluationId': 'string',
                  'EvaluationMode': 'DETECTIVE'|'PROACTIVE',
                  'EvaluationStartTimestamp': datetime(2015, 1, 1)
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **ResourceEvaluations** *(list) --* 

        Returns a ``ResourceEvaluations`` object.

        
        

        - *(dict) --* 

          Returns details of a resource evaluation.

          
          

          - **ResourceEvaluationId** *(string) --* 

            The ResourceEvaluationId of a evaluation.

            
          

          - **EvaluationMode** *(string) --* 

            The mode of an evaluation. The valid values are Detective or Proactive.

            
          

          - **EvaluationStartTimestamp** *(datetime) --* 

            The starting time of an execution.

            
      
    
      

      - **NextToken** *(string) --* 

        The ``nextToken`` string returned on a previous page that you use to get the next page of results in a paginated response.

        
  
  **Exceptions**
  
  *   :py:class:`ConfigService.Client.exceptions.InvalidNextTokenException`

  
  *   :py:class:`ConfigService.Client.exceptions.InvalidParameterValueException`

  
  *   :py:class:`ConfigService.Client.exceptions.InvalidTimeRangeException`

  