Ottenere le metriche di utilizzo di Load Balancer usando l'API REST di Azure

Articolo
06/26/2024

Raccogliere il numero di byte elaborati da Load Balancer Standard per un intervallo di tempo usando l'API REST di Azure.

La documentazione di riferimento completa e altri esempi per l'API REST sono disponibili nelle informazioni di riferimento su REST di Monitoraggio di Azure.

Compilare la richiesta

Usare la richiesta GET seguente per raccogliere la metrica ByteCount da Load Balancer Standard.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=ByteCount&timespan=2018-06-05T03:00:00Z/2018-06-07T03:00:00Z

Intestazioni delle richieste

Gli argomenti seguenti sono obbligatori:

Intestazione della richiesta	Descrizione
Content-Type (Tipo di contenuto):	Obbligatorio. Impostare su `application/json`.
Autorizzazione:	Obbligatorio. Impostare un `Bearer` token di accesso valido.

Parametri URI

Nome	Descrizione
subscriptionId	ID sottoscrizione che identifica una sottoscrizione di Azure. Se sono disponibili più sottoscrizioni, vedere Uso di più sottoscrizioni.
resourceGroupName	Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager, dall'interfaccia della riga di comando o dal portale.
loadBalancerName	Nome di Azure Load Balancer.
nomi delle metriche	Elenco delimitato da virgole delle metriche di Load Balancer valide.
api-version	Versione dell'API da usare per la richiesta. Questo documento illustra la versione api-version `2018-01-01`, inclusa nell'URL precedente.
timespan	Intervallo di tempo della query. Si tratta di una stringa con il formato seguente `startDateTime_ISO/endDateTime_ISO`. Questo parametro facoltativo è impostato per restituire, nell'esempio, i dati relativi a un singolo giorno.

Corpo della richiesta

Per questa operazione non è necessario alcun corpo della richiesta.

Gestire la risposta

Quando l'elenco dei valori delle metriche viene restituito correttamente, viene visualizzato il codice di stato 200. La documentazione di riferimento contiene un elenco completo dei codici di errore.

Esempio di risposta

{
    "cost": 0,
    "timespan": "2018-06-05T03:00:00Z/2018-06-07T03:00:00Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/providers/Microsoft.Insights/metrics/ByteCount",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "ByteCount",
                "localizedValue": "Byte Count"
            },
            "unit": "Count",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-06T17:24:00Z",
                            "total": 1067921034.0
                        },
                        {
                            "timeStamp": "2018-06-06T17:25:00Z",
                            "total": 0.0
                        },
                        {
                            "timeStamp": "2018-06-06T17:26:00Z",
                            "total": 3781344.0
                        },
                    ]
                }
            ]
        }
    ],
    "namespace": "Microsoft.Network/loadBalancers",
    "resourceregion": "eastus"
}

Condividi tramite