compute

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

Move the machine between the standard and extended backup tiers.

אימות

שלחו מפתח API כאסימון נושא (bearer token). על המפתח לכלול את הרשאה 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 הפיזי כך שתוכל לראות את התגובה בפועל. פתח נקודת קצה זו במסוף ה-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

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