com.amazonaws.services.cloudwatch.AmazonCloudWatchAsync Maven / Gradle / Ivy
Show all versions of aws-android-sdk-cloudwatch Show documentation
/*
* Copyright 2010-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 java.util.concurrent.Future;
import com.amazonaws.AmazonClientException;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.handlers.AsyncHandler;
import com.amazonaws.services.cloudwatch.model.*;
/**
* Interface for accessing Amazon CloudWatch asynchronously.
*
* 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
* @return A Java Future object containing the response from the
* DeleteAlarms service method, as returned by Amazon CloudWatch.
* @throws ResourceNotFoundException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future deleteAlarmsAsync(DeleteAlarmsRequest deleteAlarmsRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Deletes all specified alarms. In the event of an error, no alarms are
* deleted.
*
*
* @param deleteAlarmsRequest
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* DeleteAlarms service method, as returned by Amazon CloudWatch.
* @throws ResourceNotFoundException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future deleteAlarmsAsync(DeleteAlarmsRequest deleteAlarmsRequest,
AsyncHandler asyncHandler) throws AmazonServiceException,
AmazonClientException;
/**
*
* 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
* @return A Java Future object containing the response from the
* DescribeAlarmHistory service method, as returned by Amazon
* CloudWatch.
* @throws InvalidNextTokenException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future describeAlarmHistoryAsync(
DescribeAlarmHistoryRequest describeAlarmHistoryRequest) throws AmazonServiceException,
AmazonClientException;
/**
*
* 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
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* DescribeAlarmHistory service method, as returned by Amazon
* CloudWatch.
* @throws InvalidNextTokenException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future describeAlarmHistoryAsync(
DescribeAlarmHistoryRequest describeAlarmHistoryRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* 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
* @return A Java Future object containing the response from the
* DescribeAlarms service method, as returned by Amazon CloudWatch.
* @throws InvalidNextTokenException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future describeAlarmsAsync(DescribeAlarmsRequest describeAlarmsRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* 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
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* DescribeAlarms service method, as returned by Amazon CloudWatch.
* @throws InvalidNextTokenException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future describeAlarmsAsync(DescribeAlarmsRequest describeAlarmsRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves all alarms for a single metric. Specify a statistic, period, or
* unit to filter the set of alarms further.
*
*
* @param describeAlarmsForMetricRequest
* @return A Java Future object containing the response from the
* DescribeAlarmsForMetric service method, as returned by Amazon
* CloudWatch.
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future describeAlarmsForMetricAsync(
DescribeAlarmsForMetricRequest describeAlarmsForMetricRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Retrieves all alarms for a single metric. Specify a statistic, period, or
* unit to filter the set of alarms further.
*
*
* @param describeAlarmsForMetricRequest
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* DescribeAlarmsForMetric service method, as returned by Amazon
* CloudWatch.
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future describeAlarmsForMetricAsync(
DescribeAlarmsForMetricRequest describeAlarmsForMetricRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* 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 object containing the response from the
* DisableAlarmActions service method, as returned by Amazon
* CloudWatch.
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future disableAlarmActionsAsync(DisableAlarmActionsRequest disableAlarmActionsRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* 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
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* DisableAlarmActions service method, as returned by Amazon
* CloudWatch.
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future disableAlarmActionsAsync(DisableAlarmActionsRequest disableAlarmActionsRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Enables actions for the specified alarms.
*
*
* @param enableAlarmActionsRequest
* @return A Java Future object containing the response from the
* EnableAlarmActions service method, as returned by Amazon
* CloudWatch.
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future enableAlarmActionsAsync(EnableAlarmActionsRequest enableAlarmActionsRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Enables actions for the specified alarms.
*
*
* @param enableAlarmActionsRequest
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* EnableAlarmActions service method, as returned by Amazon
* CloudWatch.
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future enableAlarmActionsAsync(EnableAlarmActionsRequest enableAlarmActionsRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* 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. 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
* @return A Java Future object containing the response from the
* GetMetricStatistics service method, as returned by Amazon
* CloudWatch.
* @throws InvalidParameterValueException
* @throws MissingRequiredParameterException
* @throws InvalidParameterCombinationException
* @throws InternalServiceException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future getMetricStatisticsAsync(
GetMetricStatisticsRequest getMetricStatisticsRequest) throws AmazonServiceException,
AmazonClientException;
/**
*
* 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. 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
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* GetMetricStatistics service method, as returned by Amazon
* CloudWatch.
* @throws InvalidParameterValueException
* @throws MissingRequiredParameterException
* @throws InvalidParameterCombinationException
* @throws InternalServiceException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future getMetricStatisticsAsync(
GetMetricStatisticsRequest getMetricStatisticsRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* 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 the PutMetricData action, allow up to fifteen
* minutes for the metric to appear in calls to the ListMetrics
* action. Statistics about the metric, however, are available sooner using
* GetMetricStatistics.
*
* @param listMetricsRequest
* @return A Java Future object containing the response from the ListMetrics
* service method, as returned by Amazon CloudWatch.
* @throws InternalServiceException
* @throws InvalidParameterValueException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future listMetricsAsync(ListMetricsRequest listMetricsRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* 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 the PutMetricData action, allow up to fifteen
* minutes for the metric to appear in calls to the ListMetrics
* action. Statistics about the metric, however, are available sooner using
* GetMetricStatistics.
*
* @param listMetricsRequest
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the ListMetrics
* service method, as returned by Amazon CloudWatch.
* @throws InternalServiceException
* @throws InvalidParameterValueException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future listMetricsAsync(ListMetricsRequest listMetricsRequest,
AsyncHandler asyncHandler)
throws AmazonServiceException, AmazonClientException;
/**
*
* Creates or updates an alarm and associates it with the specified Amazon
* CloudWatch metric. Optionally, this operation can associate one or more
* Amazon Simple Notification Service 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 is then executed.
*
* When updating an existing alarm, its StateValue is
* left unchanged. 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
* @return A Java Future object containing the response from the
* PutMetricAlarm service method, as returned by Amazon CloudWatch.
* @throws LimitExceededException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future putMetricAlarmAsync(PutMetricAlarmRequest putMetricAlarmRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Creates or updates an alarm and associates it with the specified Amazon
* CloudWatch metric. Optionally, this operation can associate one or more
* Amazon Simple Notification Service 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 is then executed.
*
* When updating an existing alarm, its StateValue is
* left unchanged. 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
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* PutMetricAlarm service method, as returned by Amazon CloudWatch.
* @throws LimitExceededException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future putMetricAlarmAsync(PutMetricAlarmRequest putMetricAlarmRequest,
AsyncHandler asyncHandler) throws AmazonServiceException,
AmazonClientException;
/**
*
* 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 the ListMetrics action.
*
*
* 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
* @return A Java Future object containing the response from the
* PutMetricData service method, as returned by Amazon CloudWatch.
* @throws InvalidParameterValueException
* @throws MissingRequiredParameterException
* @throws InvalidParameterCombinationException
* @throws InternalServiceException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future putMetricDataAsync(PutMetricDataRequest putMetricDataRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* 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 the ListMetrics action.
*
*
* 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
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* PutMetricData service method, as returned by Amazon CloudWatch.
* @throws InvalidParameterValueException
* @throws MissingRequiredParameterException
* @throws InvalidParameterCombinationException
* @throws InternalServiceException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future putMetricDataAsync(PutMetricDataRequest putMetricDataRequest,
AsyncHandler asyncHandler) throws AmazonServiceException,
AmazonClientException;
/**
*
* Temporarily sets the state of an alarm. 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 will
* send an Amazon SNS message. This is not a permanent change. The next
* periodic alarm check (in about a minute) will set the alarm to its actual
* state. Because the alarm state change happens very quickly, it is
* typically only visibile in the alarm's History tab in the Amazon
* CloudWatch console or through DescribeAlarmHistory.
*
*
* @param setAlarmStateRequest
* @return A Java Future object containing the response from the
* SetAlarmState service method, as returned by Amazon CloudWatch.
* @throws ResourceNotFoundException
* @throws InvalidFormatException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future setAlarmStateAsync(SetAlarmStateRequest setAlarmStateRequest)
throws AmazonServiceException, AmazonClientException;
/**
*
* Temporarily sets the state of an alarm. 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 will
* send an Amazon SNS message. This is not a permanent change. The next
* periodic alarm check (in about a minute) will set the alarm to its actual
* state. Because the alarm state change happens very quickly, it is
* typically only visibile in the alarm's History tab in the Amazon
* CloudWatch console or through DescribeAlarmHistory.
*
*
* @param setAlarmStateRequest
* @param asyncHandler Asynchronous callback handler for events in the
* life-cycle of the request. Users could provide the
* implementation of the four callback methods in this interface
* to process the operation result or handle the exception.
* @return A Java Future object containing the response from the
* SetAlarmState service method, as returned by Amazon CloudWatch.
* @throws ResourceNotFoundException
* @throws InvalidFormatException
* @throws AmazonClientException If any internal errors are encountered
* inside the client while attempting to make the request or
* handle the response. For example if a network connection is
* not available.
* @throws AmazonServiceException If an error response is returned by Amazon
* CloudWatch indicating either a problem with the data in the
* request, or a server side issue.
*/
Future setAlarmStateAsync(SetAlarmStateRequest setAlarmStateRequest,
AsyncHandler asyncHandler) throws AmazonServiceException,
AmazonClientException;
}