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à.

GetLabels

L'GetLabelsoperazione restituisce i nomi delle etichette presenti nell'archivio delle metriche o restituisce i valori per un nome di etichetta specifico.

L'URL completo della richiesta combina l'host di CloudWatch monitoraggio per la AWS regione con il percorso dell'operazione, ad esempiohttps://monitoring.AWS Region.amazonaws.com/api/v1/labels. Per informazioni sugli endpoint, sulla firma e sulle autorizzazioni IAM richieste, consulta. Interrogazione ProMQL

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

Autorizzazioni IAM richieste

Per chiamare GetLabels su entrambi i percorsi, l'identità chiamante deve avere la seguente azione IAM:

Per la mappatura completa delle azioni IAM per tutte le operazioni PromQL, consulta. Autorizzazioni IAM per PromQL

Limite di risultati

Una /api/v1/label/label_name/values risposta singola /api/v1/labels o può restituire fino a 10.000 etichette. Per richiedere un numero inferiore di risultati, passa il limit parametro con un valore compreso tra 1 a10000. Se non lo specifichilimit, CloudWatch restituisce il valore massimo.

Quando le etichette 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

Esempi di richieste

Elenca tutti i nomi delle etichette con una POST richiesta e un corpo vuoto:

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

La stessa chiamata conawscurl:

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'

Elenca i nomi delle etichette che corrispondono a un selettore. Il selettore e l'intervallo di tempo vengono passati come campi codificati dal modulo nel corpo della richiesta:

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'

Elenca i valori per l'etichetta. @resource.service.name Il nome dell'etichetta fa parte del percorso dell'URL ed è codificato in percentuale (@→). %40 Questo percorso supporta solo: 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

La stessa chiamata conawscurl:

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

Esempi di risposte

Una risposta corretta utilizza la busta Prometheus JSON standard. Il data campo è una matrice di stringhe.

Risposta per/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"
    ]
}

Risposta per/api/v1/label/label_name/values:

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

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