compute

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

Turn a server's automatic backups on or off.

ავტორიზაცია

API გასაღები გაგზავნეთ როგორც მატარებელი ტოკენი (bearer token). გასაღებს უნდა ჰქონდეს billing.payment.manage ნებართვა; ამის გარეშე გასაღები უარყოფილი იქნება 403 და არა 404 სტატუსით.

ეს ბოლო წერტილი არ იღებს ორგანიზაციის იდენტიფიკატორს. თქვენი გასაღები უკვე აიდენტიფიცირებს იმ ორგანიზაციას, რომელსაც ის ეკუთვნის, და პასუხი შემოფარგლულია მისით.

სცადეთ

შეSubstituted any value inside angle brackets with your own and the key placeholder with a key from your dashboard.

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> }'

შესული ხართ? თქვენი სამართავ პანელში არსებული API კონსოლი ავტომატურად ამატებს თქვენი რეალური ორგანიზაციის ID-სა და საკუთარ გასაღებს და ატარებს მოთხოვნას ცოცხალ API-ს წინააღმდეგ, რათა იხილოთ რეალური პასუხი. გაAღით ეს ენდპოინტი API კონსოლში

დეტალები

⛔⛔ **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`.

პარამეტრები

სახელი	ტიპი	სავალდებულო	რა არის ეს
`serverId (path)`	`Uuid`	დიახ	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.

მოთხოვნის სხეული

სახელი	ტიპი	სავალდებულო	რა არის ეს
`enabled`	`boolean`	დიახ	Whether automatic backups should run.

პასუხი

სახელი	ტიპი	სავალდებულო	რა არის ეს
`enabled`	`boolean`	დიახ	Whether the provider takes automatic backups of this machine.
`manageable`	`boolean`	დიახ	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`	დიახ	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`	დიახ	The daily window backups are taken in, as stated (`"22-02"`), or `""`.
`retained`	`integer`	დიახ	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`	დიახ	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`	დიახ	ISO-4217 code for `price_minor`, or `""` exactly when that is `null`.

შეცდომები, რომლებიც ამ ენდპოინტს შეუძლია დააბრუნოს

401 · 403 · 404 · 422 · 429 · 503

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