compute
GET /v1/compute/servers/{serverId}/backups/tier
The machine's backup tier, and what upgrading would cost.
Autentizace
Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění sites.view; klíč bez něj je odmítnut s kódem 403, nikoli 404.
Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.
Vyzvednout
Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.
curl -X GET https://api.zinndigital.com/v1/compute/servers/{serverId}/backups/tier \
-H "Authorization: Bearer zdk_live_…"Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API
Podrobnosti
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.
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
serverId (path) | Uuid | Ano | 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. |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
data | ComputeBackupTier | Ano | 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… |
Chyby, které může tento koncový bod vrátit
401 · 403 · 404 · 429