ステータス・コード
RESTリソースをコールする場合、レスポンス・ヘッダーは、次の表に示すいずれかの標準HTTPステータス・コードを返します。 これらのステータス・コードは、レスポンス・ヘッダーの3桁の数字で、レスポンスの一般的な分類を示します。 たとえば、このコードは、リクエストが成功した(200秒)か、クライアント(400秒)またはサーバー(500秒)エラーが発生したかを示します。 400および500クラスのステータス・コードは、不良リクエストのトラブルシューティングに役立ちます。
HTTPステータス・コード | 説明 |
---|---|
200 OK |
成功! GET またはPOST メソッドが成功すると、200ステータス・コードが返されます。 |
201 Created |
リクエストは成功し、新しいリソースが作成されました。 レスポンスには、新しく作成されたリソースの正規URIを含むLocationヘッダーが含まれます。
次の場所から201ステータス・コードを受け取ります:
|
202 Accepted |
サーバーは処理リクエストを受け入れましたが、まだ処理を完了していません。 リクエストは、処理中に受諾または拒否される場合があります。 このコードは、1日に1回のみ実行されるバッチ指向プロセスなど、非同期リソースの作成または更新で役立ちます。 これは、サーバーがリクエストを受け入れていることを示すため、プロセスが完了するまで待機したり、接続したりする必要はありません。 サーバーは、ジョブ・リソースのロケーション・ヘッダーを含むレスポンスを配信します。 クライアントはこのヘッダーをポーリングして、ジョブの完了状態とステータスを確認します。 |
400 Bad Request |
入力フィールドの検証エラー、必須値の欠落など、欠落または無効な情報が含まれているため、リクエストを処理できませんでした。 |
401 Unauthorized |
リクエストは承認されていません。 このリクエストに含まれる認証資格証明がないか、無効です。 |
403 Forbidden |
このリクエストを実行する権限がありません。 このRESTリソースを使用するために必要なロールおよび権限がない可能性があります。
ノート: クラウド・リソースへのアクセスは米国のエクスポート法によって管理され、Oracle Global Trade Compliance (GTC)によって内部的に監視されます。 米国エクスポート法に準拠していること、およびOracleが関連するクラウド・サービスへのアクセスを許可しているロケーションからRESTリソースにアクセスしていることを確認してください。 それ以外の場合は、レスポンスで403 HTTPステータス・コードを引き続き取得できます。 |
404 Not Found |
リクエストに、存在しないリソースURIが含まれています。 |
405 Method Not Allowed |
リクエスト(DELETE , GET , POST , PUT )で指定されたHTTPアクションは、このリクエストURIではサポートされていません。 |
406 Not Acceptable |
サーバーはリクエストを認識して処理しますが、サーバー・レスポンスはサポートされていないため理解できません。 クライアントのリクエスト・ヘッダーは、受け入れ可能なデータまたはメディア・タイプを示します。 たとえば、クライアントのAcceptヘッダーは、XMLの返却をリクエストしますが、サーバーはJSONのみを返すことができます。 |
415 Not Acceptable |
ペイロード形式がサポートされていないため、サーバーがクライアント・リクエストの受入れを拒否することを示します。 クライアントで、ContentTypeヘッダーが正しくありません。 たとえば、クライアントはXMLでリクエストを送信しようとしますが、サーバーはJSONのみを受け入れることができます。 |
500 Internal Server Error |
サーバーで予期しないことが検出され、リクエストが完了できませんでした。 |
501 Not Implemented |
サーバーがリクエストで使用されているメソッドをサポートしていないため、リクエストを処理できないことを示します。 |
503 Service Unavailable |
サーバーの過負荷が原因でサーバーがリクエストを完了できないことを示します。 この状態は通常一時的なものです。 |
504 Gateway Timeout |
サーバーはゲートウェイとして機能し、リクエストを完了するためのタイムリなレスポンスをアップストリーム・サーバーから受信しません。 |