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.
# GetSeries
L'`GetSeries`opération renvoie la liste des séries chronologiques dont les libellés correspondent à un ou plusieurs sélecteurs.
Verbes HTTP valides
`GET`, `POST`
URI valide
`/api/v1/series`
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/series`. 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
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 | Description |
| --- | --- |
| `match[]` | Obligatoire. Un sélecteur de séries qui filtre les séries chronologiques à renvoyer. Chaque sélecteur doit inclure une correspondance exacte (`=`) dans le nom de la métrique, par exemple, `{"http.server.active_requests"}` ou`{__name__="http.server.active_requests"}`. Les sélecteurs dont le nom de métrique correspond à un équivalent ne sont pas pris en charge. En plus de la correspondance exacte, les correcteurs d'étiquettes prennent également en charge les options not equal (`!=`), regex match (`=~`) et negative regex match (). `!~` Spécifiez `match[]` une ou plusieurs fois pour combiner les sélecteurs. Pour plus d'informations sur la syntaxe du sélecteur, consultez[Requête ProMAL](CloudWatch-PromQL-Querying.md). |
| `start` | Obligatoire. Début de la plage horaire à prendre en compte, sous forme d'horodatage RFC 3339 ou d'horodatage Unix. |
| `end` | Obligatoire. Fin de la plage de temps à prendre en compte, sous forme d'horodatage RFC 3339 ou d'horodatage Unix. |
| `limit` | Facultatif. Nombre maximum de séries chronologiques uniques à renvoyer, de `1` à`10000`. Si vous ne spécifiez pas`limit`, CloudWatch renvoie le maximum (10 000). Consultez [Limite de résultats](#CloudWatch-PromQL-API-GetSeries-Limits). |
## Autorisations IAM requises
Pour appeler`GetSeries`, l'identité appelante doit avoir l'action IAM suivante :
+ `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
Une seule `/api/v1/series` réponse peut renvoyer jusqu'à **10 000 séries chronologiques uniques**. Pour demander moins de résultats, transmettez le `limit` paramètre avec une valeur comprise entre `1` et`10000`. Si vous ne spécifiez pas`limit`, CloudWatch renvoie le 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 demandes
La `POST` requête suivante utilise un sélecteur de correspondance exacte. Les sélecteurs`start`, et `end` sont transmis sous forme de champs codés sous forme de formulaire dans le corps de la demande. Les caractères spéciaux tels que`{`, `}``"`, et `,` sont codés en pourcentage. La `match[]` valeur décodée est`{"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` requête suivante utilise un sélecteur de correspondance regex. La `match[]` valeur décodée est`{"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
```
Le même appel avec `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'
```
## Exemple de réponse
Une réponse réussie utilise l'enveloppe JSON Prometheus standard. Le `data` champ est un ensemble de cartes d'étiquettes, une par série correspondante.
```
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"
}
]
}
```