:doc:`ApplicationInsights <../../application-insights>` / Client / list_configuration_history

**************************
list_configuration_history
**************************



.. py:method:: ApplicationInsights.Client.list_configuration_history(**kwargs)

  

  Lists the INFO, WARN, and ERROR events for periodic configuration updates performed by Application Insights. Examples of events represented are:

   

  
  * INFO: creating a new alarm or updating an alarm threshold.
   
  * WARN: alarm not created due to insufficient data points used to predict thresholds.
   
  * ERROR: alarm not created due to permission errors or exceeding quotas.
  

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/application-insights-2018-11-25/ListConfigurationHistory>`_  


  **Request Syntax**
  ::

    response = client.list_configuration_history(
        ResourceGroupName='string',
        StartTime=datetime(2015, 1, 1),
        EndTime=datetime(2015, 1, 1),
        EventStatus='INFO'|'WARN'|'ERROR',
        MaxResults=123,
        NextToken='string',
        AccountId='string'
    )
    
  :type ResourceGroupName: string
  :param ResourceGroupName: 

    Resource group to which the application belongs.

    

  
  :type StartTime: datetime
  :param StartTime: 

    The start time of the event.

    

  
  :type EndTime: datetime
  :param EndTime: 

    The end time of the event.

    

  
  :type EventStatus: string
  :param EventStatus: 

    The status of the configuration update event. Possible values include INFO, WARN, and ERROR.

    

  
  :type MaxResults: integer
  :param MaxResults: 

    The maximum number of results returned by ``ListConfigurationHistory`` in paginated output. When this parameter is used, ``ListConfigurationHistory`` returns only ``MaxResults`` in a single page along with a ``NextToken`` response element. The remaining results of the initial request can be seen by sending another ``ListConfigurationHistory`` request with the returned ``NextToken`` value. If this parameter is not used, then ``ListConfigurationHistory`` returns all results.

    

  
  :type NextToken: string
  :param NextToken: 

    The ``NextToken`` value returned from a previous paginated ``ListConfigurationHistory`` request where ``MaxResults`` was used and the results exceeded the value of that parameter. Pagination continues from the end of the previous results that returned the ``NextToken`` value. This value is ``null`` when there are no more results to return.

    

  
  :type AccountId: string
  :param AccountId: 

    The Amazon Web Services account ID for the resource group owner.

    

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

    
    ::

      {
          'EventList': [
              {
                  'ResourceGroupName': 'string',
                  'AccountId': 'string',
                  'MonitoredResourceARN': 'string',
                  'EventStatus': 'INFO'|'WARN'|'ERROR',
                  'EventResourceType': 'CLOUDWATCH_ALARM'|'CLOUDWATCH_LOG'|'CLOUDFORMATION'|'SSM_ASSOCIATION',
                  'EventTime': datetime(2015, 1, 1),
                  'EventDetail': 'string',
                  'EventResourceName': 'string'
              },
          ],
          'NextToken': 'string'
      }
      
    **Response Structure**

    

    - *(dict) --* 
      

      - **EventList** *(list) --* 

        The list of configuration events and their corresponding details.

        
        

        - *(dict) --* 

          The event information.

          
          

          - **ResourceGroupName** *(string) --* 

            The name of the resource group of the application to which the configuration event belongs.

            
          

          - **AccountId** *(string) --* 

            The Amazon Web Services account ID for the owner of the application to which the configuration event belongs.

            
          

          - **MonitoredResourceARN** *(string) --* 

            The resource monitored by Application Insights.

            
          

          - **EventStatus** *(string) --* 

            The status of the configuration update event. Possible values include INFO, WARN, and ERROR.

            
          

          - **EventResourceType** *(string) --* 

            The resource type that Application Insights attempted to configure, for example, CLOUDWATCH_ALARM.

            
          

          - **EventTime** *(datetime) --* 

            The timestamp of the event.

            
          

          - **EventDetail** *(string) --* 

            The details of the event in plain text.

            
          

          - **EventResourceName** *(string) --* 

            The name of the resource Application Insights attempted to configure.

            
      
    
      

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

        The ``NextToken`` value to include in a future ``ListConfigurationHistory`` request. When the results of a ``ListConfigurationHistory`` request exceed ``MaxResults``, this value can be used to retrieve the next page of results. This value is ``null`` when there are no more results to return.

        
  
  **Exceptions**
  
  *   :py:class:`ApplicationInsights.Client.exceptions.ValidationException`

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

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

  