NetWorker:如何使用 REST API 啟動隨選備份
Summary: 本知識文章概述如何使用 REST API 執行隨選 NetWorker 備份。
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
GET https://NETWORKER_SERVERNAME:9090/nwrestapi/v3/global/clients
或者,您可以篩選所需的資料,例如 resourceId、主機名稱、保護群組和集:
GET https://NETWORKER_SERVERNAME:9090/nwrestapi/v3/global/clients?fl=resourceID,Hostname,protectionGroups,saveSets
例如:
圖 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"
}
例如:
圖 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"]
}
例如:

圖 3:POST MAN 範例,顯示用於啟動保護原則的 POST 作業,以及僅選取保護群組中設定的部分用戶端。
如果成功,則返回狀態代碼 201。
如果您想要啟動整個原則的備份;在 JSON 內文中指定以下內容:
{}
通過執行此操作,將備份在分配給工作流的保護組中配置的所有用戶端。
或者,您也可以使用用戶端指定儲存集:
{
"clients": ["CLIENT_1:/etc/hosts","CLIENT_2:/var/log/messages"]
}