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
<a name="CloudWatch-PromQL-API-GetLabels"></a>

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

Verbi HTTP validi  
`GET`, `POST` per`/api/v1/labels`.  
`GET`per`/api/v1/label/{{label_name}}/values`.

URI validi  
`/api/v1/labels`— restituisce l'elenco dei nomi delle etichette.  
`/api/v1/label/{{label_name}}/values`— restituisce l'elenco di valori per l'etichetta specificata.

L'URL completo della richiesta combina l'host di CloudWatch monitoraggio per la AWS regione con il percorso dell'operazione, ad esempio`https://monitoring.{{AWS Region}}.amazonaws.com/api/v1/labels`. Per informazioni sugli endpoint, sulla firma e sulle autorizzazioni IAM richieste, consulta. [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md)

## Parametri di interrogazione URL
<a name="CloudWatch-PromQL-API-GetLabels-Parameters"></a>

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`


| Parametro | Si applica a | Description | 
| --- | --- | --- | 
| `match[]` | Entrambi | Opzionale. Un selettore di serie che limita le serie da prendere in considerazione nel calcolo del risultato. I selettori supportano exact match (`=`), not equal (`!=`), regex match (`=~`) e regex match () negativo. `!~` Specificate `match[]` una o più volte per combinare i selettori. Per ulteriori informazioni sulla sintassi dei selettori, vedere. [Interrogazione ProMQL](CloudWatch-PromQL-Querying.md) | 
| `start` | Entrambi | Opzionale. Inizio dell'intervallo di tempo da considerare, come timestamp RFC 3339 o timestamp Unix. | 
| `end` | Entrambi | Opzionale. Fine dell'intervallo di tempo da considerare, come timestamp RFC 3339 o timestamp Unix. | 
| `limit` | Entrambi | Opzionale. Numero massimo di etichette univoche da restituire, da a. `1` `10000` Se non si specifica`limit`, CloudWatch restituisce fino al massimo (10.000). Per informazioni, consulta [Limite di risultati](#CloudWatch-PromQL-API-GetLabels-Limits). | 

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

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

Per la mappatura completa delle azioni IAM per tutte le operazioni PromQL, consulta. [Autorizzazioni IAM per PromQL](CloudWatch-PromQL.md#CloudWatch-PromQL-IAM)

## Limite di risultati
<a name="CloudWatch-PromQL-API-GetLabels-Limits"></a>

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` a`10000`. Se non lo specifichi`limit`, 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](CloudWatch-PromQL.md#CloudWatch-PromQL-Limits)

## Esempi di richieste
<a name="CloudWatch-PromQL-API-GetLabels-Sample"></a>

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 con`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'
```

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 con`awscurl`:

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

## Esempi di risposte
<a name="CloudWatch-PromQL-API-GetLabels-Response"></a>

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