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="AMP-APIReference-QueryMetrics"></a>

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

Verbes HTTP valides :  
`GET`, `POST`

Valide URIs :  
`/workspaces/{{workspaceId}}/api/v1/query` Cet URI évalue une requête instantanée à un moment donné.  
`/workspaces/{{workspaceId}}/api/v1/query_range` Cet URI évalue une requête instantanée sur une période donnée.

Paramètres de requête d’URL :  
`query=<string>` Chaîne de requête d’expression Prometheus. Utilisée à la fois dans `query` et `query_range`.  
`time=<rfc3339 | unix_timestamp>` (Facultatif) Horodatage d’évaluation si vous utilisez `query` pour une requête instantanée à un moment donné.  
`timeout=<duration>` (Facultatif) Délai d’évaluation. La valeur par défaut est définie et plafonnée par la valeur de l’indicateur `-query.timeout`. Utilisée à la fois dans `query` et `query_range`.  
`start=<rfc3339 | unix_timestamp>` Démarrez l’horodatage si vous utilisez `query_range` pour effectuer des requêtes sur un intervalle de temps.   
`end=<rfc3339 | unix_timestamp>` Arrêtez l’horodatage si vous utilisez `query_range` pour effectuer des requêtes sur un intervalle de temps.  
`step=<duration | float>` Interrogez la durée de l’étape de résolution sous forme de `duration` ou sous forme d’un nombre `float` de secondes. À utiliser uniquement si vous utilisez `query_range` pour effectuer des requêtes sur un intervalle de temps, et nécessaire pour ce type de requêtes.  
`max_samples_processed_warning_threshold=<integer>`(Facultatif) Définit le seuil d'avertissement pour les échantillons de requêtes traités (QSP). Lorsque les requêtes atteignent ce seuil, un message d'avertissement est renvoyé dans la réponse de l'API.  
`max_samples_processed_error_threshold=<integer>>`(Facultatif) Définit le seuil d'erreur pour les échantillons de requêtes traités (QSP). Les requêtes dépassant ce seuil seront rejetées avec une erreur et ne seront pas facturées. Utilisé pour éviter des coûts de requête excessifs.

**Durée**

Une `duration` dans une API compatible avec Prometheus est un nombre, suivi immédiatement 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

**Exemple de demande**

```
POST /workspaces/ws-b226cc2a-a446-46a9-933a-ac50479a5568/api/v1/query?query=sum(node_cpu_seconds_total) HTTP/1.1
Content-Length: 0, 
Authorization: AUTHPARAMS
X-Amz-Date: 20201201T193725Z
User-Agent: Grafana/8.1.0
```

**Exemple de réponse**

```
HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Length: 132
Connection: keep-alive
Date: Tue, 01 Dec 2020 19:37:25 GMT
Content-Type: application/json
Server: amazon
content-encoding: gzip

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