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 | ゲートウェイのタイムアウト | オペレーションが完了する前に期限が切れました。システムの状態を変更するオペレーションの場合、オペレーションが正常に完了しても、このエラーが返されることがあります。たとえば、サーバーからの正常なレスポンスが期限切れになるほど遅延する場合もあります。 |
複数のエラーコードが該当する場合があります。サービスは、該当する最も具体的なエラーコードを返します。