/// <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); }