NetWorker: Come avviare un backup on-demand utilizzando l'API REST

Questo articolo della KB mostra le funzioni dell'API REST utilizzando POST MAN. POST MAN è uno strumento API di terze parti che può essere utilizzato per eseguire funzioni API REST. Non è inclusa in NetWorker. È possibile utilizzare strumenti API simili. I requisiti di NetWorker e la funzionalità dell'API REST rimangono invariati tra gli strumenti, ma l'aspetto e la posizione possono variare a seconda dello strumento utilizzato.

Questo articolo della KB è destinato ai lettori che hanno una conoscenza generale delle funzioni API REST (GET, POST e così via) e delle intestazioni obbligatorie. Se sono necessarie ulteriori informazioni, consultare la seguente Guida alle API REST: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

Facoltativamente, è possibile filtrare i dati necessari, ad esempio resourceId, hostName, protectionGroups e saveSets:

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

Ad esempio:

Figura 1: Esempio post-man che mostra la richiesta GET dell'API REST per raccogliere il resourceId, il nome host, i protectionGroups e i saveSet del client.

2. Ottenere il nome della policy e del flusso di lavoro a cui è assegnato il protectionGroup:

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

Opzione 1: Avvio di un backup di un singolo client (tutti i saveset) utilizzando il resourceId client.

Utilizzando il resourceId del passaggio 1, generare un URI POST per il client di cui si desidera eseguire il backup.

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

Poiché si tratta di un POST, è necessario specificare un corpo JSON nella richiesta. In questo caso, specificare la policy e il flusso di lavoro che possono essere raccolti dall'output nel passaggio 2.

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

Ad esempio:

Figura 2: Esempio di POST MAN che mostra un'operazione POST API REST per avviare il backup di un client.

In caso di esito positivo, viene restituito il codice di stato 201.

Opzione 2: Avvio di uno o più backup client utilizzando la policy di protezione:

Utilizzando i nomi della policy di protezione e del flusso di lavoro, generare un URI POST per la policy e il flusso di lavoro contenente uno o più client di cui si desidera eseguire il backup:

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

Poiché si tratta di un POST, è necessario specificare un corpo JSON nella richiesta. In questo caso, specificare i nomi dei client che possono essere raccolti dall'output nel passaggio 1.

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

Esempio:

Figura 3. Esempio POST MAN che mostra l'operazione POST per avviare una policy di protezione e selezionare solo alcuni dei client configurati nel gruppo di protezione.

In caso di esito positivo, viene restituito il codice di stato 201.

Se si desidera avviare un backup per l'intera policy; specificare quanto segue nel corpo JSON:

{}

In questo modo, verrà eseguito il backup di tutti i client configurati nel gruppo di protezione assegnato al flusso di lavoro.

Facoltativamente, è anche possibile specificare i saveset con un client:

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