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 Enum (vm.metrics.range) Zeitraum, für den Metrikdaten abgerufen werden sollen.
aggregation Enum (vm.metrics.aggregation) Definiert, wie Metrikdaten innerhalb des gewählten Zeitraums aggregiert werden

Response (application/json) 

{
    "status": "success",
    "requestID": "6e1cc3c0-ca4a-40de-aad0-dd22139d4ee4",
    "message": "vm metrics results listed below",
    "data": {
        "timings": [
            {
                "time": 1774782360,
                "cpu_usage": 0.000323419527646875,
                "mem_usage": 3983139498.66667,
                "mem_max": 38654705664,
                "disk_read": 0,
                "disk_write": 23688.5333333333,
                "net_in": 2627.27,
                "net_out": 380.48
            },
            {
                "time": 1774782420,
                "cpu_usage": 0.0003010708469687033,
                "mem_usage": 3973005448.53333,
                "mem_max": 38654705664,
                "disk_read": 0,
                "disk_write": 22787.4133333333,
                "net_in": 2276.18333333333,
                "net_out": 258.783333333333
            },
            {
                "time": 1774782480,
                "cpu_usage": 0.000239626363372785,
                "mem_usage": 3968381337.6,
                "mem_max": 38654705664,
                "disk_read": 0,
                "disk_write": 17134.9333333333,
                "net_in": 2347.93666666667,
                "net_out": 201.243333333333
            }
        ]
    }
}

cURL

curl "https://live.fireapi.de/vm/:vmid/metrics" -X POST -H "Content-Type: application/x-www-form-urlencoded" -H "X-FIRE-APIKEY: REPLACE_API-KEY" -d "range=REPLACE_VALUE&aggregation=REPLACE_VALUE"

Anfrage testen