com.amazonaws.services.internetmonitor

Class AmazonInternetMonitorClient

java.lang.Object

com.amazonaws.AmazonWebServiceClient

com.amazonaws.services.internetmonitor.AmazonInternetMonitorClient

All Implemented Interfaces:

AmazonInternetMonitor

Direct Known Subclasses:

AmazonInternetMonitorAsyncClient

@ThreadSafe
 @Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public class AmazonInternetMonitorClient
extends AmazonWebServiceClient
implements AmazonInternetMonitor

Client for accessing Amazon CloudWatch Internet Monitor. All service calls made using this client are blocking, and will not return until the service call completes.

Amazon CloudWatch Internet Monitor provides visibility into how internet issues impact the performance and availability between your applications hosted on Amazon Web Services and your end users. It reduces the time it takes for you to diagnose internet issues from days to minutes. Internet Monitor uses the connectivity data that Amazon Web Services captures from its global networking footprint to calculate a baseline of performance and availability for internet traffic. This is the same data that Amazon Web Services uses to monitor internet uptime and availability. With those measurements as a baseline, Internet Monitor raises awareness for you when there are significant problems for your end users in the different geographic locations where your application runs.

Internet Monitor publishes internet measurements to CloudWatch Logs and CloudWatch Metrics, to easily support using CloudWatch tools with health information for geographies and networks specific to your application. Internet Monitor sends health events to Amazon EventBridge so that you can set up notifications. If an issue is caused by the Amazon Web Services network, you also automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking to mitigate the problem.

To use Internet Monitor, you create a monitor and associate your application's resources with it, VPCs, CloudFront distributions, or WorkSpaces directories, to enable Internet Monitor to know where your application's internet traffic is. Internet Monitor then provides internet measurements from Amazon Web Services that are specific to the locations and networks that communicate with your application.

For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide.

Field Summary

Fields inherited from class com.amazonaws.AmazonWebServiceClient

LOGGING_AWS_REQUEST_METRIC

Fields inherited from interface com.amazonaws.services.internetmonitor.AmazonInternetMonitor

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
static AmazonInternetMonitorClientBuilder	builder()
CreateMonitorResult	createMonitor(CreateMonitorRequest request) Creates a monitor in Amazon CloudWatch Internet Monitor.
DeleteMonitorResult	deleteMonitor(DeleteMonitorRequest request) Deletes a monitor in Amazon CloudWatch Internet Monitor.
ResponseMetadata	getCachedResponseMetadata(AmazonWebServiceRequest request) Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected.
GetHealthEventResult	getHealthEvent(GetHealthEventRequest request) Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor.
GetMonitorResult	getMonitor(GetMonitorRequest request) Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name.
ListHealthEventsResult	listHealthEvents(ListHealthEventsRequest request) Lists all health events for a monitor in Amazon CloudWatch Internet Monitor.
ListMonitorsResult	listMonitors(ListMonitorsRequest request) Lists all of your monitors for Amazon CloudWatch Internet Monitor and their statuses, along with the Amazon Resource Name (ARN) and name of each monitor.
ListTagsForResourceResult	listTagsForResource(ListTagsForResourceRequest request) Lists the tags for a resource.
void	shutdown() Shuts down this client object, releasing any resources that might be held open.
TagResourceResult	tagResource(TagResourceRequest request) Adds a tag to a resource.
UntagResourceResult	untagResource(UntagResourceRequest request) Removes a tag from a resource.
UpdateMonitorResult	updateMonitor(UpdateMonitorRequest request) Updates a monitor.

Methods inherited from class com.amazonaws.AmazonWebServiceClient

addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffset

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

builder

public static AmazonInternetMonitorClientBuilder builder()

createMonitor

public CreateMonitorResult createMonitor(CreateMonitorRequest request)

Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: Amazon Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and WorkSpaces directories. Internet Monitor then publishes internet measurements from Amazon Web Services that are specific to the city-networks, that is, the locations and ASNs (typically internet service providers or ISPs), where clients access your application. For more information, see Using Amazon CloudWatch Internet Monitor in the Amazon CloudWatch User Guide.

When you create a monitor, you set a maximum limit for the number of city-networks where client traffic is monitored. The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. You can change the maximum at any time by updating your monitor. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.

Specified by:

createMonitor in interface AmazonInternetMonitor

Parameters:

createMonitorRequest -

Returns:

Result of the CreateMonitor operation returned by the service.

Throws:

InternalServerException - An internal error occurred.

AccessDeniedException - You don't have sufficient permission to perform this action.

ThrottlingException - The request was denied due to request throttling.

ConflictException - The requested resource is in use.

LimitExceededException - The request exceeded a service quota.

ValidationException - Invalid request.

See Also:

AWS API Documentation

deleteMonitor

public DeleteMonitorResult deleteMonitor(DeleteMonitorRequest request)

Deletes a monitor in Amazon CloudWatch Internet Monitor.

Specified by:

deleteMonitor in interface AmazonInternetMonitor

Parameters:

deleteMonitorRequest -

Returns:

Result of the DeleteMonitor operation returned by the service.

Throws:

InternalServerException - An internal error occurred.

AccessDeniedException - You don't have sufficient permission to perform this action.

ThrottlingException - The request was denied due to request throttling.

ValidationException - Invalid request.

See Also:

AWS API Documentation

getHealthEvent

public GetHealthEventResult getHealthEvent(GetHealthEventRequest request)

Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor. This information includes the impacted locations, and all of the information related to the event by location.

The information returned includes the performance, availability, and round-trip time impact, information about the network providers, the event type, and so on.

Information rolled up at the global traffic level is also returned, including the impact type and total traffic impact.

Specified by:

getHealthEvent in interface AmazonInternetMonitor

Parameters:

getHealthEventRequest -

Returns:

Result of the GetHealthEvent operation returned by the service.

Throws:

InternalServerException - An internal error occurred.

AccessDeniedException - You don't have sufficient permission to perform this action.

ThrottlingException - The request was denied due to request throttling.

ValidationException - Invalid request.

See Also:

AWS API Documentation

getMonitor

public GetMonitorResult getMonitor(GetMonitorRequest request)

Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name. The information returned includes the Amazon Resource Name (ARN), create time, modified time, resources included in the monitor, and status information.

Specified by:

getMonitor in interface AmazonInternetMonitor

Parameters:

getMonitorRequest -

Returns:

Result of the GetMonitor operation returned by the service.

Throws:

InternalServerException - An internal error occurred.

AccessDeniedException - You don't have sufficient permission to perform this action.

ThrottlingException - The request was denied due to request throttling.

ValidationException - Invalid request.

See Also:

AWS API Documentation

listHealthEvents

public ListHealthEventsResult listHealthEvents(ListHealthEventsRequest request)

Lists all health events for a monitor in Amazon CloudWatch Internet Monitor. Returns all information for health events including the client location information the network cause and status, event start and end time, percentage of total traffic impacted, and status.

Health events that have start times during the time frame that is requested are not included in the list of health events.

Specified by:

listHealthEvents in interface AmazonInternetMonitor

Parameters:

listHealthEventsRequest -

Returns:

Result of the ListHealthEvents operation returned by the service.

Throws:

InternalServerException - An internal error occurred.

AccessDeniedException - You don't have sufficient permission to perform this action.

ThrottlingException - The request was denied due to request throttling.

ValidationException - Invalid request.

See Also:

AWS API Documentation

listMonitors

public ListMonitorsResult listMonitors(ListMonitorsRequest request)

Lists all of your monitors for Amazon CloudWatch Internet Monitor and their statuses, along with the Amazon Resource Name (ARN) and name of each monitor.

Specified by:

listMonitors in interface AmazonInternetMonitor

Parameters:

listMonitorsRequest -

Returns:

Result of the ListMonitors operation returned by the service.

Throws:

InternalServerException - An internal error occurred.

AccessDeniedException - You don't have sufficient permission to perform this action.

ThrottlingException - The request was denied due to request throttling.

ValidationException - Invalid request.

See Also:

AWS API Documentation

listTagsForResource

public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)

Lists the tags for a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor.

Specified by:

listTagsForResource in interface AmazonInternetMonitor

Parameters:

listTagsForResourceRequest -

Returns:

Result of the ListTagsForResource operation returned by the service.

Throws:

TooManyRequestsException - There were too many requests.

AccessDeniedException - You don't have sufficient permission to perform this action.

NotFoundException - The request specifies something that doesn't exist.

BadRequestException - A bad request was received.

InternalServerErrorException - There was an internal server error.

See Also:

AWS API Documentation

tagResource

public TagResourceResult tagResource(TagResourceRequest request)

Adds a tag to a resource. Tags are supported only for monitors in Amazon CloudWatch Internet Monitor. You can add a maximum of 50 tags in Internet Monitor.

A minimum of one tag is required for this call. It returns an error if you use the TagResource request with 0 tags.

Specified by:

tagResource in interface AmazonInternetMonitor

Parameters:

tagResourceRequest -

Returns:

Result of the TagResource operation returned by the service.

Throws:

TooManyRequestsException - There were too many requests.

AccessDeniedException - You don't have sufficient permission to perform this action.

NotFoundException - The request specifies something that doesn't exist.

BadRequestException - A bad request was received.

InternalServerErrorException - There was an internal server error.

See Also:

AWS API Documentation

untagResource

public UntagResourceResult untagResource(UntagResourceRequest request)

Removes a tag from a resource.

Specified by:

untagResource in interface AmazonInternetMonitor

Parameters:

untagResourceRequest -

Returns:

Result of the UntagResource operation returned by the service.

Throws:

TooManyRequestsException - There were too many requests.

AccessDeniedException - You don't have sufficient permission to perform this action.

NotFoundException - The request specifies something that doesn't exist.

BadRequestException - A bad request was received.

InternalServerErrorException - There was an internal server error.

See Also:

AWS API Documentation

updateMonitor

public UpdateMonitorResult updateMonitor(UpdateMonitorRequest request)

Updates a monitor. You can update a monitor to change the maximum number of city-networks (locations and ASNs or internet service providers), to add or remove resources, or to change the status of the monitor. Note that you can't change the name of a monitor.

The city-network maximum that you choose is the limit, but you only pay for the number of city-networks that are actually monitored. For more information, see Choosing a city-network maximum value in the Amazon CloudWatch User Guide.

Specified by:

updateMonitor in interface AmazonInternetMonitor

Parameters:

updateMonitorRequest -

Returns:

Result of the UpdateMonitor operation returned by the service.

Throws:

InternalServerException - An internal error occurred.

ResourceNotFoundException - The request specifies a resource that doesn't exist.

AccessDeniedException - You don't have sufficient permission to perform this action.

ThrottlingException - The request was denied due to request throttling.

LimitExceededException - The request exceeded a service quota.

ValidationException - Invalid request.

See Also:

AWS API Documentation

getCachedResponseMetadata

public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)

Returns additional metadata for a previously executed successful, request, typically used for debugging issues where a service isn't acting as expected. This data isn't considered part of the result data returned by an operation, so it's available through this separate, diagnostic interface.

Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.

Specified by:

getCachedResponseMetadata in interface AmazonInternetMonitor

Parameters:

request - The originally executed request

Returns:

The response metadata for the specified request, or null if none is available.

shutdown

public void shutdown()

Description copied from class: AmazonWebServiceClient

Shuts down this client object, releasing any resources that might be held open. If this method is not invoked, resources may be leaked. Once a client has been shutdown, it should not be used to make any more requests.

Specified by:

shutdown in interface AmazonInternetMonitor

Overrides:

shutdown in class AmazonWebServiceClient