Udostępnij za pośrednictwem

Pobieranie metryk użycia maszyny wirtualnej przy użyciu interfejsu API REST

  • Artykuł

Dotyczy: ✔️ Maszyny wirtualne z systemem Linux — elastyczne zestawy skalowania ✔️

W tym przykładzie pokazano, jak pobrać użycie procesora CPU dla maszyny wirtualnej z systemem Linux przy użyciu interfejsu API REST platformy Azure.

Pełna dokumentacja referencyjna i przykłady dla interfejsu API REST są dostępne w artykule dokumentacja REST usługi Azure Monitor.

Tworzenie żądania

Użyj następującego żądania GET, aby zebrać metrykę Procent użycia procesora CPU z maszyny wirtualnej.

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

Nagłówki żądań

Wymagane są następujące nagłówki:

Nagłówek żądania opis
Typ zawartości: Wymagany. Ustaw wartość application/json.
Autoryzacja: Wymagany. Ustaw na prawidłowy token dostępu Bearer.

Parametry identyfikatora URI

Nazwa/nazwisko opis
subscriptionId Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure. Jeśli masz wiele subskrypcji, zobacz Praca z wieloma subskrypcjami.
resourceGroupName Nazwa grupy zasobów platformy Azure skojarzonej z zasobem. Tę wartość można uzyskać z poziomu interfejsu API, interfejsu wiersza polecenia usługi Azure Resource Manager lub portalu.
nazwa maszyny wirtualnej Nazwa maszyny wirtualnej platformy Azure.
metryki Rozdzielona przecinkami lista prawidłowych metryk modułu równoważenia obciążenia.
api-version Wersja interfejsu API do użycia dla żądania.

W tym dokumencie opisano wersję 2018-01-01interfejsu API w powyższym adresie URL.
zakres czasu Ciąg z następującym formatem startDateTime_ISO/endDateTime_ISO , który definiuje zakres czasu zwracanych metryk. Ten opcjonalny parametr jest ustawiony tak, aby zwracał dane z dnia w przykładzie.
   

Treść żądania

Do tej operacji nie jest wymagana żadna treść żądania.

Obsługa odpowiedzi

Kod stanu 200 jest zwracany, gdy lista wartości metryk zostanie zwrócona pomyślnie. Pełna lista kodów błędów jest dostępna w dokumentacji referencyjnej.

Przykładowa odpowiedź

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