compute
GET /v1/compute/servers/{serverId}/backups/tier
The machine's backup tier, and what upgrading would cost.
Hitelesítés
Küldjön egy API-kulcsot bearer tokenként. A kulcsnak rendelkeznie kell a(z) sites.view jogosultsággal; az ezzel nem rendelkező kulcsok esetén a rendszer 403-as hibát ad vissza 404 helyett.
Ez a végpont nem fogad el szervezeti azonosítót. Az Ön kulcsa már azonosítja azt a szervezetet, amelyhez tartozik, és a válasz is erre vonatkozik.
Próbálja ki
Cserélje ki a hegyes zárójelek közötti részt a saját értékeivel, a kulcshelyőrzőt pedig a vezérlőpultján található kulccsal.
curl -X GET https://api.zinndigital.com/v1/compute/servers/{serverId}/backups/tier \
-H "Authorization: Bearer zdk_live_…"Be van jelentkezve? A vezérlőpultban lévő API-konzol kitölti a valós szervezetazonosítóját és a saját kulcsát, és a kérést az éles API-n futtatja, hogy láthassa a tényleges választ. Nyissa meg ezt a végpontot az API konzolban
Részletek
A **pure read** — it charges nothing. `amount_minor` is our price for moving this machine to extended backups, derived from the provider's own live quote for **this** machine rather than from a published percentage: the two disagree, and the provider's figure is the one we are charged. ⛔ `upgrade_available: false` with a `reason` when the machine is already on the extended tier, is still building, or is on a range that has no tier concept — the VPS range buys backups as a separate contract instead, from `getComputeServerPlan`. Requires `sites.view`.
Paraméterek
| Név | Típus | Kötelező | Mi ez |
|---|---|---|---|
serverId (path) | Uuid | Igen | 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. |
Válasz
| Név | Típus | Kötelező | Mi ez |
|---|---|---|---|
data | ComputeBackupTier | Igen | A machine's backup tier and the price of moving it. ⛔ `tier` is the provider's own word, verbatim (`normal` / `upgraded`), because rounding it to a boolean loses the difference… |
Hibák, amelyeket ez a végpont visszaadhattatlan
401 · 403 · 404 · 429