CloudWatchInternetMonitor / Paginator / ListInternetEvents

ListInternetEvents#

class CloudWatchInternetMonitor.Paginator.ListInternetEvents#

paginator = client.get_paginator('list_internet_events')

paginate(**kwargs)#

Creates an iterator that will paginate through responses from CloudWatchInternetMonitor.Client.list_internet_events().

Request Syntax

response_iterator = paginator.paginate(
    StartTime=datetime(2015, 1, 1),
    EndTime=datetime(2015, 1, 1),
    EventStatus='string',
    EventType='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)

Parameters:

StartTime (datetime) – The start time of the time window that you want to get a list of internet events for.
EndTime (datetime) – The end time of the time window that you want to get a list of internet events for.
EventStatus (string) – The status of an internet event.
EventType (string) – The type of network impairment.
PaginationConfig (dict) –
A dictionary that provides parameters to control pagination.
- MaxItems (integer) –
  
  The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.
- PageSize (integer) –
  
  The size of each page.
- StartingToken (string) –
  
  A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'InternetEvents': [
        {
            'EventId': 'string',
            'EventArn': 'string',
            'StartedAt': datetime(2015, 1, 1),
            'EndedAt': datetime(2015, 1, 1),
            'ClientLocation': {
                'ASName': 'string',
                'ASNumber': 123,
                'Country': 'string',
                'Subdivision': 'string',
                'Metro': 'string',
                'City': 'string',
                'Latitude': 123.0,
                'Longitude': 123.0
            },
            'EventType': 'AVAILABILITY'|'PERFORMANCE',
            'EventStatus': 'ACTIVE'|'RESOLVED'
        },
    ],

}

Response Structure

(dict) –
- InternetEvents (list) –
  
  A set of internet events returned for the list operation.
  - (dict) –
    
    A summary of information about an internet event in Amazon CloudWatch Internet Monitor. Internet events are issues that cause performance degradation or availability problems for impacted Amazon Web Services client locations. Internet Monitor displays information about recent global health events, called internet events, on a global outages map that is available to all Amazon Web Services customers.
    - EventId (string) –
      
      The internally-generated identifier of an internet event.
    - EventArn (string) –
      
      The Amazon Resource Name (ARN) of the internet event.
    - StartedAt (datetime) –
      
      The time when an internet event started.
    - EndedAt (datetime) –
      
      The time when an internet event ended. If the event hasn’t ended yet, this value is empty.
    - ClientLocation (dict) –
      
      The impacted location, such as a city, that Amazon Web Services clients access application resources from.
      - ASName (string) –
        
        The name of the internet service provider (ISP) or network (ASN).
      - ASNumber (integer) –
        
        The Autonomous System Number (ASN) of the network at an impacted location.
      - Country (string) –
        
        The name of the country where the internet event is located.
      - Subdivision (string) –
        
        The subdivision location where the health event is located. The subdivision usually maps to states in most countries (including the United States). For United Kingdom, it maps to a country (England, Scotland, Wales) or province (Northern Ireland).
      - Metro (string) –
        
        The metro area where the health event is located.
        
        Metro indicates a metropolitan region in the United States, such as the region around New York City. In non-US countries, this is a second-level subdivision. For example, in the United Kingdom, it could be a county, a London borough, a unitary authority, council area, and so on.
      - City (string) –
        
        The name of the city where the internet event is located.
      - Latitude (float) –
        
        The latitude where the internet event is located.
      - Longitude (float) –
        
        The longitude where the internet event is located.
    - EventType (string) –
      
      The type of network impairment.
    - EventStatus (string) –
      
      The status of an internet event.