compute
GET /v1/compute/servers/{serverId}/metrics
How hard a server has worked over a window — CPU, network and disk rates.
Authentification
Envoyez une clé API en tant que jeton du porteur. La clé doit posséder l'autorisation sites.view ; une clé qui ne l'a pas est refusée avec le code 403, et non 404.
Cet endpoint ne prend aucun identifiant d'organisation. Votre clé identifie déjà l'organisation à laquelle elle appartient, et la réponse y est limitée.
Essayer
Remplacez tout ce qui se trouve entre crochets par vos propres valeurs, et le espace réservé à la clé par une clé de votre tableau de bord.
curl -X GET https://api.zinndigital.com/v1/compute/servers/{serverId}/metrics \
-H "Authorization: Bearer zdk_live_…"Connecté ? La console d'API de votre tableau de bord saisit votre véritable ID d'organisation ainsi que votre propre clé, et exécute la requête sur l'API de production afin que vous puissiez voir la réponse réelle. Ouvrir ce point de terminaison dans la console API
Détails
Read live from the provider and stored nowhere. window is one of 1h, 24h, 7d or 30d (default 24h); anything else is a 422 naming the four, never widened to the nearest. ⛔ A sample the provider did not have is null — a gap in the line, never zero. ⛔ A quantity this range does not measure is ABSENT from series, which is a different state from a series with no points. 503 on a range with no metrics history (see the compute:metrics_history capability). Requires sites.view.
Paramètres
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
serverId (path) | Uuid | Oui | The server's id, as listComputeServers reports it. Ours (UUIDv7), minted when the order row was written — never the provider's own identifier for the machine. |
window (query) | string<1h, 24h, 7d, 30d> | Non | — |
Réponse
| Nom | Type | Obligatoire | Qu'est-ce que c'est |
|---|---|---|---|
window | string<1h, 24h, 7d, 30d> | Oui | — |
step_seconds | integer | Oui | The spacing between samples, as the provider answered it. |
series | object[] | Oui | ⛔ A quantity this range does not measure is absent, not empty. |
Erreurs que cet point de terminaison peut renvoyer
401 · 403 · 404 · 422 · 429 · 503