compute
GET /v1/compute/servers/{serverId}/backups/tier
The machine's backup tier, and what upgrading would cost.
認証
ベアラー トークンとして API キーを送信します。キーには sites.view 権限が付与されている必要があります。権限のないキーは 404 ではなく 403 で拒否されます。
このエンドポイントは組織IDを受け付けません。お使いのキーによって所属する組織がすでに特定されており、レスポンスはその組織にスコープされます。
試してみる
アングルブラケット内のすべてをご自身の値に置き換え、キーのプレースホルダーをご利用中のダッシュボードのキーに置き換えてください。
curl -X GET https://api.zinndigital.com/v1/compute/servers/{serverId}/backups/tier \
-H "Authorization: Bearer zdk_live_…"ログインしていますか？ダッシュボード内のAPIコンソールでは、実際の組織IDやお客様ご自身のキーが自動入力され、ライブAPIに対してリクエストが実行されるため、実際のレスポンスを確認することができます。 API コンソールでこのエンドポイントを開く
詳細
A pure read — it charges nothing. amount_minor is our price for moving this machine to extended backups, derived from the provider's own live quote for this machine rather than from a published percentage: the two disagree, and the provider's figure is the one we are charged. ⛔ upgrade_available: false with a reason when the machine is already on the extended tier, is still building, or is on a range that has no tier concept — the VPS range buys backups as a separate contract instead, from getComputeServerPlan. 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. |
返信
| 名前 | タイプ | 必須 | これがその内容です |
|---|---|---|---|
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 · 429