Abrufen von Metriken zur Load Balancer-Nutzung über die Azure REST-API

  • Artikel

Erfassen Sie die Anzahl der Bytes, die von einem Load Balancer Standard für ein Zeitintervall mithilfe der Azure REST-API verarbeitet werden.

Eine vollständige Dokumentation und mehr Beispiele für die REST-API finden Sie in der Azure Monitor-REST-Referenz.

Erstellen der Anforderung

Verwenden Sie die folgende GET-Anforderung zum Sammeln der ByteCount-Metrik von einem 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

Anforderungsheader

Die folgenden Header sind erforderlich:

Anforderungsheader BESCHREIBUNG
Content-Type: Erforderlich. Legen Sie diese Option auf application/json fest.
Authorization: Erforderlich. Legen Sie diese Option auf ein gültiges BearerZugriffstoken fest.

URI-Parameter

Name BESCHREIBUNG
subscriptionId Abonnement-ID für ein Azure-Abonnement. Wenn Sie über mehrere Abonnements verfügen, lesen Sie Verwenden mehrerer Abonnements:
resourceGroupName Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure Resource Manager-API, Befehlszeilenschnittstelle oder das Portal abgerufen werden.
loadBalancerName Der Azure Load Balancer-Name.
Metriknamen Durch Trennzeichen getrennte Liste der gültigen Load Balancer-Metriken.
api-version API-Version, die für die Anforderung verwendet werden soll.

In diesem Dokument wird API-Version 2018-01-01 behandelt, die in der obigen URL enthalten ist.
Zeitraum Die Zeitspanne der Abfrage. Es handelt sich um eine Zeichenfolge mit dem folgenden Format startDateTime_ISO/endDateTime_ISO. Dieser optionale Parameter ist im Beispiel zum Zurückgeben eines gesamten Tages an Daten festgelegt.
   

Anforderungstext

Für diesen Vorgang ist kein Anforderungskörper erforderlich.

Verarbeiten der Antwort

Wenn die Liste der Metrikwerte erfolgreich zurückgegeben wird, wird der Statuscode 200 zurückgegeben. Eine vollständige Liste der Fehlercodes finden Sie in der Referenzdokumentation.

Beispielantwort

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