Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# GetSeries
Die `GetSeries` Operation gibt die Liste der Zeitreihen zurück, deren Beschriftungen mit einem oder mehreren Selektoren übereinstimmen.
Gültige HTTP-Verben
`GET`, `POST`
Gültiger URI
`/api/v1/series`
Die vollständige Anforderungs-URL kombiniert beispielsweise den CloudWatch Überwachungshost für die AWS Region mit dem Operationspfad`https://monitoring.{{AWS Region}}.amazonaws.com/api/v1/series`. Informationen zu Endpunkten, Signierung und erforderlichen IAM-Berechtigungen finden Sie unter. [PromQL abfragen](CloudWatch-PromQL-Querying.md)
## URL-Abfrageparameter
Die folgenden Parameter werden in der URL-Abfragezeichenfolge für `GET` Anfragen oder als formularkodierte Textfelder für Anfragen übergeben. `POST`
| Parameter | Description |
| --- | --- |
| `match[]` | Erforderlich Ein Serienselektor, der die zurückzugebende Zeitreihe filtert. Jeder Selektor muss eine exakte Übereinstimmung (`=`) mit dem Metriknamen enthalten, `{"http.server.active_requests"}` z. B. oder. `{__name__="http.server.active_requests"}` Selektoren ohne einen Gleichheitsmatcher für Metriknamen werden nicht unterstützt. Neben Exact Match unterstützen Label-Matcher auch Not Equal (`!=`), Regex Match () und Negative Regex Match (`=~`). `!~` Geben Sie `match[]` ein oder mehrere Male an, um Selektoren zu kombinieren. Weitere Hinweise zur Selektorsyntax finden Sie unter. [PromQL abfragen](CloudWatch-PromQL-Querying.md) |
| `start` | Erforderlich Beginn des zu berücksichtigenden Zeitbereichs als RFC 3339-Zeitstempel oder Unix-Zeitstempel. |
| `end` | Erforderlich Ende des zu berücksichtigenden Zeitbereichs, als RFC 3339-Zeitstempel oder Unix-Zeitstempel. |
| `limit` | Optional. Maximale Anzahl eindeutiger Zeitreihen, die zurückgegeben werden sollen, von bis. `1` `10000` Wenn Sie nichts angeben`limit`, wird bis zum Maximum (10.000) CloudWatch zurückgegeben. Siehe [Limit für Ergebnisse](#CloudWatch-PromQL-API-GetSeries-Limits). |
## Erforderliche IAM-Berechtigungen
Für einen Anruf `GetSeries` muss die Identität des Anrufers über die folgende IAM-Aktion verfügen:
+ `cloudwatch:ListMetrics`
Die vollständige IAM-Aktionszuordnung für alle PromQL-Operationen finden Sie unter. [IAM-Berechtigungen für PromQL](CloudWatch-PromQL.md#CloudWatch-PromQL-IAM)
## Limit für Ergebnisse
Eine einzelne `/api/v1/series` Antwort kann bis zu **10.000 eindeutige Zeitreihen** zurückgeben. Um weniger Ergebnisse anzufordern, übergeben Sie den `limit` Parameter mit einem Wert von `1` bis`10000`. Wenn Sie nichts angeben`limit`, wird bis zum Maximum CloudWatch zurückgegeben.
Wenn die übereinstimmende Serie die Obergrenze überschreitet, wird die Antwort gekürzt und eine Nachricht in das `warnings` Prometheus-Standardfeld aufgenommen. Der HTTP-Statuscode bleibt bestehen. `200`
Die vollständige Liste der PromQL-Grenzwerte, einschließlich TPS, Parallelität und 24-Stunden-Scanfenster, finden Sie unter. [Grenzen und Einschränkungen von PromQL](CloudWatch-PromQL.md#CloudWatch-PromQL-Limits)
## Beispielanforderungen
Die folgende `POST` Anfrage verwendet einen Exact Match Selector. Die Selektoren`start`, und `end` werden als formularkodierte Felder im Hauptteil der Anfrage übergeben. Sonderzeichen wie`{`,, und sind `}` `"` prozentcodiert. `,` Der `match[]` dekodierte Wert ist. `{"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
```
Die folgende `POST` Anfrage verwendet einen Regex-Match-Selektor. Der `match[]` dekodierte Wert ist. `{"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
```
Derselbe Anruf mit`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'
```
## Beispielantwort
Eine erfolgreiche Antwort verwendet den standardmäßigen Prometheus-JSON-Envelope. Das `data` Feld besteht aus einer Reihe von Label-Maps, eine pro übereinstimmender Serie.
```
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"
}
]
}
```