# Obtención de estadísticas para una métrica (GetMetricStatistics)
<a name="getting-metric-statistics"></a>

`GetMetricStatistics` es la API de métrica única heredada. Para el código nuevo, utilice [Recuperación de datos de métricas (GetMetricData)](metrics-classic-getdata.md) en su lugar, ya que admite consultas por lotes y expresiones matemáticas.

## Uso
<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
```

## Cuándo usar esta API
<a name="getting-metric-statistics-when-to-use"></a>
+ Aplicaciones heredadas que ya sean dependientes
+ Recuperaciones sencillas de métrica única en las que no se necesitan lotes

Para todo lo demás, use [Recuperación de datos de métricas (GetMetricData)](metrics-classic-getdata.md).