Skip to content

get_internet_event

get_internet_event(
    event_id: InternetEventId,
    *,
    config_overrides: Optional[InternetMonitorClientConfig] = None,
) -> GetInternetEventOutput

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

Parameters:

  • event_id (InternetEventId) –

    The EventId of the internet event to return information for.

Raises:

Source code in docs_src/capo_internetmonitor/_services/internet_monitor.py
def get_internet_event(
    self,
    event_id: "capo_internetmonitor.types.internet_event_id.InternetEventId",
    *,
    config_overrides: Optional[InternetMonitorClientConfig] = None,
) -> "capo_internetmonitor.types.get_internet_event_output.GetInternetEventOutput":
    """<p>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. </p> <p>The information returned here includes the impacted location, when the event started and (if the event is over) ended, the type of event (<code>PERFORMANCE</code> or <code>AVAILABILITY</code>), and the status (<code>ACTIVE</code> or <code>RESOLVED</code>).</p>

    Args:
        event_id: <p>The <code>EventId</code> of the internet event to return information for. </p>

    Raises:
        capo_internetmonitor.errors.access_denied_exception.AccessDeniedException: <p>You don't have sufficient permission to perform this action.</p>
        capo_internetmonitor.errors.internal_server_exception.InternalServerException: <p>An internal error occurred.</p>
        capo_internetmonitor.errors.throttling_exception.ThrottlingException: <p>The request was denied due to request throttling.</p>
        capo_internetmonitor.errors.validation_exception.ValidationException: <p>Invalid request.</p>
        capo_internetmonitor.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_internetmonitor.types.get_internet_event_input.GetInternetEventInput]",
    ) -> OperationResponse[
        "capo_internetmonitor.types.get_internet_event_output.GetInternetEventOutput"
    ]:
        import capo_internetmonitor._operations.internet_monitor20210603.get_internet_event

        output, http_response = (
            capo_internetmonitor._operations.internet_monitor20210603.get_internet_event.get_internet_event(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("GetInternetEvent")
    )
    input_: capo_internetmonitor.types.get_internet_event_input.GetInternetEventInput = {
        "event_id": event_id
    }

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output