NetWorker : Comment démarrer une sauvegarde à la demande à l’aide de l’API REST

Cet article de la base de connaissances présente les fonctions de l’API REST à l’aide de POST MAN. POST MAN est un outil d’API tiers qui peut être utilisé pour exécuter des fonctions d’API REST. Il n’est pas inclus avec NetWorker. Des outils API similaires peuvent être utilisés. Les exigences NetWorker et la fonctionnalité de l’API REST restent identiques pour tous les outils, mais l’apparence et l’emplacement peuvent varier en fonction de l’outil utilisé.

Cet article de la base de connaissances est destiné aux lecteurs ayant une compréhension générale des fonctions de l’API REST (GET, POST, etc.) et des en-têtes requis. Si vous avez besoin de plus d’informations, reportez-vous au Guide de l’API REST suivant : https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

Si vous le souhaitez, vous pouvez filtrer les données nécessaires, telles que resourceId, hostName, protectionGroups et saveSets :

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

Par exemple :

Figure 1 : Exemple post-man montrant la requête GET de l’API REST pour collecter les resourceId, le nom d’hôte, les protectionGroups et les saveSet du client.

2. Obtenez le nom de la politique et du workflow où le protectionGroup est attribué :

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

Option 1 : Démarrage d’une sauvegarde client unique (tous les savesets) à l’aide de l’ID ressource du client.

À l’aide du resourceId de l’étape 1, générez un POST URI pour le client que vous souhaitez sauvegarder.

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

Étant donné qu’il s’agit d’un POST, vous devez spécifier un corps JSON dans la demande. Dans ce cas, nous spécifions la politique et le workflow qui peuvent être collectés à partir de la sortie de l’étape 2.

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

Par exemple :

Figure 2 : Exemple POST MAN montrant une opération POST de l’API REST pour démarrer une sauvegarde client.

Si le code d’état de réussite est renvoyé, 201.

Option 2 : Démarrage d’une ou de plusieurs sauvegardes client à l’aide de la politique de protection :

À l’aide des noms Protection Policy et Workflow, générez un POST URI pour la politique et le workflow contenant un ou plusieurs clients que vous souhaitez sauvegarder :

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

Étant donné qu’il s’agit d’un POST, vous devez spécifier un corps JSON dans la demande. Dans ce cas, nous spécifions les noms de clients qui peuvent être collectés à partir de la sortie de l’étape 1.

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

Par exemple :

Figure 3 : Exemple POST MAN montrant l’opération POST pour démarrer une politique de protection et sélectionnant uniquement certains des clients configurés dans le groupe de protection.

Si le code d’état de réussite est renvoyé, 201.

Si vous souhaitez démarrer une sauvegarde de l’ensemble de la politique ; spécifiez les éléments suivants dans le corps JSON :

{}

Ainsi, tous les clients configurés dans le groupe de protection attribué au workflow sont sauvegardés.

Si vous le souhaitez, vous pouvez également spécifier des savesets avec un client :

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