機械翻訳について

ステータス・コード

RESTリソースをコールすると、レスポンス・ヘッダーは、次の表に示す標準HTTPステータス・コードの1つを返します。 これらのステータス・コードは、レスポンス・ヘッダーの3桁の数字で、レスポンスの一般的な分類を示します。 たとえば、このコードは、リクエストが成功した(200秒)か、クライアント(400秒)またはサーバー(500秒)エラーが発生したかを示します。 400および500クラスのステータス・コードは、不良リクエストのトラブルシューティングに役立ちます。

HTTPステータス・コード 説明
200 OK 完了しました! GETまたはPOSTメソッドが成功すると、200ステータス・コードが返されます。
201 Created

リクエストが成功し、新しいリソースが作成されました。 レスポンスには、新しく作成されたリソースの正規URIを含むLocationヘッダーが含まれます。

次の201ステータス・コードを受け取ります:

  • 同期リソースの作成
  • レスポンスが返される前に完了した非同期リソースの作成
202 Accepted サーバーは処理リクエストを受け入れましたが、まだ処理を完了していません。 リクエストは、処理中に受諾または拒否される場合があります。

このコードは、1日に1回のみ実行されるバッチ指向プロセスなど、非同期リソースの作成または更新に役立ちます。 これは、サーバーがリクエストを受け入れていることを示すため、プロセスが完了するまで待機したり接続する必要はありません。

サーバーは、ジョブ・リソースのLocationヘッダーを含むレスポンスを配信します。 クライアントはこのヘッダーをポーリングして、ジョブの完了状態およびステータスを確認します。

204 No Content リクエストはサーバーによって履行されますが、レスポンス本文が返されません。
400 Bad Request: validation failures, schema violations 入力フィールドの検証エラー、必須値の欠落など、欠落または無効な情報が含まれているため、リクエストを処理できませんでした。

v1リソースでは、このステータス・コードを使用して次のことを通知することもできます:

  • 無効なペイロード
  • 無効なURLパラメータです。 これには、誤った構文、問合せできないフィールド、無効な値などが含まれます。
  • アプリケーション・レベルの検証エラー
401 Unauthorized リクエストは承認されていません。 このリクエストに含まれる認証資格証明がないか、無効です。
403 Forbidden このリクエストを実行する権限がありません。 このRESTリソースを使用するために必要なロールおよび権限がない可能性があります。

ノート:

クラウド・リソースへのアクセスは米国のエクスポート法によって管理され、Oracle Global Trade Compliance (GTC)によって内部的に監視されます。 米国エクスポート法に準拠していること、およびOracleが関連するクラウド・サービスへのアクセスを許可しているロケーションからRESTリソースにアクセスしていることを確認してください。 それ以外の場合は、レスポンスで403 HTTPステータス・コードを引き続き取得できます。
404 Not Found <Additional information about the object not found> リクエストに、存在しないリソースURIが含まれています。

v1リソースでは、データ・セキュリティによってリソースへのアクセスを防止できます。

405 Method Not Allowed リクエスト(DELETE, GET, POST, PUT)で指定されたHTTPアクションは、このリクエストURIではサポートされていません。
406 Not Acceptable サーバーはリクエストを認識して処理しますが、サーバー・レスポンスはサポートされていないため理解できません。 クライアントのリクエスト・ヘッダーは、受け入れ可能なデータまたはメディア・タイプを示します。 たとえば、クライアントのAcceptヘッダーはXMLの返却をリクエストしますが、サーバーはJSONのみを返すことができます。
408 Request Timeout サーバーがリクエストの待機中にタイムアウトしました。
409 Conflict 指定したバージョン番号がリソースの最新バージョン番号と一致しないか、サービス・プロバイダが新規または重複するリソースを作成しませんでした。
412 Precondition Failed ヘッダーの前提条件に失敗したため、リクエストを処理できませんでした。 たとえば、最後の取得以降、サーバーのリソースIDが変更されたため、リクエストの更新に失敗しました。
413 Request Entity Too Large 一括リクエストは最大許容操作数を超えています。
415 Unsupported Media Type ペイロード形式がサポートされていないため、サーバーがクライアント・リクエストの受入れを拒否することを示します。 クライアントで、ContentTypeヘッダーが正しくありません。 たとえば、クライアントはXMLでリクエストを送信しようとしますが、サーバーはJSONのみを受け入れることができます。
422 Unprocessable Entity <Additional information about the error> リクエスト・パラメータの構文が正しくありません。
424 Failed Dependency <Additional information on failed dependency> リクエストされたアクションが失敗した別のアクションに依存しているため、リクエストを処理できませんでした。
428 Precondition Required サーバーはリクエストを条件付きにする必要があります。
500 Internal Server Error サーバーで予期しないことが検出されたため、リクエストを完了できませんでした。

v1リソースでは、このステータス・コードを使用して次のことを通知することもできます:

  • フレームワーク例外
  • アプリケーション・レベルの検証エラー
  • データベース・エラー
501 Not Implemented サーバーがリクエストで使用されているメソッドをサポートしていないため、リクエストを処理できないことを示します。
503 Service Unavailable サーバーの過負荷が原因でサーバーがリクエストを完了できないことを示します。 この状態は通常一時的なものです。
504 Gateway Timeout サーバーはゲートウェイとして機能し、アップストリーム・サーバーからリクエストを完了するためのタイムリなレスポンスを受信しません。

ステータス・コードの詳細は、「インターネット・エンジニア・リング・タスク・フォース(IETF)」 webサイトを参照してください。