As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# QueryMetrics
<a name="AMP-APIReference-QueryMetrics"></a>

A operação `QueryMetrics` avalia uma consulta instantânea em um único momento ou em um intervalo de tempo.

Verbos HTTP válidos:  
`GET`, `POST`

Válido URIs:  
`/workspaces/{{workspaceId}}/api/v1/query` Esse URI avalia uma consulta instantânea em um único momento.  
`/workspaces/{{workspaceId}}/api/v1/query_range` Esse URI avalia uma consulta instantânea em um intervalo de tempo.

Parâmetros da consulta de URL:  
`query=<string>` Uma string de consulta da expressão Prometheus. Usado em ambos `query` e `query_range`.  
`time=<rfc3339 | unix_timestamp>` (Opcional) Carimbo de data/hora de avaliação se você estiver usando o `query` para uma consulta instantânea em um único momento.  
`timeout=<duration>` (Opcional) Tempo limite de avaliação. O padrão é e é limitado pelo valor do sinalizador `-query.timeout`. Usado em ambos `query` e `query_range`.  
`start=<rfc3339 | unix_timestamp>` Inicie o timestamp se você estiver usando `query_range` para consultar por um intervalo de tempo.   
`end=<rfc3339 | unix_timestamp>` Carimbo de data/hora de término se você estiver usando `query_range` para consultar por um intervalo de tempo.  
`step=<duration | float>` Largura da etapa de resolução da consulta em `duration` formato ou em `float` alguns segundos. Use somente se você estiver usando `query_range` para consultar por um intervalo de tempo e for necessário para essas consultas.  
`max_samples_processed_warning_threshold=<integer>` (Opcional) Define o limite de aviso para amostras de consulta processadas (QSP). Quando as consultas atingirem esse limite, uma mensagem de aviso será retornada na resposta da API.  
`max_samples_processed_error_threshold=<integer>>` (Opcional) Define o limite de erro para amostras de consulta processadas (QSP). As consultas que excederem esse limite serão rejeitadas com um erro e não serão cobradas. Usado para evitar custos excessivos de consulta.

**Duration (Duração)**

A `duration` em uma API compatível com o Prometheus é um número, seguido imediatamente por uma das seguintes unidades:
+ `ms` milissegundos
+ `s` segundos
+ `m` minutos
+ `h` horas
+ `d` dias, supondo que um dia sempre tenha 24h
+ `w` semanas, supondo que uma semana sempre tenha 7 dias
+ `y` anos, supondo que um ano sempre tenha 365 dias

**Exemplo de solicitação**

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

**Exemplo de resposta**

```
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"
                ]
            }
        ]
    }
}
```