リソース · 107

非同期APIジョブ

要求の受理は処理の完了を証明しません。

更新済み · 2 min

このガイドが達成するのに役立つこと

  • 状態と権限を定める
  • 追跡を再開する
  • 結果を確かめる

クイックチェック

  • 202は将来の完了を証明する?
  • 取消は既に生じた影響も消す?

手順

  1. 1

    状態と権限を定める

    受理、待機、実行、完了、失敗、取消要求を区別する。HTTP 202は成功を保証しない。状態、結果、取消の権限をアカウントごとに確認する。識別子は権限の代わりにならない。

    アカウント、操作、再利用する識別子

  2. 2

    追跡を再開する

    既存の参照を保持する。照会間隔、期間、有効期限、状態がない場合の対応を決める。重複防止があるなら適用範囲を明記し、再送前に応答消失を試す。

    状態、時刻、照会間隔、有効期限

  3. 3

    結果を確かめる

    処理中や公開中の取消、実行処理の障害、結果の期限切れを試す。残る影響を確認し、終端状態で照会を停止する。

    成果、エラー、取消、残る影響

再利用可能なワークシート

承認された観察結果を記入してください。 これらのフィールドは作業用テンプレートであり、観察結果ではありません。

フィールド記録する情報
参照アカウント、操作、再利用する識別子
追跡状態、時刻、照会間隔、有効期限
結果成果、エラー、取消、残る影響
受入れ許可された単一のジョブと中断後の確認済み結果

架空の事例

具体的な状況

架空の例:エクスポートの受理応答が消失し、利用者が再試行する。

決定と期待される証拠

再送の契約が既存のジョブを返すか試す。その保証がないなら新規作成前に要求を確認する。画面だけで一度限りの実行は証明できない。

管理指標

指標測定対象最初のアクション
停滞したジョブ決めた期間内に更新がない要求確認、再開、終了の担当を決める
再開新しいジョブを作らず再開した追跡再実行と重複を調べる

よくある間違い

    よくある質問

    202は将来の完了を証明する?

    しない。処理の受理を示し、最終結果は示さない。操作の状態を確認する。

    取消は既に生じた影響も消す?

    必ずしも消さない。終端状態を確認し、既存の影響を照合する。

    公式参照文献

    参照文献はメソッドを裏付けるものです。 チェックは状況に合わせて調整してください。 これらは認証ではありません。 元の参照文献のタイトルやソース文書は別の言語で書かれている場合があります。

    参照資料の確認日 .