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

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

Die vollständige Anforderungs-URL kombiniert beispielsweise den CloudWatch Monitoring-Host für die AWS Region mit dem Operationspfadhttps://monitoring.AWS Region.amazonaws.com/api/v1/labels. Informationen zu Endpunkten, Signierung und erforderlichen IAM-Berechtigungen finden Sie unter. PromQL abfragen

URL-Abfrageparameter

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

Erforderliche IAM-Berechtigungen

Um einen GetLabels der beiden Pfade aufrufen zu können, muss die aufrufende Identität über die folgende IAM-Aktion verfügen:

Die vollständige IAM-Aktionszuordnung für alle PromQL-Operationen finden Sie unter. IAM-Berechtigungen für PromQL

Limit für Ergebnisse

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 bis10000. Wenn Sie nichts angebenlimit, 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

Beispielanforderungen

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 mitawscurl:

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 mitawscurl:

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

Beispielantworten

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