変更の始まり

Db2 REST サービスの呼び出し

必要な権限を持っている場合、RESTful HTTP クライアントを介して Db2® REST サービスを呼び出すことができます。

始める前に

サービスを呼び出すには、以下のいずれかの特権または権限を持っている必要があります。
  • サービスのパッケージの Execute 特権
  • サービスの所有権
  • SYSADM 権限または SYSCTRL 権限
  • システム DBADM 権限

手順

  • サービスを呼び出すには、以下の URI を使用して、REST クライアントを介して HTTP/HTTPS POST 要求を発行します。
    POST https://<host>:<port>/services/<serviceCollectionID>/<serviceName>

    各変数の意味は次のとおりです。

    • <serviceName> は、指定する新規サービスの名前です。
    • <serviceCollectionID> は、新規サービスに関連付けられているパッケージの ID です。 <serviceCollectionID> プロパティーは、オプションです。 <serviceCollectionID> を指定しない場合、Db2 はデフォルトの SYSIBMSERVICE.<serviceNname> 値を使用します。
  • 要求の HTTP ヘッダーの Accept フィールドおよび Content-Type フィールドを application/json に設定します。
  • 要求スキーマで HTTPS 要求の本体が必要な場合は、必要な JSON オブジェクトを指定します。

例

サービス simpleSelect1 を呼び出すには、以下の URI を入力して HTTPS POST 要求を開始します。

POST https://<host>:<port>/services/simpleSelect1

要求に以下の HTTP ヘッダー・フィールドを指定します。

Accept:application/json
Content-Type:application/json

要求に以下の HTTP 本体を指定します。

{
 "LOCATION": "<location>"
}

Db2 は、JSON で以下の応答を返します。

{
 "ResultSet Output":
  {
   "DEPTNAME": "SPIFFY COMPUTER SERVICE DIV."
  },
  {
   "DEPTNAME": "PLANNING"
  },
  {
   "DEPTNAME": "INFORMATION CENTER"
  },
  {
   "DEPTNAME": "DEVELOPMENT CENTER"
  },
  {
   "DEPTNAME": "MANUFACTURING SYSTEMS"
  },
  {
   "DEPTNAME": "ADMINISTRATION SYSTEMS"
  },
  {
   "DEPTNAME": "SUPPORT SERVICES"
  },
  {
   "DEPTNAME": "OPERATIONS"
  },
  {
   "DEPTNAME": "SOFTWARE SUPPORT"
  },
  {
   "DEPTNAME": "BRANCH OFFICE F2"
  },
  {
   "DEPTNAME": "BRANCH OFFICE G2"
  },
  {
   "DEPTNAME": "BRANCH OFFICE H2"
  },
  {
   "DEPTNAME": "BRANCH OFFICE I2"
  },
  {
   "DEPTNAME": "BRANCH OFFICE J2"
  },
 "StatusCode": 200,
 "StatusDescription": "Execution Successful."
}

この応答は、サービス simpleSelect1 が正常に呼び出されたことを示しています。

変更の終わり