レスポンス・コード

アイデンティティ・ドメインのREST APIリソースのいずれかを呼び出すと、標準のHTTPステータス・コードの1つがレスポンス・ヘッダーです。

『Hypertext Transfer Protocol -- HTTP/1.1』の「Status Code Definitions」の項を参照してください。

HTTPステータス・コード

説明

200 OK リクエストは正常に完了しました。200ステータスは、GETメソッドが成功すると返されます。
201 Created 要求は実行され、新しいリソースが作成されました。レスポンスには、新規に作成されたリソースの正規のURIを含むLocationヘッダーがあります。

201ステータスは、レスポンスが返されるより前に完了した同期リソース作成または非同期リソース作成から返されます。

202 Accepted 要求の処理を受け付けましたが、処理は完了しませんでした。この要求は、実際に処理が行われる際に拒否される可能性があるため、最終的には処理されない場合があります。

非同期(__detached=true)リソース作成を指定する(アプリケーションのデプロイ時など)、または更新を指定する(アプリケーションの再デプロイ時など)場合は、操作がまだ進行中でも202が返されます。__detached=falseの場合は、基になる操作が妥当な時間で完了しない場合、202が返されることがあります。

レスポンスには、ジョブが完了したタイミングを判定するためにクライアントがポーリングする必要がある、ジョブ・リソースのLocationヘッダーが含まれています。また、ジョブの現在の状態を含むエンティティを返します。

204 No Content 操作が成功して、レスポンス本文で送信するコンテンツはありません。これは通常DELETE.が成功すると送信されます。
307 Temporary Redirect リクエストは特定された一時的な場所で繰り返されますが、元の場所をリソースへの永続的な参照として使用します。
308 Permanent Redirect 識別されている場所でリクエストを繰り返し、それをリソースへの永続的な参照として使用します。
400 Bad Request 情報が欠落しているか無効であるため(入力フィールドでの検証エラー、必須値の不足など)、リクエストを処理できません。
401 Unauthorized このリクエストは認可されていません。このリクエストに含まれていた認証資格証明が不足しているか無効です。
403 Forbidden リクエスト操作はサポートされていません。
404 Not Found リクエストに、存在しないリソースURIが含まれています。
405 Method Not Allowed リクエストに指定されたHTTP動詞(DELETE, GET, POST, PUT)がこのリソースではサポートされていないため、またはメソッドでフィルタが必要ですが、これは提供されませんでした。
409 Conflict バージョン番号が一致しないか、重複するリソースが要求され、再作成できません。
412 Precondition Failed リソースの変更時に、更新に失敗しました。
413 Request Entity Too Large maxOperations (1000)またはmaxPayload (1048576)を超過しました。
415 Not Acceptable クライアントのContentTypeヘッダーが正しくない(たとえば、クライアントがXMLでリクエストを送信しようとしたが、リソースはJSONしか受け付けない場合)。
500 Internal Server Error サーバーはリクエストの処理を妨げる予期しない条件に遭遇しました。
501 Not Implemented 要求された操作はサポートされていません。
503 Service Unavailable サーバーが一時的な過負荷またはメンテナンス中であるため、サーバーがリクエストを処理できません。アイデンティティ・ドメインREST Webアプリケーションが現在実行されていません。