プロビジョニング処理を復旧する

未完了のプロビジョニングジョブを見つけ、成功済みのセットを置き換えることなく、失敗したガイダンスの生成を再試行します。

プロビジョニングジョブの作成に成功したら、すぐにそのidとengineIdを保存してください。クライアントの接続が切れた場合や、待機しても結果が確認できない場合は、GET /v2/provisioning/jobs/:idを使用します。復旧が必要な対象は、ジョブと種類ごとの状態から判断します。

実行中の処理を探す #

http
GET /v2/organizations/:orgId/provisioning/jobs?status=running
X-API-Key: YOUR_API_KEY

status=runningは必須です。レスポンスには、参照可能な実行中のジョブを配列にしたdataが含まれます。カーソルによるページ分割はありません。認証済みユーザーが開始したジョブだけに絞り込むには、startedBy=meを追加してください。サービスキーにはユーザーの識別情報がないため、このフィルターを指定すると空のリストが返されます。

新しいエンジンの作成レスポンスを受け取れなかった場合は、GET /v2/organizations/:orgId/enginesとダッシュボードでも、作成されたエンジンを確認してください。ジョブはすでに完了し、実行中のリストから消えている可能性があります。作成リクエストを繰り返すと、別のエンジンが作成されることがあります。

失敗した種類を再試行する #

http
POST /v2/provisioning/jobs/:id/retry
X-API-Key: YOUR_API_KEY

このリクエストに本文はありません。元のソースを使い、同じエンジン上で新しいジョブを作成して返します。失敗した種類のうち、まだ空のものだけが対象となり、完了済みのセットは保持されます。返されたジョブの識別子を保存し、完了するまで状態を確認してください。

NothingToProvision(409)は、再試行の対象となる失敗した種類が残っていないことを意味します。たとえば、その後の別の操作でセットが関連付けられた場合などに返されます。ProvisioningJobRunning(409)は、そのエンジンですでに実行中の処理を示します。再試行する前に、これらのリソースを確認してください。

元のソースを変更する必要がある場合は、修正したソースを指定し、意図に合わせてEmptyまたはRequestedを選択して、既存のエンジンに新しいジョブを送信してください。再試行用のルートでは、元の入力が再利用されます。

制限や起動未完了の問題に対処する #

ProvisioningLimitReached(429)にはretryAtが含まれます。その時刻まで待ってから再送信してください。クレジット、プラン、アクセスに関するエラーは、それぞれに応じてアカウント設定や権限を修正する必要があります。

ワークフローの起動に失敗すると、リクエストがサーバーエラーを返していても、新しい空のエンジンが残ることがあります。新しいエンジンの作成を再試行する前に、エンジンの一覧を確認してください。設定しようとしていたエンジンがすでにあれば、そのエンジンを再利用してください。

ジョブが終了したら、生成されたガイダンスを翻訳に使う前に、Studioでレビューしてください。