GetMetricStatisticsRequest (AWS SDK for Android

java.lang.Object
- com.amazonaws.AmazonWebServiceRequest
- - com.amazonaws.services.cloudwatch.model.GetMetricStatisticsRequest

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable
```
public class GetMetricStatisticsRequest
extends AmazonWebServiceRequest
implements java.io.Serializable
```
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.
See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

GetMetricStatisticsRequest()

Constructors
Constructor and Description
`GetMetricStatisticsRequest()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(java.lang.Object obj)`
`java.util.List<Dimension>`	`getDimensions()` A list of dimensions describing qualities of the metric.
`java.util.Date`	`getEndTime()` The time stamp to use for determining the last datapoint to return.
`java.lang.String`	`getMetricName()` The name of the metric, with or without spaces.
`java.lang.String`	`getNamespace()` The namespace of the metric, with or without spaces.
`java.lang.Integer`	`getPeriod()` The granularity, in seconds, of the returned datapoints.
`java.util.Date`	`getStartTime()` The time stamp to use for determining the first datapoint to return.
`java.util.List<java.lang.String>`	`getStatistics()` The metric statistics to return.
`java.lang.String`	`getUnit()` The unit for the metric.
`int`	`hashCode()`
`void`	`setDimensions(java.util.Collection<Dimension> dimensions)` A list of dimensions describing qualities of the metric.
`void`	`setEndTime(java.util.Date endTime)` The time stamp to use for determining the last datapoint to return.
`void`	`setMetricName(java.lang.String metricName)` The name of the metric, with or without spaces.
`void`	`setNamespace(java.lang.String namespace)` The namespace of the metric, with or without spaces.
`void`	`setPeriod(java.lang.Integer period)` The granularity, in seconds, of the returned datapoints.
`void`	`setStartTime(java.util.Date startTime)` The time stamp to use for determining the first datapoint to return.
`void`	`setStatistics(java.util.Collection<java.lang.String> statistics)` The metric statistics to return.
`void`	`setUnit(StandardUnit unit)` The unit for the metric.
`void`	`setUnit(java.lang.String unit)` The unit for the metric.
`java.lang.String`	`toString()` Returns a string representation of this object; useful for testing and debugging.
`GetMetricStatisticsRequest`	`withDimensions(java.util.Collection<Dimension> dimensions)` A list of dimensions describing qualities of the metric.
`GetMetricStatisticsRequest`	`withDimensions(Dimension... dimensions)` A list of dimensions describing qualities of the metric.
`GetMetricStatisticsRequest`	`withEndTime(java.util.Date endTime)` The time stamp to use for determining the last datapoint to return.
`GetMetricStatisticsRequest`	`withMetricName(java.lang.String metricName)` The name of the metric, with or without spaces.
`GetMetricStatisticsRequest`	`withNamespace(java.lang.String namespace)` The namespace of the metric, with or without spaces.
`GetMetricStatisticsRequest`	`withPeriod(java.lang.Integer period)` The granularity, in seconds, of the returned datapoints.
`GetMetricStatisticsRequest`	`withStartTime(java.util.Date startTime)` The time stamp to use for determining the first datapoint to return.
`GetMetricStatisticsRequest`	`withStatistics(java.util.Collection<java.lang.String> statistics)` The metric statistics to return.
`GetMetricStatisticsRequest`	`withStatistics(java.lang.String... statistics)` The metric statistics to return.
`GetMetricStatisticsRequest`	`withUnit(StandardUnit unit)` The unit for the metric.
`GetMetricStatisticsRequest`	`withUnit(java.lang.String unit)` The unit for the metric.

Methods inherited from class com.amazonaws.AmazonWebServiceRequest
clone, getCloneRoot, getCloneSource, getGeneralProgressListener, getRequestClientOptions, getRequestCredentials, getRequestMetricCollector, setGeneralProgressListener, setRequestCredentials, setRequestMetricCollector, withGeneralProgressListener, withRequestMetricCollector

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - GetMetricStatisticsRequest
```
public GetMetricStatisticsRequest()
```
- Method Detail
  - getNamespace
```
public java.lang.String getNamespace()
```
    The namespace of the metric, with or without spaces.
    
    Constraints:
    Length: 1 - 255
    Pattern: [^:].*
    
    Returns:
    
    The namespace of the metric, with or without spaces.
  - setNamespace
```
public void setNamespace(java.lang.String namespace)
```
    The namespace of the metric, with or without spaces.
    
    Constraints:
    Length: 1 - 255
    Pattern: [^:].*
    
    Parameters:
    
    namespace -
    The namespace of the metric, with or without spaces.
  - withNamespace
```
public GetMetricStatisticsRequest withNamespace(java.lang.String namespace)
```
    The namespace of the metric, with or without spaces.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 255
    Pattern: [^:].*
    
    Parameters:
    
    namespace -
    The namespace of the metric, with or without spaces.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getMetricName
```
public java.lang.String getMetricName()
```
    The name of the metric, with or without spaces.
    
    Constraints:
    Length: 1 - 255
    
    Returns:
    
    The name of the metric, with or without spaces.
  - setMetricName
```
public void setMetricName(java.lang.String metricName)
```
    The name of the metric, with or without spaces.
    
    Constraints:
    Length: 1 - 255
    
    Parameters:
    
    metricName -
    The name of the metric, with or without spaces.
  - withMetricName
```
public GetMetricStatisticsRequest withMetricName(java.lang.String metricName)
```
    The name of the metric, with or without spaces.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 255
    
    Parameters:
    
    metricName -
    The name of the metric, with or without spaces.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getDimensions
```
public java.util.List<Dimension> getDimensions()
```
    A list of dimensions describing qualities of the metric.
    
    Returns:
    
    A list of dimensions describing qualities of the metric.
  - setDimensions
```
public void setDimensions(java.util.Collection<Dimension> dimensions)
```
    A list of dimensions describing qualities of the metric.
    
    Parameters:
    
    dimensions -
    A list of dimensions describing qualities of the metric.
  - withDimensions
```
public GetMetricStatisticsRequest withDimensions(Dimension... dimensions)
```
    A list of dimensions describing qualities of the metric.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    dimensions -
    A list of dimensions describing qualities of the metric.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - withDimensions
```
public GetMetricStatisticsRequest withDimensions(java.util.Collection<Dimension> dimensions)
```
    A list of dimensions describing qualities of the metric.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    dimensions -
    A list of dimensions describing qualities of the metric.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getStartTime
```
public java.util.Date getStartTime()
```
    The time stamp to use for determining the first datapoint to return. The value specified is inclusive; results include datapoints with the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    The specified start time is rounded down to the nearest value. Datapoints are returned for start times up to two weeks in the past. Specified start times that are more than two weeks in the past will not return datapoints for metrics that are older than two weeks.
    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.
    
    Returns:
    
    The time stamp to use for determining the first datapoint to return. The value specified is inclusive; results include datapoints with the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    The specified start time is rounded down to the nearest value. Datapoints are returned for start times up to two weeks in the past. Specified start times that are more than two weeks in the past will not return datapoints for metrics that are older than two weeks.
    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.
  - setStartTime
```
public void setStartTime(java.util.Date startTime)
```
    The time stamp to use for determining the first datapoint to return. The value specified is inclusive; results include datapoints with the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    The specified start time is rounded down to the nearest value. Datapoints are returned for start times up to two weeks in the past. Specified start times that are more than two weeks in the past will not return datapoints for metrics that are older than two weeks.
    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.
    
    Parameters:
    
    startTime -
    The time stamp to use for determining the first datapoint to return. The value specified is inclusive; results include datapoints with the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    The specified start time is rounded down to the nearest value. Datapoints are returned for start times up to two weeks in the past. Specified start times that are more than two weeks in the past will not return datapoints for metrics that are older than two weeks.
    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.
  - withStartTime
```
public GetMetricStatisticsRequest withStartTime(java.util.Date startTime)
```
    The time stamp to use for determining the first datapoint to return. The value specified is inclusive; results include datapoints with the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    The specified start time is rounded down to the nearest value. Datapoints are returned for start times up to two weeks in the past. Specified start times that are more than two weeks in the past will not return datapoints for metrics that are older than two weeks.
    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.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    startTime -
    The time stamp to use for determining the first datapoint to return. The value specified is inclusive; results include datapoints with the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    The specified start time is rounded down to the nearest value. Datapoints are returned for start times up to two weeks in the past. Specified start times that are more than two weeks in the past will not return datapoints for metrics that are older than two weeks.
    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.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getEndTime
```
public java.util.Date getEndTime()
```
    The time stamp to use for determining the last datapoint to return. The value specified is exclusive; results will include datapoints up to the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    
    Returns:
    
    The time stamp to use for determining the last datapoint to return. The value specified is exclusive; results will include datapoints up to the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
  - setEndTime
```
public void setEndTime(java.util.Date endTime)
```
    The time stamp to use for determining the last datapoint to return. The value specified is exclusive; results will include datapoints up to the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    
    Parameters:
    
    endTime -
    The time stamp to use for determining the last datapoint to return. The value specified is exclusive; results will include datapoints up to the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
  - withEndTime
```
public GetMetricStatisticsRequest withEndTime(java.util.Date endTime)
```
    The time stamp to use for determining the last datapoint to return. The value specified is exclusive; results will include datapoints up to the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    endTime -
    The time stamp to use for determining the last datapoint to return. The value specified is exclusive; results will include datapoints up to the time stamp specified. The time stamp must be in ISO 8601 UTC format (e.g., 2014-09-03T23:00:00Z).
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getPeriod
```
public java.lang.Integer getPeriod()
```
    The granularity, in seconds, of the returned datapoints. Period must be at least 60 seconds and must be a multiple of 60. The default value is 60.
    
    Constraints:
    Range: 60 -
    
    Returns:
    
    The granularity, in seconds, of the returned datapoints. Period must be at least 60 seconds and must be a multiple of 60. The default value is 60.
  - setPeriod
```
public void setPeriod(java.lang.Integer period)
```
    The granularity, in seconds, of the returned datapoints. Period must be at least 60 seconds and must be a multiple of 60. The default value is 60.
    
    Constraints:
    Range: 60 -
    
    Parameters:
    
    period -
    The granularity, in seconds, of the returned datapoints. Period must be at least 60 seconds and must be a multiple of 60. The default value is 60.
  - withPeriod
```
public GetMetricStatisticsRequest withPeriod(java.lang.Integer period)
```
    The granularity, in seconds, of the returned datapoints. Period must be at least 60 seconds and must be a multiple of 60. The default value is 60.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Range: 60 -
    
    Parameters:
    
    period -
    The granularity, in seconds, of the returned datapoints. Period must be at least 60 seconds and must be a multiple of 60. The default value is 60.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getStatistics
```
public java.util.List<java.lang.String> getStatistics()
```
    The metric statistics to return. For information about specific statistics returned by GetMetricStatistics, see Statistics in the Amazon CloudWatch Developer Guide.
    
    Returns:
    
    The metric statistics to return. For information about specific statistics returned by GetMetricStatistics, see Statistics in the Amazon CloudWatch Developer Guide.
  - setStatistics
```
public void setStatistics(java.util.Collection<java.lang.String> statistics)
```
    The metric statistics to return. For information about specific statistics returned by GetMetricStatistics, see Statistics in the Amazon CloudWatch Developer Guide.
    
    Parameters:
    
    statistics -
    The metric statistics to return. For information about specific statistics returned by GetMetricStatistics, see Statistics in the Amazon CloudWatch Developer Guide.
  - withStatistics
```
public GetMetricStatisticsRequest withStatistics(java.lang.String... statistics)
```
    The metric statistics to return. For information about specific statistics returned by GetMetricStatistics, see Statistics in the Amazon CloudWatch Developer Guide.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    statistics -
    The metric statistics to return. For information about specific statistics returned by GetMetricStatistics, see Statistics in the Amazon CloudWatch Developer Guide.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - withStatistics
```
public GetMetricStatisticsRequest withStatistics(java.util.Collection<java.lang.String> statistics)
```
    The metric statistics to return. For information about specific statistics returned by GetMetricStatistics, see Statistics in the Amazon CloudWatch Developer Guide.
    
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    
    statistics -
    The metric statistics to return. For information about specific statistics returned by GetMetricStatistics, see Statistics in the Amazon CloudWatch Developer Guide.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
  - getUnit
```
public java.lang.String getUnit()
```
    The unit for the metric.
    
    Constraints:
    Allowed Values: Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
    
    Returns:
    
    The unit for the metric.
    
    See Also:
    
    StandardUnit
  - setUnit
```
public void setUnit(java.lang.String unit)
```
    The unit for the metric.
    
    Constraints:
    Allowed Values: Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
    
    Parameters:
    
    unit -
    The unit for the metric.
    
    See Also:
    
    StandardUnit
  - withUnit
```
public GetMetricStatisticsRequest withUnit(java.lang.String unit)
```
    The unit for the metric.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Allowed Values: Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
    
    Parameters:
    
    unit -
    The unit for the metric.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
    
    See Also:
    
    StandardUnit
  - setUnit
```
public void setUnit(StandardUnit unit)
```
    The unit for the metric.
    
    Constraints:
    Allowed Values: Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
    
    Parameters:
    
    unit -
    The unit for the metric.
    
    See Also:
    
    StandardUnit
  - withUnit
```
public GetMetricStatisticsRequest withUnit(StandardUnit unit)
```
    The unit for the metric.
    
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Allowed Values: Seconds, Microseconds, Milliseconds, Bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Bits, Kilobits, Megabits, Gigabits, Terabits, Percent, Count, Bytes/Second, Kilobytes/Second, Megabytes/Second, Gigabytes/Second, Terabytes/Second, Bits/Second, Kilobits/Second, Megabits/Second, Gigabits/Second, Terabits/Second, Count/Second, None
    
    Parameters:
    
    unit -
    The unit for the metric.
    
    Returns:
    
    A reference to this updated object so that method calls can be chained together.
    
    See Also:
    
    StandardUnit
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this object; useful for testing and debugging.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    A string representation of this object.
    
    See Also:
    
    Object.toString()
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Overrides:
    
    equals in class java.lang.Object

Class GetMetricStatisticsRequest

Constructor Summary

Method Summary

Methods inherited from class com.amazonaws.AmazonWebServiceRequest

Methods inherited from class java.lang.Object

Constructor Detail

GetMetricStatisticsRequest

Method Detail

getNamespace

setNamespace

withNamespace

getMetricName

setMetricName

withMetricName

getDimensions

setDimensions

withDimensions

withDimensions

getStartTime

setStartTime

withStartTime

getEndTime

setEndTime

withEndTime

getPeriod

setPeriod

withPeriod

getStatistics

setStatistics

withStatistics

withStatistics

getUnit

setUnit

withUnit

setUnit

withUnit

toString

hashCode

equals