compute

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

Move the machine between the standard and extended backup tiers.

Упълномощаване

Изпратете API ключ като токен за носене. Ключът трябва да притежава разрешението billing.payment.manage; ключ без него се отхвърля с 403, а не с 404.

Този ендпойнт не изисква идентификатор на организация. Вашият ключ вече идентифицира организацията, към която принадлежи, и отговорът е ограничен до нея.

Опитайте

Заменете всичко в квадратни скоби със собствени стойности, а ключовия заместващ символ – с ключ от вашето табло за управление.

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 конзолата във вашето табло за управление попълва действителното идентификационно число на вашата организация и вашия собствен ключ и изпълнява заявката спрямо реалното API, за да можете да видите действителния отговор. Отворете този крайpoint в 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…

Грешки, които този крайpoint може да върне

401 · 403 · 404 · 422 · 429 · 503

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