Megosztás a következőn keresztül:

Virtuálisgép-használati metrikák lekérése a REST API használatával

  • Cikk

A következőkre vonatkozik: ✔️ Linux rendszerű virtuális gépek rugalmas méretezési ✔️ csoportjai

Ez a példa bemutatja, hogyan kérhető le egy Linux rendszerű virtuális gép processzorhasználata az Azure REST API használatával.

A REST API teljes referenciadokumentációja és mintái az Azure Monitor REST referenciacikkében érhetők el.

A kérelem felépítése

A következő GET kéréssel gyűjtheti össze a százalékos CPU-metrikát egy virtuális gépről.

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

Kérésfejlécek

A következő fejlécek megadása kötelező:

Kérelem fejléce Leírás
Content-Type (Tartalomtípus): Szükséges. Állítsa application/json értékre.
Engedélyezés: Szükséges. Állítsa egy érvényes Bearer hozzáférési jogkivonatra.

URI-paraméterek

Név Leírás
subscriptionId Az Azure-előfizetést azonosító előfizetés-azonosító. Ha több előfizetéssel rendelkezik, olvassa el a Több előfizetés használata című témakört.
resourceGroupName Az erőforráshoz társított Azure-erőforráscsoport neve. Ezt az értéket az Azure Resource Manager API-ból, a parancssori felületről vagy a portálról szerezheti be.
virtuális gép neve Az Azure-beli virtuális gép neve.
metrikanevek Érvényes Load Balancer-metrikák vesszővel tagolt listája.
api-verzió A kéréshez használni kívánt API-verzió.

Ez a dokumentum a fenti URL-címben szereplő API-verziót 2018-01-01ismerteti.
időtartomány A visszaadott metrikák időtartományát meghatározó sztring az alábbi formátumban startDateTime_ISO/endDateTime_ISO . Ez az opcionális paraméter egy napi adatérték visszaadására van beállítva a példában.
   

Kérés törzse

Ehhez a művelethez nincs szükség kérelemtörzsre.

A válasz kezelése

A 200-ás állapotkód a metrikaértékek sikeres visszaadásakor lesz visszaadva. A hibakódok teljes listája elérhető a referenciadokumentációban.

Példaválasz

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