本文へ
ドキュメントAPI リファレンススナップショット一覧を取得
GETBearer トークン

スナップショット一覧を取得

/api/v1/servers/:id/snapshots

サーバーのスナップショットと作成上限を取得します。一覧に表示されても、プロバイダー側で復元可能になった証拠にはなりません。

API のフィールド名、型、コードはすべての言語で共通です。

リクエスト例

cURL
curl "https://tovahub.com/api/v1/servers/507f1f77bcf86cd799439012/snapshots" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

表示のみ。このページから API リクエストは送信されません。

パラメーター

idパス · 必須

string

リソース ID。24 桁の16進数文字列です。対応する一覧エンドポイントが返すプラットフォーム ID を使用し、プロバイダーのインスタンス ID は使用しないでください。

レスポンス

HTTP ステータス 200

所属組織のサーバーについて、スナップショットの上限と現在の一覧を取得します。

limitnumber

プランのスナップショット作成上限。

snapshotsarray

現在のプロバイダーが返すスナップショットレコード、またはプレビューデータ。

snapshots[].idstring

スナップショット識別子。

snapshots[].namestring

スナップショット名。

snapshots[].instanceIdstring

プロバイダーのインスタンス識別子。

snapshots[].descriptionstring | null (optional)

スナップショットの説明。

snapshots[].createdAtstring (optional)

提供された場合、プロバイダーの作成日時の値。

snapshots[].autoDeleteAtstring (optional)

提供された場合、プロバイダーの自動削除日時。

snapshots[].imageIdstring (optional)

提供された場合、プロバイダーのイメージ識別子。

snapshots[].imageNamestring (optional)

提供された場合、プロバイダーのイメージ名。

simulatedboolean (true, optional)

隔離されたテスト用リソースに含まれます。そのスナップショット一覧は空です。