All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.amazonaws.services.cloudwatch.AmazonCloudWatchAsync Maven / Gradle / Ivy

Go to download

The AWS Java SDK for Amazon CloudWatch module holds the client classes that are used for communicating with Amazon CloudWatch Service

There is a newer version: 1.12.780
Show newest version
/*
 * Copyright 2011-2016 Amazon.com, Inc. or its affiliates. All Rights Reserved.
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"). You may not
 * use this file except in compliance with the License. A copy of the License is
 * located at
 * 
 * http://aws.amazon.com/apache2.0
 * 
 * or in the "license" file accompanying this file. This file is distributed on
 * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either
 * express or implied. See the License for the specific language governing
 * permissions and limitations under the License.
 */
package com.amazonaws.services.cloudwatch;

import com.amazonaws.services.cloudwatch.model.*;

/**
 * Interface for accessing CloudWatch asynchronously. Each asynchronous method
 * will return a Java Future object representing the asynchronous operation;
 * overloads which accept an {@code AsyncHandler} can be used to receive
 * notification when an asynchronous operation completes.
 * 

*

* Amazon CloudWatch monitors your Amazon Web Services (AWS) resources and the * applications you run on AWS in real-time. You can use CloudWatch to collect * and track metrics, which are the variables you want to measure for your * resources and applications. *

*

* CloudWatch alarms send notifications or automatically make changes to the * resources you are monitoring based on rules that you define. For example, you * can monitor the CPU usage and disk reads and writes of your Amazon Elastic * Compute Cloud (Amazon EC2) instances and then use this data to determine * whether you should launch additional instances to handle increased load. You * can also use this data to stop under-used instances to save money. *

*

* In addition to monitoring the built-in metrics that come with AWS, you can * monitor your own custom metrics. With CloudWatch, you gain system-wide * visibility into resource utilization, application performance, and * operational health. *

*/ public interface AmazonCloudWatchAsync extends AmazonCloudWatch { /** *

* Deletes all specified alarms. In the event of an error, no alarms are * deleted. *

* * @param deleteAlarmsRequest * Describes the inputs for DeleteAlarms. * @return A Java Future containing the result of the DeleteAlarms operation * returned by the service. * @sample AmazonCloudWatchAsync.DeleteAlarms */ java.util.concurrent.Future deleteAlarmsAsync( DeleteAlarmsRequest deleteAlarmsRequest); /** *

* Deletes all specified alarms. In the event of an error, no alarms are * deleted. *

* * @param deleteAlarmsRequest * Describes the inputs for DeleteAlarms. * @param 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. * @return A Java Future containing the result of the DeleteAlarms operation * returned by the service. * @sample AmazonCloudWatchAsyncHandler.DeleteAlarms */ java.util.concurrent.Future deleteAlarmsAsync( DeleteAlarmsRequest deleteAlarmsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Retrieves history for the specified alarm. Filter alarms by date range or * item type. If an alarm name is not specified, Amazon CloudWatch returns * histories for all of the owner's alarms. *

* *

* Amazon CloudWatch retains the history of an alarm for two weeks, whether * or not you delete the alarm. *

*
* * @param describeAlarmHistoryRequest * Describes the inputs for DescribeAlarmHistory. * @return A Java Future containing the result of the DescribeAlarmHistory * operation returned by the service. * @sample AmazonCloudWatchAsync.DescribeAlarmHistory */ java.util.concurrent.Future describeAlarmHistoryAsync( DescribeAlarmHistoryRequest describeAlarmHistoryRequest); /** *

* Retrieves history for the specified alarm. Filter alarms by date range or * item type. If an alarm name is not specified, Amazon CloudWatch returns * histories for all of the owner's alarms. *

* *

* Amazon CloudWatch retains the history of an alarm for two weeks, whether * or not you delete the alarm. *

*
* * @param describeAlarmHistoryRequest * Describes the inputs for DescribeAlarmHistory. * @param 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. * @return A Java Future containing the result of the DescribeAlarmHistory * operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.DescribeAlarmHistory */ java.util.concurrent.Future describeAlarmHistoryAsync( DescribeAlarmHistoryRequest describeAlarmHistoryRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** * Simplified method form for invoking the DescribeAlarmHistory operation. * * @see #describeAlarmHistoryAsync(DescribeAlarmHistoryRequest) */ java.util.concurrent.Future describeAlarmHistoryAsync(); /** * Simplified method form for invoking the DescribeAlarmHistory operation * with an AsyncHandler. * * @see #describeAlarmHistoryAsync(DescribeAlarmHistoryRequest, * com.amazonaws.handlers.AsyncHandler) */ java.util.concurrent.Future describeAlarmHistoryAsync( com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Retrieves alarms with the specified names. If no name is specified, all * alarms for the user are returned. Alarms can be retrieved by using only a * prefix for the alarm name, the alarm state, or a prefix for any action. *

* * @param describeAlarmsRequest * Describes the inputs for DescribeAlarms. * @return A Java Future containing the result of the DescribeAlarms * operation returned by the service. * @sample AmazonCloudWatchAsync.DescribeAlarms */ java.util.concurrent.Future describeAlarmsAsync( DescribeAlarmsRequest describeAlarmsRequest); /** *

* Retrieves alarms with the specified names. If no name is specified, all * alarms for the user are returned. Alarms can be retrieved by using only a * prefix for the alarm name, the alarm state, or a prefix for any action. *

* * @param describeAlarmsRequest * Describes the inputs for DescribeAlarms. * @param 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. * @return A Java Future containing the result of the DescribeAlarms * operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.DescribeAlarms */ java.util.concurrent.Future describeAlarmsAsync( DescribeAlarmsRequest describeAlarmsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** * Simplified method form for invoking the DescribeAlarms operation. * * @see #describeAlarmsAsync(DescribeAlarmsRequest) */ java.util.concurrent.Future describeAlarmsAsync(); /** * Simplified method form for invoking the DescribeAlarms operation with an * AsyncHandler. * * @see #describeAlarmsAsync(DescribeAlarmsRequest, * com.amazonaws.handlers.AsyncHandler) */ java.util.concurrent.Future describeAlarmsAsync( com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Retrieves all alarms for a single metric. Specify a statistic, period, or * unit to filter the set of alarms further. *

* * @param describeAlarmsForMetricRequest * Describes the inputs for DescribeAlarmsForMetric. * @return A Java Future containing the result of the * DescribeAlarmsForMetric operation returned by the service. * @sample AmazonCloudWatchAsync.DescribeAlarmsForMetric */ java.util.concurrent.Future describeAlarmsForMetricAsync( DescribeAlarmsForMetricRequest describeAlarmsForMetricRequest); /** *

* Retrieves all alarms for a single metric. Specify a statistic, period, or * unit to filter the set of alarms further. *

* * @param describeAlarmsForMetricRequest * Describes the inputs for DescribeAlarmsForMetric. * @param 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. * @return A Java Future containing the result of the * DescribeAlarmsForMetric operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.DescribeAlarmsForMetric */ java.util.concurrent.Future describeAlarmsForMetricAsync( DescribeAlarmsForMetricRequest describeAlarmsForMetricRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Disables actions for the specified alarms. When an alarm's actions are * disabled the alarm's state may change, but none of the alarm's actions * will execute. *

* * @param disableAlarmActionsRequest * @return A Java Future containing the result of the DisableAlarmActions * operation returned by the service. * @sample AmazonCloudWatchAsync.DisableAlarmActions */ java.util.concurrent.Future disableAlarmActionsAsync( DisableAlarmActionsRequest disableAlarmActionsRequest); /** *

* Disables actions for the specified alarms. When an alarm's actions are * disabled the alarm's state may change, but none of the alarm's actions * will execute. *

* * @param disableAlarmActionsRequest * @param 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. * @return A Java Future containing the result of the DisableAlarmActions * operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.DisableAlarmActions */ java.util.concurrent.Future disableAlarmActionsAsync( DisableAlarmActionsRequest disableAlarmActionsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Enables actions for the specified alarms. *

* * @param enableAlarmActionsRequest * Describes the inputs for EnableAlarmActions. * @return A Java Future containing the result of the EnableAlarmActions * operation returned by the service. * @sample AmazonCloudWatchAsync.EnableAlarmActions */ java.util.concurrent.Future enableAlarmActionsAsync( EnableAlarmActionsRequest enableAlarmActionsRequest); /** *

* Enables actions for the specified alarms. *

* * @param enableAlarmActionsRequest * Describes the inputs for EnableAlarmActions. * @param 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. * @return A Java Future containing the result of the EnableAlarmActions * operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.EnableAlarmActions */ java.util.concurrent.Future enableAlarmActionsAsync( EnableAlarmActionsRequest enableAlarmActionsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Gets statistics for the specified metric. *

*

* The maximum number of data points that can be queried is 50,850, whereas * the maximum number of data points returned from a single * GetMetricStatistics request is 1,440. If you make a request * that generates more than 1,440 data points, Amazon CloudWatch returns an * error. In such a case, you can alter the request by narrowing the * specified time range or increasing the specified period. A period can be * as short as one minute (60 seconds) or as long as one day (86,400 * seconds). Alternatively, you can make multiple requests across adjacent * time ranges. GetMetricStatistics does not return the data in * chronological order. *

*

* Amazon CloudWatch aggregates data points based on the length of the * period that you specify. For example, if you request * statistics with a one-minute granularity, Amazon CloudWatch aggregates * data points with time stamps that fall within the same one-minute period. * In such a case, the data points queried can greatly outnumber the data * points returned. *

*

* The following examples show various statistics allowed by the data point * query maximum of 50,850 when you call GetMetricStatistics on * Amazon EC2 instances with detailed (one-minute) monitoring enabled: *

*
    *
  • *

    * Statistics for up to 400 instances for a span of one hour *

    *
  • *
  • *

    * Statistics for up to 35 instances over a span of 24 hours *

    *
  • *
  • *

    * Statistics for up to 2 instances over a span of 2 weeks *

    *
  • *
*

* For information about the namespace, metric names, and dimensions that * other Amazon Web Services products use to send metrics to CloudWatch, go * to Amazon CloudWatch Metrics, Namespaces, and Dimensions Reference in * the Amazon CloudWatch Developer Guide. *

* * @param getMetricStatisticsRequest * Describes the inputs for GetMetricStatistics. * @return A Java Future containing the result of the GetMetricStatistics * operation returned by the service. * @sample AmazonCloudWatchAsync.GetMetricStatistics */ java.util.concurrent.Future getMetricStatisticsAsync( GetMetricStatisticsRequest getMetricStatisticsRequest); /** *

* Gets statistics for the specified metric. *

*

* The maximum number of data points that can be queried is 50,850, whereas * the maximum number of data points returned from a single * GetMetricStatistics request is 1,440. If you make a request * that generates more than 1,440 data points, Amazon CloudWatch returns an * error. In such a case, you can alter the request by narrowing the * specified time range or increasing the specified period. A period can be * as short as one minute (60 seconds) or as long as one day (86,400 * seconds). Alternatively, you can make multiple requests across adjacent * time ranges. GetMetricStatistics does not return the data in * chronological order. *

*

* Amazon CloudWatch aggregates data points based on the length of the * period that you specify. For example, if you request * statistics with a one-minute granularity, Amazon CloudWatch aggregates * data points with time stamps that fall within the same one-minute period. * In such a case, the data points queried can greatly outnumber the data * points returned. *

*

* The following examples show various statistics allowed by the data point * query maximum of 50,850 when you call GetMetricStatistics on * Amazon EC2 instances with detailed (one-minute) monitoring enabled: *

*
    *
  • *

    * Statistics for up to 400 instances for a span of one hour *

    *
  • *
  • *

    * Statistics for up to 35 instances over a span of 24 hours *

    *
  • *
  • *

    * Statistics for up to 2 instances over a span of 2 weeks *

    *
  • *
*

* For information about the namespace, metric names, and dimensions that * other Amazon Web Services products use to send metrics to CloudWatch, go * to Amazon CloudWatch Metrics, Namespaces, and Dimensions Reference in * the Amazon CloudWatch Developer Guide. *

* * @param getMetricStatisticsRequest * Describes the inputs for GetMetricStatistics. * @param 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. * @return A Java Future containing the result of the GetMetricStatistics * operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.GetMetricStatistics */ java.util.concurrent.Future getMetricStatisticsAsync( GetMetricStatisticsRequest getMetricStatisticsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Returns a list of valid metrics stored for the AWS account owner. * Returned metrics can be used with GetMetricStatistics to obtain * statistical data for a given metric. *

* *

* Up to 500 results are returned for any one call. To retrieve further * results, use returned NextToken values with subsequent * ListMetrics operations. *

*
*

* If you create a metric with PutMetricData, allow up to fifteen * minutes for the metric to appear in calls to ListMetrics. * Statistics about the metric, however, are available sooner using * GetMetricStatistics. *

*
* * @param listMetricsRequest * Describes the inputs for ListMetrics. * @return A Java Future containing the result of the ListMetrics operation * returned by the service. * @sample AmazonCloudWatchAsync.ListMetrics */ java.util.concurrent.Future listMetricsAsync( ListMetricsRequest listMetricsRequest); /** *

* Returns a list of valid metrics stored for the AWS account owner. * Returned metrics can be used with GetMetricStatistics to obtain * statistical data for a given metric. *

* *

* Up to 500 results are returned for any one call. To retrieve further * results, use returned NextToken values with subsequent * ListMetrics operations. *

*
*

* If you create a metric with PutMetricData, allow up to fifteen * minutes for the metric to appear in calls to ListMetrics. * Statistics about the metric, however, are available sooner using * GetMetricStatistics. *

*
* * @param listMetricsRequest * Describes the inputs for ListMetrics. * @param 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. * @return A Java Future containing the result of the ListMetrics operation * returned by the service. * @sample AmazonCloudWatchAsyncHandler.ListMetrics */ java.util.concurrent.Future listMetricsAsync( ListMetricsRequest listMetricsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** * Simplified method form for invoking the ListMetrics operation. * * @see #listMetricsAsync(ListMetricsRequest) */ java.util.concurrent.Future listMetricsAsync(); /** * Simplified method form for invoking the ListMetrics operation with an * AsyncHandler. * * @see #listMetricsAsync(ListMetricsRequest, * com.amazonaws.handlers.AsyncHandler) */ java.util.concurrent.Future listMetricsAsync( com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates or updates an alarm and associates it with the specified Amazon * CloudWatch metric. Optionally, this operation can associate one or more * Amazon SNS resources with the alarm. *

*

* When this operation creates an alarm, the alarm state is immediately set * to INSUFFICIENT_DATA. The alarm is evaluated and its * StateValue is set appropriately. Any actions associated with * the StateValue are then executed. *

* *

* When updating an existing alarm, its StateValue is left * unchanged, but it completely overwrites the alarm's previous * configuration. *

*
*

* If you are using an AWS Identity and Access Management (IAM) account to * create or modify an alarm, you must have the following Amazon EC2 * permissions: *

*
    *
  • *

    * ec2:DescribeInstanceStatus and * ec2:DescribeInstances for all alarms on Amazon EC2 instance * status metrics. *

    *
  • *
  • *

    * ec2:StopInstances for alarms with stop actions. *

    *
  • *
  • *

    * ec2:TerminateInstances for alarms with terminate actions. *

    *
  • *
  • *

    * ec2:DescribeInstanceRecoveryAttribute, and * ec2:RecoverInstances for alarms with recover actions. *

    *
  • *
*

* If you have read/write permissions for Amazon CloudWatch but not for * Amazon EC2, you can still create an alarm but the stop or terminate * actions won't be performed on the Amazon EC2 instance. However, if you * are later granted permission to use the associated Amazon EC2 APIs, the * alarm actions you created earlier will be performed. For more information * about IAM permissions, see Permissions and Policies in Using IAM. *

*

* If you are using an IAM role (e.g., an Amazon EC2 instance profile), you * cannot stop or terminate the instance using alarm actions. However, you * can still see the alarm state and perform any other actions such as * Amazon SNS notifications or Auto Scaling policies. *

*

* If you are using temporary security credentials granted using the AWS * Security Token Service (AWS STS), you cannot stop or terminate an Amazon * EC2 instance using alarm actions. *

*
* * @param putMetricAlarmRequest * Describes the inputs for PutMetricAlarm. * @return A Java Future containing the result of the PutMetricAlarm * operation returned by the service. * @sample AmazonCloudWatchAsync.PutMetricAlarm */ java.util.concurrent.Future putMetricAlarmAsync( PutMetricAlarmRequest putMetricAlarmRequest); /** *

* Creates or updates an alarm and associates it with the specified Amazon * CloudWatch metric. Optionally, this operation can associate one or more * Amazon SNS resources with the alarm. *

*

* When this operation creates an alarm, the alarm state is immediately set * to INSUFFICIENT_DATA. The alarm is evaluated and its * StateValue is set appropriately. Any actions associated with * the StateValue are then executed. *

* *

* When updating an existing alarm, its StateValue is left * unchanged, but it completely overwrites the alarm's previous * configuration. *

*
*

* If you are using an AWS Identity and Access Management (IAM) account to * create or modify an alarm, you must have the following Amazon EC2 * permissions: *

*
    *
  • *

    * ec2:DescribeInstanceStatus and * ec2:DescribeInstances for all alarms on Amazon EC2 instance * status metrics. *

    *
  • *
  • *

    * ec2:StopInstances for alarms with stop actions. *

    *
  • *
  • *

    * ec2:TerminateInstances for alarms with terminate actions. *

    *
  • *
  • *

    * ec2:DescribeInstanceRecoveryAttribute, and * ec2:RecoverInstances for alarms with recover actions. *

    *
  • *
*

* If you have read/write permissions for Amazon CloudWatch but not for * Amazon EC2, you can still create an alarm but the stop or terminate * actions won't be performed on the Amazon EC2 instance. However, if you * are later granted permission to use the associated Amazon EC2 APIs, the * alarm actions you created earlier will be performed. For more information * about IAM permissions, see Permissions and Policies in Using IAM. *

*

* If you are using an IAM role (e.g., an Amazon EC2 instance profile), you * cannot stop or terminate the instance using alarm actions. However, you * can still see the alarm state and perform any other actions such as * Amazon SNS notifications or Auto Scaling policies. *

*

* If you are using temporary security credentials granted using the AWS * Security Token Service (AWS STS), you cannot stop or terminate an Amazon * EC2 instance using alarm actions. *

*
* * @param putMetricAlarmRequest * Describes the inputs for PutMetricAlarm. * @param 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. * @return A Java Future containing the result of the PutMetricAlarm * operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.PutMetricAlarm */ java.util.concurrent.Future putMetricAlarmAsync( PutMetricAlarmRequest putMetricAlarmRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Publishes metric data points to Amazon CloudWatch. Amazon CloudWatch * associates the data points with the specified metric. If the specified * metric does not exist, Amazon CloudWatch creates the metric. When Amazon * CloudWatch creates a metric, it can take up to fifteen minutes for the * metric to appear in calls to ListMetrics. *

*

* Each PutMetricData request is limited to 8 KB in size for * HTTP GET requests and is limited to 40 KB in size for HTTP POST requests. *

* *

* Although the Value parameter accepts numbers of type * Double, Amazon CloudWatch rejects values that are either too * small or too large. Values must be in the range of 8.515920e-109 to * 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2). In addition, special * values (e.g., NaN, +Infinity, -Infinity) are not supported. *

*
*

* Data that is timestamped 24 hours or more in the past may take in excess * of 48 hours to become available from submission time using * GetMetricStatistics. *

* * @param putMetricDataRequest * Describes the inputs for PutMetricData. * @return A Java Future containing the result of the PutMetricData * operation returned by the service. * @sample AmazonCloudWatchAsync.PutMetricData */ java.util.concurrent.Future putMetricDataAsync( PutMetricDataRequest putMetricDataRequest); /** *

* Publishes metric data points to Amazon CloudWatch. Amazon CloudWatch * associates the data points with the specified metric. If the specified * metric does not exist, Amazon CloudWatch creates the metric. When Amazon * CloudWatch creates a metric, it can take up to fifteen minutes for the * metric to appear in calls to ListMetrics. *

*

* Each PutMetricData request is limited to 8 KB in size for * HTTP GET requests and is limited to 40 KB in size for HTTP POST requests. *

* *

* Although the Value parameter accepts numbers of type * Double, Amazon CloudWatch rejects values that are either too * small or too large. Values must be in the range of 8.515920e-109 to * 1.174271e+108 (Base 10) or 2e-360 to 2e360 (Base 2). In addition, special * values (e.g., NaN, +Infinity, -Infinity) are not supported. *

*
*

* Data that is timestamped 24 hours or more in the past may take in excess * of 48 hours to become available from submission time using * GetMetricStatistics. *

* * @param putMetricDataRequest * Describes the inputs for PutMetricData. * @param 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. * @return A Java Future containing the result of the PutMetricData * operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.PutMetricData */ java.util.concurrent.Future putMetricDataAsync( PutMetricDataRequest putMetricDataRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Temporarily sets the state of an alarm for testing purposes. When the * updated StateValue differs from the previous value, the * action configured for the appropriate state is invoked. For example, if * your alarm is configured to send an Amazon SNS message when an alarm is * triggered, temporarily changing the alarm's state to ALARM sends * an Amazon SNS message. The alarm returns to its actual state (often * within seconds). Because the alarm state change happens very quickly, it * is typically only visible in the alarm's History tab in the Amazon * CloudWatch console or through DescribeAlarmHistory. *

* * @param setAlarmStateRequest * Describes the inputs for SetAlarmState. * @return A Java Future containing the result of the SetAlarmState * operation returned by the service. * @sample AmazonCloudWatchAsync.SetAlarmState */ java.util.concurrent.Future setAlarmStateAsync( SetAlarmStateRequest setAlarmStateRequest); /** *

* Temporarily sets the state of an alarm for testing purposes. When the * updated StateValue differs from the previous value, the * action configured for the appropriate state is invoked. For example, if * your alarm is configured to send an Amazon SNS message when an alarm is * triggered, temporarily changing the alarm's state to ALARM sends * an Amazon SNS message. The alarm returns to its actual state (often * within seconds). Because the alarm state change happens very quickly, it * is typically only visible in the alarm's History tab in the Amazon * CloudWatch console or through DescribeAlarmHistory. *

* * @param setAlarmStateRequest * Describes the inputs for SetAlarmState. * @param 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. * @return A Java Future containing the result of the SetAlarmState * operation returned by the service. * @sample AmazonCloudWatchAsyncHandler.SetAlarmState */ java.util.concurrent.Future setAlarmStateAsync( SetAlarmStateRequest setAlarmStateRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); }




© 2015 - 2025 Weber Informatics LLC | Privacy Policy