# Obter as estatísticas de uma métrica (GetMetricStatistics)
<a name="getting-metric-statistics"></a>

`GetMetricStatistics` é a API legada de métrica única. Para um novo código, utilize [Recuperar dados métricos (GetMetricData)](metrics-classic-getdata.md) em vez disso; ele suporta consultas em lote e expressões matemáticas.

## Usage
<a name="getting-metric-statistics-usage"></a>

```
aws cloudwatch get-metric-statistics \
  --namespace "AWS/EC2" \
  --metric-name "CPUUtilization" \
  --dimensions Name=InstanceId,Value={{i-1234567890abcdef0}} \
  --start-time $(date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%S) \
  --end-time $(date -u +%Y-%m-%dT%H:%M:%S) \
  --period 300 \
  --statistics Average Maximum
```

## Quando usar essa API
<a name="getting-metric-statistics-when-to-use"></a>
+ Aplicações legadas que já dependem dela
+ Recuperações simples de métrica única em que o lote não é necessário

Para todo o resto, use [Recuperar dados métricos (GetMetricData)](metrics-classic-getdata.md).