変更の始まり

REST サービス要求のトラブルシューティング

Db2® が HTTP サービス要求を正常に実行できない場合、失敗の一般的なカテゴリーを示す HTTP 状況コードが応答ヘッダーおよび本体内に設定されます。応答本体には、失敗の理由に関する追加情報が提供されることがある StatusDescription フィールドも含まれています。

以下の表に、一般的なエラー状態の HTTP 状況コードを示します。

表 1. REST サービス・エラー状態の一般的な HTTP 状況コード
HTTP 状況コード 説明
HTTP 500 (内部サーバー・エラー) サーバーが要求を遂行できなかったことを示します。ほとんどの場合、HTTP コードには、エラー状態についてより詳しい情報を提供する Db2 SQL コードが付随しています。
HTTP 400® (誤った要求) 入力パラメーターに関する問題 (必須入力パラメーターの欠落など) を示します。これは、Db2 SQL ステートメントを実行する前に Db2 DDF ネイティブ REST コードにより検出されます。

このコードは、一般的に誤った入力や入力の欠落によって発生する多くの DB2ServiceManager の失敗 (Create/Drop サービスなど) および DB2DiscoverService の失敗 (サービスのディスカバー、サービス詳細のディスカバー) の場合にも使用されます。

HTTP 401 (無許可) ユーザーが正常に認証されなかったことを示します。
HTTP 403 (禁止) ユーザーがリソースにアクセスするために必要な許可を持っていない可能性があることを示します。

以下の例は、Db2 DATE 列をターゲットとした「HIREDATE」パラメーター値への入力が、有効な DATE 形式で指定されていないために失敗する要求を示しています。

POST http://hostname.ibm.com:446/services/SYSIBMSERVICE/inDateConvertError
Request body:
{
"HIREDATE":"NOT_A_DATE"
}
この要求への応答には、HTTP 状況コードの後に、エラー状態に関する詳細を示す StatusDescription セクションが含まれます。この場合、Db2 SQL コードも含まれています。
HTTP reply msg Header Fields:{null=[HTTP/1.1 500 Internal Server Error], Content-Language=[en-US], 
Date=[Fri, 31 Mar 2017 18:23:28 GMT], Content-Length=[229], Content-Type=[application/json; charset=UTF-8], 
X-Powered-By=[DB2 for z/OS], Server=[DB2 DDF Native REST, STLEC1]}
Response body:
{
"StatusCode":500,
"StatusDescription":"Service SYSIBMSERVICE.inDateConvertError execution failed due to SQL error, 
SQLCODE=-180, SQLSTATE=22007, Message=THE DATE, TIME, OR TIMESTAMP VALUE *N IS INVALID Error Location:DSNLJXUS:6"
}
変更の終わり