VM Metriken auslesen

POST /vm/:vmid/metrics

Dieser Endpunkt sollte gegenüber den /vm/:vmid/monitoring Endpunkten bevorzugt werden

URL Variablen

Name Beschreibung
vmid Identifier der VM (fünfstellige Zahl)

Body Parameter (application/x-www-form-urlencoded)

Name Format Beschreibung Optional
range Zeitraum, für den Metrikdaten abgerufen werden sollen. —
aggregation Definiert, wie Metrikdaten innerhalb des gewählten Zeitraums aggregiert werden

Response (application/json)

200 
{4 Eigenschaften
  "status": "success",
  "requestID": "6e1cc3c0-ca4a-40de-aad0-dd22139d4ee4",
  "message": "vm metrics results listed below",
  "data": {1 Eigenschaft
    "timings": [3 Elemente
      {8 Eigenschaften
        "time": 1774782360,
        "cpu_usage": 0.00032341952764688,
        "mem_usage": 3983139498.6667,
        "mem_max": 38654705664,
        "disk_read": 0,
        "disk_write": 23688.533333333,
        "net_in": 2627.27,
        "net_out": 380.48
      },
      {8 Eigenschaften
        "time": 1774782420,
        "cpu_usage": 0.0003010708469687,
        "mem_usage": 3973005448.5333,
        "mem_max": 38654705664,
        "disk_read": 0,
        "disk_write": 22787.413333333,
        "net_in": 2276.1833333333,
        "net_out": 258.78333333333
      },
      {8 Eigenschaften
        "time": 1774782480,
        "cpu_usage": 0.00023962636337279,
        "mem_usage": 3968381337.6,
        "mem_max": 38654705664,
        "disk_read": 0,
        "disk_write": 17134.933333333,
        "net_in": 2347.9366666667,
        "net_out": 201.24333333333
      }
    ]
  }
}

cURL

curl -X POST 'https://live.fireapi.de/vm/:vmid/metrics' \
  -H 'X-FIRE-APIKEY: YOUR-API-KEY' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  -d 'range=VALUE&aggregation=VALUE'