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.

# QueryMetrics
<a name="CloudWatch-PromQL-API-QueryMetrics"></a>

L'`QueryMetrics`opération évalue une requête instantanée ProMQL à un moment donné ou évalue une requête sur une période donnée.

Verbes HTTP valides  
`GET`, `POST`

URI valides  
`/api/v1/query`— évalue une requête instantanée à un moment précis.  
`/api/v1/query_range`— évalue une requête sur une période donnée.

L'URL de demande complète combine l'hôte CloudWatch de surveillance de la AWS région avec le chemin de l'opération, par exemple`https://monitoring.{{AWS Region}}.amazonaws.com/api/v1/query`. Pour plus d'informations sur les points de terminaison, la signature et les autorisations IAM requises, consultez. [Requête ProMAL](CloudWatch-PromQL-Querying.md)

## Paramètres de requête d'URL
<a name="CloudWatch-PromQL-API-QueryMetrics-Parameters"></a>

Les paramètres suivants sont transmis dans la chaîne de requête URL pour les `GET` demandes, ou sous forme de champs de corps codés par formulaire pour `POST` les demandes.


| Paramètre | S’applique à | Description | 
| --- | --- | --- | 
| `query` | les deux | Obligatoire. Chaîne d'expression ProMQL à évaluer. L'expression doit sélectionner une métrique par son nom, par exemple, `{"http.server.active_requests"}` ou`{__name__="http.server.active_requests"}`. La sélection de séries uniquement par étiquette, sans nom de métrique, n'est pas prise en charge. | 
| `time` | `/api/v1/query` | Facultatif. Horodatage d'évaluation sous forme d'horodatage RFC 3339 ou d'horodatage Unix. La valeur par défaut est l'heure actuelle du serveur. | 
| `start` | `/api/v1/query_range` | Obligatoire. Début de la plage horaire, sous forme d'horodatage RFC 3339 ou d'horodatage Unix. | 
| `end` | `/api/v1/query_range` | Obligatoire. Fin de la plage horaire, sous forme d'horodatage RFC 3339 ou d'horodatage Unix. | 
| `step` | `/api/v1/query_range` | Obligatoire. Largeur du pas de résolution de la requête, sous `duration` forme de format ou en nombre de secondes à virgule flottante. | 
| `limit` | les deux | Facultatif. Nombre maximum de séries chronologiques uniques à renvoyer, de `1` à`500`. Si vous ne spécifiez pas`limit`, CloudWatch renvoie le maximum (500). Consultez [Limite de résultats](#CloudWatch-PromQL-API-QueryMetrics-Limits). | 

**Durée**

`duration`Dans une Prometheus-compatible API, un nombre est immédiatement suivi de l'une des unités suivantes :
+ `ms` millisecondes
+ `s` secondes
+ `m` minutes
+ `h` heures
+ `d` jours, en supposant qu’un jour compte toujours 24 heures
+ `w` semaines, en supposant qu’une semaine compte toujours 7 jours
+ `y` années, en supposant qu’une année compte toujours 365 jours

## Autorisations IAM requises
<a name="CloudWatch-PromQL-API-QueryMetrics-IAM"></a>

Pour appeler`QueryMetrics`, l'identité appelante doit comporter les deux actions IAM suivantes :
+ `cloudwatch:GetMetricData`
+ `cloudwatch:ListMetrics`

Pour le mappage complet des actions IAM pour toutes les opérations ProMQL, voir. [Autorisations IAM pour ProMQL](CloudWatch-PromQL.md#CloudWatch-PromQL-IAM)

## Limite de résultats
<a name="CloudWatch-PromQL-API-QueryMetrics-Limits"></a>

Une seule `/api/v1/query` `/api/v1/query_range` réponse peut renvoyer jusqu'à **500 séries chronologiques uniques**. Pour demander moins de résultats, transmettez le `limit` paramètre avec une valeur comprise entre `1` et`500`. Si vous ne le spécifiez pas`limit`, CloudWatch renvoie le montant maximum.

Lorsque la série correspondante dépasse le plafond, la réponse est tronquée et un message est inclus dans le champ Prometheus `warnings` standard. Le code d'état HTTP est conservé`200`.

Pour la liste complète des limites ProMQL, y compris le TPS, la simultanéité et les fenêtres de numérisation de 24 heures, voir. [Limites et restrictions de ProMQL](CloudWatch-PromQL.md#CloudWatch-PromQL-Limits)

## Exemple de demande
<a name="CloudWatch-PromQL-API-QueryMetrics-Sample"></a>

La `POST` requête suivante transmet l'expression ProMQL dans un corps codé par formulaire. Les caractères spéciaux tels que `{``}`, et `"` sont codés en pourcentage.

```
POST /api/v1/query HTTP/1.1
Host: monitoring.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Authorization: AUTHPARAMS
X-Amz-Date: 20260605T193725Z
User-Agent: awscurl/0.36

query=sum(%7B%22http.server.active_requests%22%7D)
```

Le même appel avec `awscurl` :

```
awscurl --service monitoring --region us-east-1 \
    -X POST 'https://monitoring.us-east-1.amazonaws.com/api/v1/query' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'query=sum({"http.server.active_requests"})'
```

## Exemple de réponse
<a name="CloudWatch-PromQL-API-QueryMetrics-Response"></a>

Une réponse réussie utilise l'enveloppe JSON Prometheus standard :

```
HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Type: application/json

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [
            {
                "metric": {},
                "value": [
                    1780000000.000,
                    "42"
                ]
            }
        ]
    }
}
```

Lorsque le jeu de résultats dépasse le plafond par appel, CloudWatch renvoie un `result` tableau tronqué et inclut un message dans le `warnings` champ :

```
HTTP/1.1 200 OK
Content-Type: application/json

{
    "status": "success",
    "data": {
        "resultType": "vector",
        "result": [ ... up to 500 series ... ]
    },
    "warnings": [
        "result truncated to the maximum of 500 series; refine the query or use the limit parameter"
    ]
}
```