Získání metrik využití virtuálních počítačů pomocí rozhraní REST API

Článek
08/24/2024

Platí pro: ✔️ Flexibilní škálovací sady virtuálních počítačů s Linuxem ✔️

Tento příklad ukazuje, jak načíst využití procesoru pro virtuální počítač s Linuxem pomocí rozhraní Azure REST API.

Kompletní referenční dokumentace a ukázky pro rozhraní REST API jsou k dispozici v referenčním článku k rozhraní REST služby Azure Monitor.

Sestavení požadavku

Pomocí následujícího požadavku GET shromážděte metriku procent procesoru z virtuálního počítače.

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

Záhlaví žádosti

Jsou vyžadovány následující hlavičky:

Hlavička požadavku	Popis
Content-Type (Typ obsahu):	Povinný: Nastavte na `application/json`.
Autorizace:	Povinný: Nastavte na platný přístupový token `Bearer`.

Parametry identifikátoru URI

Název	Popis
subscriptionId	ID předplatného, které identifikuje předplatné Azure. Pokud máte více předplatných, přečtěte si téma Práce s více předplatnými.
resourceGroupName	Název skupiny prostředků Azure přidružené k prostředku. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru, rozhraní příkazového řádku nebo portálu.
název virtuálního počítače	Název virtuálního počítače Azure.
Názvy metrik	Čárkami oddělený seznam platných metrik Load Balanceru
verze-api	Verze rozhraní API, která se má použít pro požadavek. Tento dokument popisuje verzi `2018-01-01`rozhraní API, která je součástí výše uvedené adresy URL.
timespan	Řetězec s následujícím formátem `startDateTime_ISO/endDateTime_ISO` , který definuje časový rozsah vrácených metrik. Tento volitelný parametr je nastavený tak, aby v příkladu vrátil data za den.

Text požadavku

Pro tuto operaci není potřeba žádný text požadavku.

Zpracování odpovědi

Stavový kód 200 se vrátí, když se úspěšně vrátí seznam hodnot metriky. Úplný seznam kódů chyb je k dispozici v referenční dokumentaci.

Příklad odpovědi

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

Sdílet prostřednictvím