/// <summary>
/// <para> Gets statistics for the specified metric. </para> <para> The maximum number of data points returned from a single
/// <c>GetMetricStatistics</c> request is 1,440, wereas the maximum number of data points that can be queried is 50,850. 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. </para>
/// <para> Amazon CloudWatch aggregates data points based on the length of the <c>period</c> 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. </para> <para> The following examples show
/// various statistics allowed by the data point query maximum of 50,850 when you call <c>GetMetricStatistics</c> on Amazon EC2 instances with
/// detailed (one-minute) monitoring enabled: </para>
/// <ul>
/// <li>Statistics for up to 400 instances for a span of one hour</li>
/// <li>Statistics for up to 35 instances over a span of 24 hours</li>
/// <li>Statistics for up to 2 instances over a span of 2 weeks</li>
///
/// </ul>
/// <para> For information about the namespace, metric names, and dimensions that other Amazon Web Services products use to send metrics to
/// Cloudwatch, go to <a href="http://docs.aws.amazon.com/AmazonCloudWatch/latest/DeveloperGuide/CW_Support_For_AWS.html">Amazon CloudWatch
/// Metrics, Namespaces, and Dimensions Reference</a> in the <i>Amazon CloudWatch Developer Guide</i> .
/// </para>
/// </summary>
///
/// <param name="getMetricStatisticsRequest">Container for the necessary parameters to execute the GetMetricStatistics service method on
/// AmazonCloudWatch.</param>
///
/// <returns>The response from the GetMetricStatistics service method, as returned by AmazonCloudWatch.</returns>
///
/// <exception cref="T:Amazon.CloudWatch.Model.InvalidParameterValueException" />
/// <exception cref="T:Amazon.CloudWatch.Model.InternalServiceException" />
/// <exception cref="T:Amazon.CloudWatch.Model.InvalidParameterCombinationException" />
/// <exception cref="T:Amazon.CloudWatch.Model.MissingRequiredParameterException" />
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
public Task <GetMetricStatisticsResponse> GetMetricStatisticsAsync(GetMetricStatisticsRequest getMetricStatisticsRequest, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new GetMetricStatisticsRequestMarshaller();
var unmarshaller = GetMetricStatisticsResponseUnmarshaller.GetInstance();
return(Invoke <IRequest, GetMetricStatisticsRequest, GetMetricStatisticsResponse>(getMetricStatisticsRequest, marshaller, unmarshaller, signer, cancellationToken));
}
IAsyncResult invokeGetMetricStatistics(GetMetricStatisticsRequest getMetricStatisticsRequest, AsyncCallback callback, object state, bool synchronized)
{
IRequest irequest = new GetMetricStatisticsRequestMarshaller().Marshall(getMetricStatisticsRequest);
var unmarshaller = GetMetricStatisticsResponseUnmarshaller.GetInstance();
AsyncResult result = new AsyncResult(irequest, callback, state, synchronized, signer, unmarshaller);
Invoke(result);
return result;
}
/// <summary>
/// <para> Gets statistics for the specified metric. </para>
/// <para><b>NOTE:</b> The maximum number of data points returned from a
/// single GetMetricStatistics request is 1,440. If a request is made that
/// generates more than 1,440 data points, Amazon CloudWatch returns an
/// error. In such a case, alter the request by narrowing the specified
/// time range or increasing the specified period. Alternatively, make
/// multiple requests across adjacent time ranges. </para> <para> Amazon
/// CloudWatch aggregates data points based on the length of the
/// <c>period</c> 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. </para> <para><b>NOTE:</b> The maximum number of data
/// points that can be queried is 50,850; whereas the maximum number of
/// data points returned is 1,440. </para> <para> The following examples
/// show various statistics allowed by the data point query maximum of
/// 50,850 when you call <c>GetMetricStatistics</c> on Amazon EC2
/// instances with detailed (one-minute) monitoring enabled: </para>
/// <ul>
/// <li>Statistics for up to 400 instances for a span of one hour</li>
/// <li>Statistics for up to 35 instances over a span of 24 hours</li>
/// <li>Statistics for up to 2 instances over a span of 2 weeks</li>
///
/// </ul>
/// </summary>
///
/// <param name="getMetricStatisticsRequest">Container for the necessary
/// parameters to execute the GetMetricStatistics service method on
/// AmazonCloudWatch.</param>
///
/// <returns>The response from the GetMetricStatistics service method, as
/// returned by AmazonCloudWatch.</returns>
///
/// <exception cref="InvalidParameterValueException"/>
/// <exception cref="InternalServiceException"/>
/// <exception cref="InvalidParameterCombinationException"/>
/// <exception cref="MissingRequiredParameterException"/>
public GetMetricStatisticsResponse GetMetricStatistics(GetMetricStatisticsRequest getMetricStatisticsRequest)
{
IRequest <GetMetricStatisticsRequest> request = new GetMetricStatisticsRequestMarshaller().Marshall(getMetricStatisticsRequest);
GetMetricStatisticsResponse response = Invoke <GetMetricStatisticsRequest, GetMetricStatisticsResponse> (request, this.signer, GetMetricStatisticsResponseUnmarshaller.GetInstance());
return(response);
}