compute
POST /v1/compute/servers/{serverId}/backups/tier
Move the machine between the standard and extended backup tiers.
Аутентификација
Пошаљите API кључ као bearer токен. Кључ мора имати дозволу billing.payment.manage; кључ без ње се одбија уз 403, а не 404.
Ова крајња тачка не прихвата id организације. Ваш кључ већ идентификује организацију којој припада, а одговор је ограничен на њу.
Испробајте
Замените све што је у угластим заградама сопственим вредностима, а чувар места кључа кључем са своје контролне табле.
curl -X POST https://api.zinndigital.com/v1/compute/servers/{serverId}/backups/tier \
-H "Authorization: Bearer zdk_live_…" \
-H "Content-Type: application/json" \
-d '{ "tier": <string<standard, pro>> }'Пријављени сте? API конзола на вашој контролној табли попуњава ваш прави id организације и ваш сопствени кључ, и покреће захтев према живом API-ју како бисте могли да видите стварни одговор. Отворите ову крајњу тачку у API конзоли
Детаљи
⛔⛔ Chargeable one way and lossy the other. Upgrading starts a recurring charge for as long as it runs. Downgrading returns the machine to the standard retention, and what happens to the snapshots already taken is the provider's decision and is not documented — so a confirmation should say the tier changes and must not promise a date for the older restore points. The response is the tier re-read from the provider, never an echo of the request. 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. |
Тело захтева
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
tier | string<standard, pro> | Да | ⛔ Ours, not the provider's. standard maps to their normal and pro to their upgraded; the mapping lives in the engine so a client never learns a vendor word. |
Одговор
| Назив | Тип | Обавезно | Шта је ово |
|---|---|---|---|
data | ComputeBackupTier | Да | 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… |
Грешке које ова крајња тачка може вратити
401 · 403 · 404 · 422 · 429 · 503