CloudWatchInternetMonitor / Client / list_internet_events

list_internet_events#

CloudWatchInternetMonitor.Client.list_internet_events(**kwargs)#

Lists internet events that cause performance or availability issues for client locations. Amazon CloudWatch 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.

You can constrain the list of internet events returned by providing a start time and end time to define a total time frame for events you want to list. Both start time and end time specify the time when an event started. End time is optional. If you don’t include it, the default end time is the current time.

You can also limit the events returned to a specific status ( ACTIVE or RESOLVED) or type ( PERFORMANCE or AVAILABILITY).

See also: AWS API Documentation

Request Syntax

response = client.list_internet_events(
    NextToken='string',
    MaxResults=123,
    StartTime=datetime(2015, 1, 1),
    EndTime=datetime(2015, 1, 1),
    EventStatus='string',
    EventType='string'
)
Parameters:

  • NextToken (string) – The token for the next set of results. You receive this token from a previous call.

  • MaxResults (integer) – The number of query results that you want to return with this call.

  • 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.

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'
        },
    ],
    'NextToken': 'string'
}

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.

    • NextToken (string) –

      The token for the next set of results. You receive this token from a previous call.

Exceptions

  • CloudWatchInternetMonitor.Client.exceptions.InternalServerException

  • CloudWatchInternetMonitor.Client.exceptions.AccessDeniedException

  • CloudWatchInternetMonitor.Client.exceptions.ThrottlingException

  • CloudWatchInternetMonitor.Client.exceptions.ValidationException