CloudWatchInternetMonitor / Client / get_internet_event

get_internet_event#

CloudWatchInternetMonitor.Client.get_internet_event(**kwargs)#

Gets information that Amazon CloudWatch Internet Monitor has generated about an internet event. 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.

The information returned here includes the impacted location, when the event started and (if the event is over) ended, the type of event ( PERFORMANCE or AVAILABILITY), and the status ( ACTIVE or RESOLVED).

See also: AWS API Documentation

Request Syntax

response = client.get_internet_event(
    EventId='string'
)
Parameters:

EventId (string) –

[REQUIRED]

The EventId of the internet event to return information for.

Return type:

dict

Returns:

Response Syntax

{
    '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) –

    • 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 the internet event started.

    • EndedAt (datetime) –

      The time when the internet event ended. If the event hasn’t ended yet, this value is empty.

    • ClientLocation (dict) –

      The impacted location, such as a city, where clients access Amazon Web Services application resources.

      • 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 the internet event.

Exceptions

  • CloudWatchInternetMonitor.Client.exceptions.InternalServerException

  • CloudWatchInternetMonitor.Client.exceptions.AccessDeniedException

  • CloudWatchInternetMonitor.Client.exceptions.ThrottlingException

  • CloudWatchInternetMonitor.Client.exceptions.ValidationException