NetWorker:如何使用 REST API 啟動隨選備份

Summary: 本知識文章概述如何使用 REST API 執行隨選 NetWorker 備份。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

此 KB 顯示使用 POST MAN 的 REST API 功能。POST MAN 是第三方 API 工具,可用於執行 REST API 功能。這不包含在 NetWorker 中。可以使用類似的 API 工具。所有工具的 NetWorker 需求和 REST API 功能均相同,但外觀和位置可能會因所使用的工具而有所不同。

本 KB 適用於對 REST API 函數 (GET、POST 等) 和必要標頭有一般瞭解的讀者。如果需要更多資訊,請參閱下列 REST API 指南:https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

 
 
1.首先執行 GET 要求以取得受保護用戶端的清單:
GET https://NETWORKER_SERVERNAME:9090/nwrestapi/v3/global/clients

或者,您可以篩選所需的資料,例如 resourceId、主機名稱、保護群組和集:

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

例如:
image.png
圖 1:顯示 REST API GET 要求以收集用戶端資源 Id、主機名稱、保護群組和集集的 Post-Man 範例。

2.取得分配保護組的策略和工作流名稱:

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

選項 1:使用 Client 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"
}

例如:
image.png
圖 2:POST MAN 範例,顯示用於啟動用戶端備份的 REST API POST 作業。

如果成功,則返回狀態代碼 201。

選項 2:使用保護原則啟動一或多個用戶端備份:

使用保護原則和工作流程名稱,為包含您要備份的一或多個用戶端的原則和工作流程產生 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"]
}

例如:

image.png
圖 3:POST MAN 範例,顯示用於啟動保護原則的 POST 作業,以及僅選取保護群組中設定的部分用戶端。

如果成功,則返回狀態代碼 201。

如果您想要啟動整個原則的備份;在 JSON 內文中指定以下內容:

{}

通過執行此操作,將備份在分配給工作流的保護組中配置的所有用戶端。

或者,您也可以使用用戶端指定儲存集:

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

Additional Information

Affected Products

NetWorker

Products

NetWorker Family, NetWorker Series
Article Properties
Article Number: 000224014
Article Type: How To
Last Modified: 18 Apr 2025
Version:  2
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.