Abrufen von VM-Nutzungsmetriken mithilfe der REST-API

Artikel
10/15/2024

Gilt für: ✔️ Linux-VMs ✔️ Flexible Skalierungsgruppen

In diesem Beispiel wird gezeigt, wie Sie die CPU-Nutzung für einen virtuellen Linux-Computer mithilfe der Azure-REST-API abrufen.

Eine vollständige Dokumentation und Beispiele für die REST-API finden Sie im Azure Monitor-REST-Referenzartikel.

Erstellen der Anforderung

Verwenden Sie die folgende GET-Anforderung zum Sammeln der prozentualen CPU-Metrik von einem virtuellen Computer.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU&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 `Bearer`-Zugriffstoken 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	Name der Azure-Ressourcengruppe, die der Ressource zugeordnet ist. Dieser Wert kann über die Azure Resource Manager-API, die Befehlszeilenschnittstelle oder das Portal abgerufen werden.
vmname	Name des virtuellen Azure-Computers.
metricnames	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	Zeichenfolge im Format `startDateTime_ISO/endDateTime_ISO`, die den Zeitraum der zurückgegebenen Metriken definiert. 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-08T23:48:10Z/2018-06-09T00:48:10Z",
    "interval": "PT1M",
    "value": [
        {
            "id": "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmname}/providers/microsoft.insights/metrics?api-version=2018-01-01&metricnames=Percentage%20CPU",
            "type": "Microsoft.Insights/metrics",
            "name": {
                "value": "Percentage CPU",
                "localizedValue": "Percentage CPU"
            },
            "unit": "Percent",
            "timeseries": [
                {
                    "metadatavalues": [],
                    "data": [
                        {
                            "timeStamp": "2018-06-08T23:48:00Z",
                            "average": 0.44
                        },
                        {
                            "timeStamp": "2018-06-08T23:49:00Z",
                            "average": 0.31
                        },
                        {
                            "timeStamp": "2018-06-08T23:50:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:51:00Z",
                            "average": 0.29
                        },
                        {
                            "timeStamp": "2018-06-08T23:52:00Z",
                            "average": 0.285
                        } ]
                } ]
        } ]
}

Freigeben über