compute
GET /v1/compute/servers/{serverId}/backups
A server's automatic backup arrangement.
المصادقة
أرسل مفتاح واجهة برمجة التطبيقات (API key) كرمز حامل (bearer token). يجب أن يحمل المفتاح إذن sites.view؛ والمفتاح الذي لا يملكه يُرفض بالرمز 403 وليس 404.
لا يقبل هذا الطرف أي معرف للمؤسسة. يحدد مفتاحك بالفعل المؤسسة التي ينتمي إليها، وتكون الاستجابة محصورة في نطاقها.
جربه الآن
استبدل أي شيء بين أقواس زاوية بقيمك الخاصة، والعنصر النائب للمفتاح بمفتاح من لوحة تحكمك.
curl -X GET https://api.zinndigital.com/v1/compute/servers/{serverId}/backups \
-H "Authorization: Bearer zdk_live_…"هل سجلت الدخول؟ تقوم وحدة تحكم واجهة برمجة التطبيقات في لوحة التحكم الخاصة بك بربط معرف مؤسستك الحقيقي ومفتاحك الخاص، وتنفذ الطلب مقابل واجهة برمجة التطبيقات المباشرة لتتمكن من رؤية الاستجابة الفعلية. افتح هذه النهاية الطرفية في وحدة تحكم API
التفاصيل
Whether the provider is backing this machine up, which tier it is on, when backups run and how many are kept. ⛔⛔ Read manageable before rendering a control. The two ranges differ: on the resold range the tier is readable and there is no verb to change it, so the honest surface is a statement and an upgrade route; on our own cloud it is a switch. A client that assumed it could always write would show half the estate a toggle that fails. Requires sites.view.
المعلمات
| الاسم | النوع | مطلوب | ما هو هذا |
|---|---|---|---|
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 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 an… |
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… |
price_currency | string | نعم | ISO-4217 code for price_minor, or "" exactly when that is null. |
الأخطاء التي يمكن أن تُرجعها نقطة النهاية هذه
401 · 403 · 404 · 422 · 429 · 503