Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Récupérer les données métriques (GetMetricData)
<a name="metrics-classic-getdata"></a>

`GetMetricData`est l'API principale permettant de récupérer des points de données métriques classiques par programmation. Il prend en charge les requêtes par lots, les expressions mathématiques et les requêtes en un seul appel.

## Utilisation de base
<a name="metrics-classic-getdata-basic"></a>

Récupérez une seule métrique :

```
aws cloudwatch get-metric-data \
  --metric-data-queries '[
    {
      "Id": "cpu",
      "MetricStat": {
        "Metric": {
          "Namespace": "AWS/EC2",
          "MetricName": "CPUUtilization",
          "Dimensions": [{"Name": "InstanceId", "Value": "{{i-1234567890abcdef0}}"}]
        },
        "Period": 300,
        "Stat": "Average"
      }
    }
  ]' \
  --start-time $(date -u -d '1 hour ago' +%Y-%m-%dT%H:%M:%S) \
  --end-time $(date -u +%Y-%m-%dT%H:%M:%S) \
  --output json
```

## Requêtes par lots
<a name="metrics-classic-getdata-batch"></a>

Récupérez plusieurs métriques en un seul appel (jusqu'à 500 requêtes) :

```
aws cloudwatch get-metric-data \
  --metric-data-queries '[
    {"Id": "cpu", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "CPUUtilization", "Dimensions": [{"Name": "InstanceId", "Value": "{{i-abc}}"}]}, "Period": 300, "Stat": "Average"}},
    {"Id": "mem", "MetricStat": {"Metric": {"Namespace": "CWAgent", "MetricName": "mem_used_percent", "Dimensions": [{"Name": "InstanceId", "Value": "{{i-abc}}"}]}, "Period": 300, "Stat": "Average"}}
  ]' \
  --start-time 2024-01-01T00:00:00 \
  --end-time 2024-01-01T01:00:00
```

## Expressions mathématiques
<a name="metrics-classic-getdata-math"></a>

Combinez les métriques à l'aide de l'arithmétique :

```
[
  {"Id": "rx", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "NetworkIn", "Dimensions": [{"Name": "InstanceId", "Value": "{{i-abc}}"}]}, "Period": 300, "Stat": "Sum"}},
  {"Id": "tx", "MetricStat": {"Metric": {"Namespace": "AWS/EC2", "MetricName": "NetworkOut", "Dimensions": [{"Name": "InstanceId", "Value": "{{i-abc}}"}]}, "Period": 300, "Stat": "Sum"}},
  {"Id": "total", "Expression": "rx + tx", "Label": "TotalNetwork"}
]
```

## GetMetricData contre GetMetricStatistics
<a name="metrics-classic-getdata-comparison"></a>


|  | **GetMetricData** | **GetMetricStatistics** | 
| --- | --- | --- | 
| Support par lots | Jusqu'à 500 requêtes par appel | Une seule métrique par appel | 
| Expressions mathématiques | Oui | Non | 
|  queries | Oui | Non | 
| Pagination | Oui (NextToken) | Non | 
| Recommandée | Oui — API principale | Legacy — à utiliser à la GetMetricData place | 

## Tarification
<a name="metrics-classic-getdata-pricing"></a>

0,01$ par 1 000 métriques demandées via`GetMetricData`.

**Note**  
Pour les métriques OTel, utilisez l'API de Prometheus-compatible requête ou CloudWatch Query Studio avec ProMQL. `GetMetricData`n'interroge pas les métriques OTel.