compute

POST `/v1/compute/servers/{serverId}/backups`

Turn a server's automatic backups on or off.

Autentificare

Trimiteți o cheie API ca token de tip bearer. Cheia trebuie să aibă permisiunea billing.payment.manage; o cheie care nu o are va fi respinsă cu 403, nu 404.

Acest endpoint nu necesită un ID de organizație. Cheia ta identifică deja organizația căreia îi aparține, iar răspunsul este limitat la aceasta.

Încearcă

Înlocuiți tot ce se află între paranteze unghiulare cu propriile valori și substituentul cheie cu o cheie din tabloul de bord.

curl -X POST https://api.zinndigital.com/v1/compute/servers/{serverId}/backups \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": <boolean> }'

Autentificat? Consola API din panoul de control îți completează ID-ul real al organizației și propria cheie și rulează cererea în API-ul live, astfel încât să poți vedea răspunsul efectiv. Deschideți acest punct final în consola API

Detalii

⛔⛔ **Chargeable one way and destructive the other.** Enabling costs a percentage of the machine's price for as long as it runs — a recurring change to what the customer pays. Disabling **deletes the restore points that already exist**, at the provider, with no undo anywhere. Both belong behind a confirmation that says which one is happening. The response is the arrangement **re-read from the provider**, never an echo of the request: an asynchronous write followed by an immediate synchronous read has been measured on a real machine reporting "saved" over the old value. `503` on a range whose provider exposes no verb for this — that is a permanent property of the range, not a temporary failure, and a client should render the statement rather than invite a retry. Requires `billing.payment.manage`.

Parametri

Nume	Tip	Obligatoriu	Ce este
`serverId (path)`	`Uuid`	Da	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.

Corp cerere

Nume	Tip	Obligatoriu	Ce este
`enabled`	`boolean`	Da	Whether automatic backups should run.

Răspuns

Nume	Tip	Obligatoriu	Ce este
`enabled`	`boolean`	Da	Whether the provider takes automatic backups of this machine.
`manageable`	`boolean`	Da	Whether we can change that through an API. `false` means the customer has a real backup arrangement we can describe and cannot alter — render a statement, not a switch.
`tier`	`string`	Da	The provider's own name for the tier, verbatim and untranslated, or `""`. ⛔ Never round it to a boolean: "which tier am I on" and "are backups on" are different questions, and a…
`window`	`string`	Da	The daily window backups are taken in, as stated (`"22-02"`), or `""`.
`retained`	`integer`	Da	How many restore points are kept. `null` when unknown — never `0` as a guess, because "we keep none" is a different promise.
`price_minor`	`integer`	Da	What we charge per month to keep this on, in integer minor units of `price_currency`. ⛔⛔ `null` means we cannot state a price for this machine — the truth on the resold ra…
`price_currency`	`string`	Da	ISO-4217 code for `price_minor`, or `""` exactly when that is `null`.

Erori pe care le poate returna acest punct final

401 · 403 · 404 · 422 · 429 · 503

POST /v1/compute/servers/{serverId}/backups