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.

# GetLabels
<a name="CloudWatch-PromQL-API-GetLabels"></a>

Der `GetLabels` Vorgang gibt Labelnamen zurück, die im Metrikspeicher vorhanden sind, oder gibt die Werte für einen bestimmten Labelnamen zurück.

Gültige HTTP-Verben  
`GET`, `POST` für`/api/v1/labels`.  
`GET`für`/api/v1/label/{{label_name}}/values`.

Gültige URIs  
`/api/v1/labels`— gibt die Liste der Labelnamen zurück.  
`/api/v1/label/{{label_name}}/values`— gibt die Werteliste für das angegebene Label zurück.

Die vollständige Anforderungs-URL kombiniert beispielsweise den CloudWatch Monitoring-Host für die AWS Region mit dem Operationspfad`https://monitoring.{{AWS Region}}.amazonaws.com/api/v1/labels`. Informationen zu Endpunkten, Signierung und erforderlichen IAM-Berechtigungen finden Sie unter. [PromQL abfragen](CloudWatch-PromQL-Querying.md)

## URL-Abfrageparameter
<a name="CloudWatch-PromQL-API-GetLabels-Parameters"></a>

Die folgenden Parameter werden in der URL-Abfragezeichenfolge für `GET` Anfragen oder als formularkodierte Textfelder für Anfragen übergeben. `POST`


| Parameter | Gilt für | Description | 
| --- | --- | --- | 
| `match[]` | beides | Optional. Ein Serienselektor, der einschränkt, welche Serien bei der Berechnung des Ergebnisses berücksichtigt werden. Selektoren unterstützen Exact Match (`=`), 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` | beides | Optional. Beginn des zu berücksichtigenden Zeitbereichs als RFC 3339-Zeitstempel oder Unix-Zeitstempel. | 
| `end` | beides | Optional. Ende des zu berücksichtigenden Zeitbereichs, als RFC 3339-Zeitstempel oder Unix-Zeitstempel. | 
| `limit` | beides | Optional. Maximale Anzahl eindeutiger Labels, 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-GetLabels-Limits). | 

## Erforderliche IAM-Berechtigungen
<a name="CloudWatch-PromQL-API-GetLabels-IAM"></a>

Um einen `GetLabels` der beiden Pfade aufrufen zu können, muss die aufrufende Identität ü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
<a name="CloudWatch-PromQL-API-GetLabels-Limits"></a>

Eine einzelne `/api/v1/label/{{label_name}}/values` Antwort `/api/v1/labels` oder eine Antwort kann bis zu **10.000 Etiketten** 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 passenden Beschriftungen die Obergrenze überschreiten, 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
<a name="CloudWatch-PromQL-API-GetLabels-Sample"></a>

Listet alle Labelnamen mit einer `POST` Anfrage und einem leeren Text auf:

```
POST /api/v1/labels HTTP/1.1
Host: monitoring.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: AUTHPARAMS
X-Amz-Date: 20260605T193725Z
User-Agent: awscurl/0.36
```

Derselbe Anruf mit`awscurl`:

```
awscurl --service monitoring --region us-east-1 \
    -X POST 'https://monitoring.us-east-1.amazonaws.com/api/v1/labels' \
    -H 'Content-Type: application/x-www-form-urlencoded'
```

Listet Labelnamen auf, die einem Selektor entsprechen. Der Selektor und der Zeitbereich werden als formularkodierte Felder im Hauptteil der Anfrage übergeben:

```
awscurl --service monitoring --region us-east-1 \
    -X POST 'https://monitoring.us-east-1.amazonaws.com/api/v1/labels' \
    -H 'Content-Type: application/x-www-form-urlencoded' \
    -d 'match[]={"http.server.active_requests","@aws.region"=~"us-.*"}&start=1780662000&end=1780665600'
```

Listet die Werte für das Label auf. `@resource.service.name` Der Labelname ist Teil des URL-Pfads und in Prozent kodiert (`@`→). `%40` Dieser Pfad unterstützt nur: `GET`

```
GET /api/v1/label/%40resource.service.name/values HTTP/1.1
Host: monitoring.us-east-1.amazonaws.com
Authorization: AUTHPARAMS
X-Amz-Date: 20260605T193725Z
User-Agent: awscurl/0.36
```

Derselbe Anruf mit`awscurl`:

```
awscurl --service monitoring --region us-east-1 \
    'https://monitoring.us-east-1.amazonaws.com/api/v1/label/@resource.service.name/values'
```

## Beispielantworten
<a name="CloudWatch-PromQL-API-GetLabels-Response"></a>

Eine erfolgreiche Antwort verwendet den standardmäßigen Prometheus-JSON-Envelope. Das `data` Feld ist ein Array von Zeichenketten.

Antwort für`/api/v1/labels`:

```
HTTP/1.1 200 OK
Content-Type: application/json

{
    "status": "success",
    "data": [
        "__name__",
        "@aws.account",
        "@aws.region",
        "@resource.service.name",
        "@resource.cloud.region",
        "InstanceId"
    ]
}
```

Antwort für`/api/v1/label/{{label_name}}/values`:

```
HTTP/1.1 200 OK
Content-Type: application/json

{
    "status": "success",
    "data": [
        "myservice",
        "checkout-api",
        "billing-worker"
    ]
}
```