# メトリクスの統計を取得する (GetMetricStatistics)
<a name="getting-metric-statistics"></a>

`GetMetricStatistics` は、レガシーの単一メトリクス API です。新しいコードを作成する場合は、代わりに [メトリクスデータの取得 (GetMetricData)](metrics-classic-getdata.md) (バッチクエリと数式をサポート) を使用します。

## 使用方法
<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
```

## この API を使用する場面
<a name="getting-metric-statistics-when-to-use"></a>
+ 既にこの API に依存しているレガシーアプリケーション
+ バッチ処理を必要としない、シンプルな単一メトリクスの取得

上記以外の場面では、[メトリクスデータの取得 (GetMetricData)](metrics-classic-getdata.md) を使用してください。