HTTP レスポンスで返されるステータス コードは以下のとおりです。
| HTTP コード | HTTP の説明 | 注 |
|---|---|---|
| 2xx | OK | エラーではありません。成功すると返されます。これは、ビジネス ロジックの障害（CreateBookingResponse の booking_failure に値が入力されるなど）にも使用する必要があります。 |
| 400 | 不正なリクエスト | 不正なリクエスト/無効な引数（販売者、サービス、スロットが見つからない、無効なスロットの予約、存在しない予約のキャンセル）。 |
| 401 | 非許可 | 未認証（無効な認証情報、ログインの再試行）。リクエストには、このオペレーションの有効な認証情報がありません。 |
| 403 | 禁止動作 | アクセスが拒否されたか、禁止されています（呼び出し元は既知であり、拒否されています）。このレスポンスは、一部のリソースが枯渇したことによる拒否には使用しないでください（このようなエラーには Too Many Requests を使用します）。呼び出し元を特定できない場合は、Forbidden を使用しないでください（このようなエラーには代わりに Unauthorized を使用します）。 |
| 404 | 見つかりませんでした | 未検出（リソースが見つからない、無効な URL（無効な RPC など）） |
| 409 | 対立 | オペレーションは、通常はシーケンサー チェックの失敗やトランザクションの中止など、同時実行の問題が原因で中止されました。 |
| 429 | リクエスト過多 | ユーザーごとの割り当てやファイル システム全体で割り当てが不足しているなど、一部のリソースが枯渇しています。 |
| 499 | クライアントによるリクエストの終了 | オペレーションがキャンセルされました。通常、キャンセルは呼び出し元によって行われます。 |
| 500 | 内部サーバーエラー | 内部エラー。これは、基盤となるシステムが想定する不変条件の一部が破損していることを意味します。このエラーコードは、重大なエラーのために予約されています。 |
| 501 | 実装されていません | オペレーションが実装されていないか、このサービスでサポートまたは有効化されていません。 |
| 503 | サービス利用不可 | サービスは現在使用できません。これは一時的な問題である可能性が最も高く、バックオフで再試行することで解決できます。 |
| 504 | ゲートウェイのタイムアウト | オペレーションが完了する前に期限が切れました。システムの状態を変更するオペレーションの場合、オペレーションが正常に完了しても、このエラーが返されることがあります。たとえば、サーバーからのレスポンスが正常に遅延して、期限が切れる場合があります。 |
複数のエラーコードが該当する場合があります。サービスは、該当する最も具体的なエラーコードを返します。