アプリケーション - スナップショット
snapshot の作成
アプリケーションの snapshot を実行します。レート制限は 5 秒あたり 1 リクエストです。
POST
snapshot の作成
パラメータ
アプリケーションの ID。アプリケーションのダッシュボードの URL で確認できます。
ソフトデッドラインの挙動
このルートは ソフトデッドライン モデルに従います。つまり、常に同期的に応答するわけではなくなりました。- snapshot が 約 90 秒以内 に完了した場合、ルートは以前と同様に
200 successと署名付きダウンロード URL(30 日間有効)を返します。 - snapshot の生成に 約 90 秒以上 かかる場合、ルートは 即座に
202とコードSNAPSHOT_PROCESSINGを返します。これは失敗ではありません。 snapshot はバックグラウンドで生成を続け、通常は約 2 分以内に自動的に snapshot 一覧 に表示されます。これは大規模なアプリケーションでは想定される挙動です。
| レスポンス | 意味 | 対応 |
|---|---|---|
status === "success" | snapshot の準備が完了。 | url を使ってダウンロードします。 |
status === "error" かつ code === "SNAPSHOT_PROCESSING" | snapshot はまだ生成中。 | 約 2 分待ってから、snapshot 一覧の取得(GET)で確認します。再度 POST は しないでください。 |
status === "error" でその他の code | 実際の失敗。 | エラーを処理します(下記参照)。 |
レスポンス
呼び出しが成功したかどうかを示します。成功した場合は
success、失敗した場合は error です。レスポンスの内容。
status が success の場合にのみ存在します。snapshot が約 90 秒のソフトデッドラインを超えた場合に返されます。snapshot はバックグラウンドでまだ生成中で、通常は約 2 分以内に自動的に snapshot 一覧に表示されます。エラーではありません。待ってから
GET の一覧 endpoint で確認してください。エラー
snapshot リクエストは429 Too Many Requests で拒否されることがあります。code フィールドを使って 2 つのケースを区別してください。
短期的なクールダウン。ユーザーごと(5 秒あたり 1 リクエスト)またはアプリケーションごと(180 秒あたり 1 リクエスト)の制限に達しました。少し待ってから再試行してください。
1 日あたりのクォータに達しました。アカウントがプランの 1 日あたりの snapshot 許容量(24 時間あたり (RAM / 256) × 2)を使い切りました。クォータはローリング 24 時間ウィンドウが進むにつれて解放されます。1 日あたりの許容量を増やすには、プランをアップグレードしてください。
snapshot の作成

