com.amazonaws.services.internetmonitor

Interface AmazonInternetMonitorAsync

All Superinterfaces:

AmazonInternetMonitor

All Known Implementing Classes:

AbstractAmazonInternetMonitorAsync, AmazonInternetMonitorAsyncClient

@Generated(value="com.amazonaws:aws-java-sdk-code-generator")
public interface AmazonInternetMonitorAsync
extends AmazonInternetMonitor

Interface for accessing Amazon CloudWatch Internet Monitor asynchronously. Each asynchronous method will return a Java Future object representing the asynchronous operation; overloads which accept an AsyncHandler can be used to receive notification when an asynchronous operation completes.

Note: Do not directly implement this interface, new methods are added to it regularly. Extend from AbstractAmazonInternetMonitorAsync instead.

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, reducing the time it takes for you to diagnose these issues, from days to minutes. You can explore internet measurements for different time frames and at different geographic granularities, and quickly visualize the impact of issues, and then take action to improve your end users' experience, for example, by switching to other Amazon Web Services services or rerouting traffic to your workload through differentAmazon Web Services Regions.

If the issue is caused by the Amazon Web Services network, you'll automatically receive an Amazon Web Services Health Dashboard notification with the steps that Amazon Web Services is taking to mitigate the problem. To support integrating health information for geographies and networks specific to your application, Internet Monitor delivers measurements to CloudWatch Logs and CloudWatch Metrics. Internet Monitor also sends health events to Amazon EventBridge, so you can set up notifications. Internet Monitor monitors internet connectivity for your application through Amazon Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and Amazon WorkSpaces directories.

To use Internet Monitor, you create a monitor and add resources to it, Virtual Private Clouds (VPCs), Amazon CloudFront distributions, or WorkSpaces directories that show 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 interface com.amazonaws.services.internetmonitor.AmazonInternetMonitor

ENDPOINT_PREFIX

Method Summary

Modifier and Type	Method and Description
Future<CreateMonitorResult>	createMonitorAsync(CreateMonitorRequest createMonitorRequest) Creates a monitor in Amazon CloudWatch Internet Monitor.
Future<CreateMonitorResult>	createMonitorAsync(CreateMonitorRequest createMonitorRequest, AsyncHandler<CreateMonitorRequest,CreateMonitorResult> asyncHandler) Creates a monitor in Amazon CloudWatch Internet Monitor.
Future<DeleteMonitorResult>	deleteMonitorAsync(DeleteMonitorRequest deleteMonitorRequest) Deletes a monitor in Amazon CloudWatch Internet Monitor.
Future<DeleteMonitorResult>	deleteMonitorAsync(DeleteMonitorRequest deleteMonitorRequest, AsyncHandler<DeleteMonitorRequest,DeleteMonitorResult> asyncHandler) Deletes a monitor in Amazon CloudWatch Internet Monitor.
Future<GetHealthEventResult>	getHealthEventAsync(GetHealthEventRequest getHealthEventRequest) Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor.
Future<GetHealthEventResult>	getHealthEventAsync(GetHealthEventRequest getHealthEventRequest, AsyncHandler<GetHealthEventRequest,GetHealthEventResult> asyncHandler) Gets information the Amazon CloudWatch Internet Monitor has created and stored about a health event for a specified monitor.
Future<GetMonitorResult>	getMonitorAsync(GetMonitorRequest getMonitorRequest) Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name.
Future<GetMonitorResult>	getMonitorAsync(GetMonitorRequest getMonitorRequest, AsyncHandler<GetMonitorRequest,GetMonitorResult> asyncHandler) Gets information about a monitor in Amazon CloudWatch Internet Monitor based on a monitor name.
Future<ListHealthEventsResult>	listHealthEventsAsync(ListHealthEventsRequest listHealthEventsRequest) Lists all health events for a monitor in Amazon CloudWatch Internet Monitor.
Future<ListHealthEventsResult>	listHealthEventsAsync(ListHealthEventsRequest listHealthEventsRequest, AsyncHandler<ListHealthEventsRequest,ListHealthEventsResult> asyncHandler) Lists all health events for a monitor in Amazon CloudWatch Internet Monitor.
Future<ListMonitorsResult>	listMonitorsAsync(ListMonitorsRequest listMonitorsRequest) 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.
Future<ListMonitorsResult>	listMonitorsAsync(ListMonitorsRequest listMonitorsRequest, AsyncHandler<ListMonitorsRequest,ListMonitorsResult> asyncHandler) 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.
Future<ListTagsForResourceResult>	listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest) Lists the tags for a resource.
Future<ListTagsForResourceResult>	listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest, AsyncHandler<ListTagsForResourceRequest,ListTagsForResourceResult> asyncHandler) Lists the tags for a resource.
Future<TagResourceResult>	tagResourceAsync(TagResourceRequest tagResourceRequest) Adds a tag to a resource.
Future<TagResourceResult>	tagResourceAsync(TagResourceRequest tagResourceRequest, AsyncHandler<TagResourceRequest,TagResourceResult> asyncHandler) Adds a tag to a resource.
Future<UntagResourceResult>	untagResourceAsync(UntagResourceRequest untagResourceRequest) Removes a tag from a resource.
Future<UntagResourceResult>	untagResourceAsync(UntagResourceRequest untagResourceRequest, AsyncHandler<UntagResourceRequest,UntagResourceResult> asyncHandler) Removes a tag from a resource.
Future<UpdateMonitorResult>	updateMonitorAsync(UpdateMonitorRequest updateMonitorRequest) Updates a monitor.
Future<UpdateMonitorResult>	updateMonitorAsync(UpdateMonitorRequest updateMonitorRequest, AsyncHandler<UpdateMonitorRequest,UpdateMonitorResult> asyncHandler) Updates a monitor.

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

createMonitor, deleteMonitor, getCachedResponseMetadata, getHealthEvent, getMonitor, listHealthEvents, listMonitors, listTagsForResource, shutdown, tagResource, untagResource, updateMonitor

Method Detail

createMonitorAsync

Future<CreateMonitorResult> createMonitorAsync(CreateMonitorRequest createMonitorRequest)

Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and WorkSpaces directories.

After you create a monitor, you can view the internet performance for your application, scoped to a location, as well as any health events that are impairing traffic. Internet Monitor can also diagnose whether the impairment is on the Amazon Web Services network or is an issue with an internet service provider (ISP).

Parameters:

createMonitorRequest -

Returns:

A Java Future containing the result of the CreateMonitor operation returned by the service.

See Also:

AWS API Documentation

createMonitorAsync

Future<CreateMonitorResult> createMonitorAsync(CreateMonitorRequest createMonitorRequest,
                                               AsyncHandler<CreateMonitorRequest,CreateMonitorResult> asyncHandler)

Creates a monitor in Amazon CloudWatch Internet Monitor. A monitor is built based on information from the application resources that you add: Virtual Private Clouds (VPCs), Amazon CloudFront distributions, and WorkSpaces directories.

After you create a monitor, you can view the internet performance for your application, scoped to a location, as well as any health events that are impairing traffic. Internet Monitor can also diagnose whether the impairment is on the Amazon Web Services network or is an issue with an internet service provider (ISP).

Parameters:

createMonitorRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the CreateMonitor operation returned by the service.

See Also:

AWS API Documentation

deleteMonitorAsync

Future<DeleteMonitorResult> deleteMonitorAsync(DeleteMonitorRequest deleteMonitorRequest)

Deletes a monitor in Amazon CloudWatch Internet Monitor.

Parameters:

deleteMonitorRequest -

Returns:

A Java Future containing the result of the DeleteMonitor operation returned by the service.

See Also:

AWS API Documentation

deleteMonitorAsync

Future<DeleteMonitorResult> deleteMonitorAsync(DeleteMonitorRequest deleteMonitorRequest,
                                               AsyncHandler<DeleteMonitorRequest,DeleteMonitorResult> asyncHandler)

Deletes a monitor in Amazon CloudWatch Internet Monitor.

Parameters:

deleteMonitorRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the DeleteMonitor operation returned by the service.

See Also:

AWS API Documentation

getHealthEventAsync

Future<GetHealthEventResult> getHealthEventAsync(GetHealthEventRequest getHealthEventRequest)

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.

Parameters:

getHealthEventRequest -

Returns:

A Java Future containing the result of the GetHealthEvent operation returned by the service.

See Also:

AWS API Documentation

getHealthEventAsync

Future<GetHealthEventResult> getHealthEventAsync(GetHealthEventRequest getHealthEventRequest,
                                                 AsyncHandler<GetHealthEventRequest,GetHealthEventResult> asyncHandler)

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.

Parameters:

getHealthEventRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the GetHealthEvent operation returned by the service.

See Also:

AWS API Documentation

getMonitorAsync

Future<GetMonitorResult> getMonitorAsync(GetMonitorRequest getMonitorRequest)

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.

Parameters:

getMonitorRequest -

Returns:

A Java Future containing the result of the GetMonitor operation returned by the service.

See Also:

AWS API Documentation

getMonitorAsync

Future<GetMonitorResult> getMonitorAsync(GetMonitorRequest getMonitorRequest,
                                         AsyncHandler<GetMonitorRequest,GetMonitorResult> asyncHandler)

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.

Parameters:

getMonitorRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the GetMonitor operation returned by the service.

See Also:

AWS API Documentation

listHealthEventsAsync

Future<ListHealthEventsResult> listHealthEventsAsync(ListHealthEventsRequest listHealthEventsRequest)

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.

Parameters:

listHealthEventsRequest -

Returns:

A Java Future containing the result of the ListHealthEvents operation returned by the service.

See Also:

AWS API Documentation

listHealthEventsAsync

Future<ListHealthEventsResult> listHealthEventsAsync(ListHealthEventsRequest listHealthEventsRequest,
                                                     AsyncHandler<ListHealthEventsRequest,ListHealthEventsResult> asyncHandler)

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.

Parameters:

listHealthEventsRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the ListHealthEvents operation returned by the service.

See Also:

AWS API Documentation

listMonitorsAsync

Future<ListMonitorsResult> listMonitorsAsync(ListMonitorsRequest listMonitorsRequest)

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.

Parameters:

listMonitorsRequest -

Returns:

A Java Future containing the result of the ListMonitors operation returned by the service.

See Also:

AWS API Documentation

listMonitorsAsync

Future<ListMonitorsResult> listMonitorsAsync(ListMonitorsRequest listMonitorsRequest,
                                             AsyncHandler<ListMonitorsRequest,ListMonitorsResult> asyncHandler)

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.

Parameters:

listMonitorsRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the ListMonitors operation returned by the service.

See Also:

AWS API Documentation

listTagsForResourceAsync

Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest)

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

Parameters:

listTagsForResourceRequest -

Returns:

A Java Future containing the result of the ListTagsForResource operation returned by the service.

See Also:

AWS API Documentation

listTagsForResourceAsync

Future<ListTagsForResourceResult> listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest,
                                                           AsyncHandler<ListTagsForResourceRequest,ListTagsForResourceResult> asyncHandler)

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

Parameters:

listTagsForResourceRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the ListTagsForResource operation returned by the service.

See Also:

AWS API Documentation

tagResourceAsync

Future<TagResourceResult> tagResourceAsync(TagResourceRequest tagResourceRequest)

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.

Parameters:

tagResourceRequest -

Returns:

A Java Future containing the result of the TagResource operation returned by the service.

See Also:

AWS API Documentation

tagResourceAsync

Future<TagResourceResult> tagResourceAsync(TagResourceRequest tagResourceRequest,
                                           AsyncHandler<TagResourceRequest,TagResourceResult> asyncHandler)

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.

Parameters:

tagResourceRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the TagResource operation returned by the service.

See Also:

AWS API Documentation

untagResourceAsync

Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest untagResourceRequest)

Removes a tag from a resource.

Parameters:

untagResourceRequest -

Returns:

A Java Future containing the result of the UntagResource operation returned by the service.

See Also:

AWS API Documentation

untagResourceAsync

Future<UntagResourceResult> untagResourceAsync(UntagResourceRequest untagResourceRequest,
                                               AsyncHandler<UntagResourceRequest,UntagResourceResult> asyncHandler)

Removes a tag from a resource.

Parameters:

untagResourceRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the UntagResource operation returned by the service.

See Also:

AWS API Documentation

updateMonitorAsync

Future<UpdateMonitorResult> updateMonitorAsync(UpdateMonitorRequest updateMonitorRequest)

Updates a monitor. You can update a monitor to add or remove resources, or to change the status of the monitor. You can't change the name of a monitor.

Parameters:

updateMonitorRequest -

Returns:

A Java Future containing the result of the UpdateMonitor operation returned by the service.

See Also:

AWS API Documentation

updateMonitorAsync

Future<UpdateMonitorResult> updateMonitorAsync(UpdateMonitorRequest updateMonitorRequest,
                                               AsyncHandler<UpdateMonitorRequest,UpdateMonitorResult> asyncHandler)

Updates a monitor. You can update a monitor to add or remove resources, or to change the status of the monitor. You can't change the name of a monitor.

Parameters:

updateMonitorRequest -

asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an implementation of the callback methods in this interface to receive notification of successful or unsuccessful completion of the operation.

Returns:

A Java Future containing the result of the UpdateMonitor operation returned by the service.

See Also:

AWS API Documentation