変更の始まり

Db2 REST サービスのドロップ

必要な権限を持っている場合、Db2® REST サービス・マネージャー API を使用して、ユーザー定義サービスをドロップできます。 サービスをドロップするとサービスが除去され、サービスに関連付けられていたパッケージが解放され、対応する行が SYSIBM.DSNSERVICE カタログ表から削除されます。

始める前に

REST サービス・パッケージの作成、ドロップ、保守には、BIND PACKAGE、FREE PACKAGE、REBIND PACKAGE の各コマンドではなく、必ず Db2 REST サービス・マネージャー API を使用してください。サービスをドロップする際には、実行者が関連パッケージを解放またはドロップすることができる特権を持っている必要があります。必要な特権または権限について詳しくは、FREE PACKAGE (DSN) を参照してください。

手順

  • サービスをドロップするには、以下の URI を使用して、REST クライアントを介して HTTP/HTTPS POST 要求を発行します。
    POST https://<host>:<port>/services/DB2ServiceManager
  • 要求の HTTP ヘッダーの Accept フィールドおよび Content-Type フィールドを application/json に設定します。
  • 要求に以下の HTTP 本体を指定します。
    {
     "requestType": "dropService",
     "collectionID": "<serviceCollectionID>",
     "serviceName": "<serviceName>"
    }

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

    • dropService は、新規サービスの除去を要求することを示します。
    • <serviceCollectionID> は、新規サービスに関連付けられているパッケージの ID です。
    • <serviceName> は、ドロップするサービスの名前です。

例

サービス simpleSelect1 をドロップするには、以下の URI を入力して HTTPS POST 要求を開始します。

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

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

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

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

{
 "requestType": "dropService",
 "collectionID": "SYSIBMSERVICE",
 "serviceName": "simpleSelect1"
}

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

{
 "StatusCode":200,
 "StatusDescription":"DB2 Rest Service simpleSelect1 was dropped successfully."
}

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

注: IBM® Data Studio クライアントを使用して、ユーザー定義サービスをドロップすることもできます。 手順については、IBM Data Studio クライアントを使用したユーザー定義のサービスの作成を参照してください。
変更の終わり