Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# GetSeries
L'`GetSeries`operazione restituisce l'elenco delle serie temporali le cui etichette corrispondono a uno o più selettori.
Verbi HTTP validi
`GET`, `POST`
URI valido
`/api/v1/series`
L'URL completo della richiesta combina l'host di CloudWatch monitoraggio per la AWS regione con il percorso dell'operazione, ad esempio`https://monitoring.{{AWS Region}}.amazonaws.com/api/v1/series`. Per informazioni sugli endpoint, sulla firma e sulle autorizzazioni IAM richieste, consulta. [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md)
## Parametri di interrogazione URL
I seguenti parametri vengono passati nella stringa di query URL per `GET` le richieste o come campi del corpo codificati dal modulo per le richieste. `POST`
| Parametro | Description |
| --- | --- |
| `match[]` | Obbligatorio. Un selettore di serie che filtra le serie temporali da restituire. Ogni selettore deve includere una corrispondenza esatta (`=`) nel nome della metrica, ad esempio o. `{"http.server.active_requests"}` `{__name__="http.server.active_requests"}` I selettori senza un metric-name equal matcher non sono supportati. Oltre alla corrispondenza esatta, gli abbinatori di etichette supportano anche not equal (`!=`), regex match () e regex match (`=~`) negativo. `!~` Specificate `match[]` una o più volte per combinare i selettori. Per ulteriori informazioni sulla sintassi dei selettori, vedere. [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md) |
| `start` | Obbligatorio. Inizio dell'intervallo di tempo da considerare, come timestamp RFC 3339 o timestamp Unix. |
| `end` | Obbligatorio. Fine dell'intervallo di tempo da considerare, come timestamp RFC 3339 o timestamp Unix. |
| `limit` | Opzionale. Numero massimo di serie temporali univoche da restituire, da a. `1` `10000` Se non si specifica`limit`, CloudWatch restituisce fino al massimo (10.000). Per informazioni, consulta [Limite di risultati](#CloudWatch-PromQL-API-GetSeries-Limits). |
## Autorizzazioni IAM richieste
Per chiamare`GetSeries`, l'identità chiamante deve avere la seguente azione IAM:
+ `cloudwatch:ListMetrics`
Per la mappatura completa delle azioni IAM per tutte le operazioni PromQL, consulta. [Autorizzazioni IAM per PromQL](CloudWatch-PromQL.md#CloudWatch-PromQL-IAM)
## Limite di risultati
Una singola `/api/v1/series` risposta può restituire fino a **10.000 serie temporali uniche**. Per richiedere un numero inferiore di risultati, passa il `limit` parametro con un valore compreso tra `1` a`10000`. Se non lo specifichi`limit`, CloudWatch restituisce il valore massimo.
Quando le serie corrispondenti superano il limite, la risposta viene troncata e viene incluso un messaggio nel campo standard Prometheus. `warnings` Il codice di stato HTTP rimane. `200`
Per l'elenco completo dei limiti di PromQL, inclusi TPS, concorrenza e finestre di scansione 24 ore su 24, consulta. [Limiti e restrizioni di PromQL](CloudWatch-PromQL.md#CloudWatch-PromQL-Limits)
## Esempi di richieste
La `POST` richiesta seguente utilizza un selettore di corrispondenza esatta. Il selettore`start`, e `end` vengono passati come campi codificati dal modulo nel corpo della richiesta. I caratteri speciali come`{`,, e sono codificati `}` in `"` percentuale. `,` Il valore `match[]` decodificato è. `{"http.server.active_requests","@resource.service.name"="myservice"}`
```
POST /api/v1/series 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
match%5B%5D=%7B%22http.server.active_requests%22%2C%22%40resource.service.name%22%3D%22myservice%22%7D&start=1780662000&end=1780665600
```
La `POST` richiesta seguente utilizza un selettore di corrispondenza regex. Il valore decodificato è. `match[]` `{"http.server.active_requests","@aws.region"=~"us-.*"}`
```
POST /api/v1/series 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
match%5B%5D=%7B%22http.server.active_requests%22%2C%22%40aws.region%22%3D~%22us-.*%22%7D&start=1780662000&end=1780665600
```
La stessa chiamata con`awscurl`:
```
awscurl --service monitoring --region us-east-1 \
-X POST 'https://monitoring.us-east-1.amazonaws.com/api/v1/series' \
-H 'Content-Type: application/x-www-form-urlencoded' \
-d 'match[]={"http.server.active_requests","@aws.region"=~"us-.*"}&start=1780662000&end=1780665600'
```
## Risposta di esempio
Una risposta corretta utilizza la busta Prometheus JSON standard. Il `data` campo è una serie di mappe di etichette, una per serie corrispondente.
```
HTTP/1.1 200 OK
x-amzn-RequestId: 12345678-abcd-4442-b8c5-262b45e9b535
Content-Type: application/json
{
"status": "success",
"data": [
{
"__name__": "http.server.active_requests",
"@resource.service.name": "myservice",
"@aws.region": "us-east-1"
},
{
"__name__": "http.server.active_requests",
"@resource.service.name": "myservice",
"@aws.region": "us-west-2"
}
]
}
```