NetWorker：REST APIを使用してオンデマンド バックアップを開始する方法

このKBでは、POST MANを使用したREST API関数について説明します。POST MANは、REST API機能の実行に使用できるサード パーティー製APIツールです。NetWorkerには含まれていません。同様のAPIツールを使用できます。NetWorkerの要件とREST API機能はどのツールでも同じですが、外観と場所は使用するツールによって異なる場合があります。

このKBは、REST API関数(GET、POSTなど)と必要なヘッダーについて一般的に理解している読者を対象としています。詳細については、次のREST APIガイドを参照してください。https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

GET https://NETWORKER_SERVERNAME:9090/nwrestapi/v3/global/clients

必要に応じて、resourceId、hostName、protectionGroups、saveSetsなど、必要なデータをフィルタリングできます。

GET https://NETWORKER_SERVERNAME:9090/nwrestapi/v3/global/clients?fl=resourceID,Hostname,protectionGroups,saveSets

例:

図1: クライアントresourceId、hostname、protectionGroups、saveSetsを収集するためのREST API GETリクエストを示すPost-Manの例。

2.protectionGroupが割り当てられているポリシーとワークフローの名前を取得します。

GET https://NETWORKER_SERVERNAME:9090/nwrestapi/v3/global/protectionpolicies?fl=name,workflows

オプション1: クライアントresourceIdを使用して、単一のクライアント バックアップ(すべてのセーブセット)を開始します。

ステップ1のresourceIdを使用して、バックアップするクライアントのPOST URIを生成します。

POST https://NETWORKER_SERVERNAME:9090/nwrestapi/v3/global/clients/resourceId/op/backup

これはPOSTであるため、要求でJSON本文を指定する必要があります。ここでは、ステップ2の出力から収集できるポリシーとワークフローを指定します。

{
    "policy": "POLICY_NAME",
    "workflow": "WORKFLOW_NAME"
}

例:

図2: クライアント バックアップを開始するためのREST API POST操作を示すPOST MANの例。

成功すると、状態コード 201 が返されます。

オプション2: 保護ポリシーを使用した1つ以上のクライアント バックアップの開始:

保護ポリシー名とワークフロー名を使用して、バックアップする1つ以上のクライアントを含むポリシーとワークフローのPOST URIを生成します。

POST https://NETWORKER_SERVERNAME:9090/nwrestapi/v3/global/protectionpolicies/POLICY_NAME/workflows/WORKFLOW_NAME/op/backup

これはPOSTであるため、要求でJSON本文を指定する必要があります。この場合、ステップ1の出力から収集できるクライアント名を指定します。

{
   "clients": ["CLIENT_1","CLIENT_2"]
}

例えば、

図3：保護ポリシーを開始し、保護グループで構成されている一部のクライアントのみを選択するためのPOST操作を示すPOST MANの例。

成功すると、状態コード 201 が返されます。

ポリシー全体のバックアップを開始する場合:JSON 本文で以下を指定します。

{}

これにより、ワークフローに割り当てられた保護グループで構成されているすべてのクライアントがバックアップされます。

オプションで、クライアントでセーブセットを指定することもできます。

{
   "clients": ["CLIENT_1:/etc/hosts","CLIENT_2:/var/log/messages"]
}