NetWorker: Starten eines On-Demand-Backups mithilfe der REST API

Dieser Wissensdatenbank-Artikel zeigt REST API-Funktionen mit POST MAN. POST MAN ist ein API-Tool eines Drittanbieters, mit dem REST-API-Funktionen ausgeführt werden können. Sie ist nicht im Lieferumfang von NetWorker enthalten. Ähnliche API-Tools können verwendet werden. Die NetWorker-Anforderungen und die REST API-Funktionen bleiben in allen Tools gleich, aber Darstellung und Speicherort können sich je nach verwendetem Tool unterscheiden.

Dieser Wissensdatenbank-Artikel richtet sich an Leser, die ein allgemeines Verständnis der REST-API-Funktionen (GET, POST usw.) und der erforderlichen Header haben. Weitere Informationen finden Sie im folgenden REST API-Handbuch: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

Optional können Sie nach benötigten Daten filtern, z. B. resourceId, hostName, protectionGroups und saveSets:

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

Beispiel:

Abbildung 1: Post-Man-Beispiel mit einer REST API GET-Anforderung zum Erfassen der Clientressourcen-ID, des Hostnamens, der protectionGroups und der saveSets

2. Rufen Sie den Namen der Policy und des Workflows ab, wobei die Schutzgruppe zugewiesen ist:

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

Option 1: Starten eines einzelnen Clientbackups (alle Savesets) mithilfe der Ressourcen-ID des Clients.

Generieren Sie mithilfe der resourceId aus Schritt 1 einen POST-URI für den Client, den Sie sichern möchten.

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

Da es sich um einen POST handelt, müssen Sie einen JSON-Text in der Anforderung angeben. In diesem Fall geben wir die Policy und den Workflow an, die aus der Ausgabe in Schritt 2 erfasst werden können.

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

Zum Beispiel:

Abbildung 2: POST MAN-Beispiel mit einem REST API POST-Vorgang zum Starten eines Clientbackups.

Wenn erfolgreich, wird Statuscode 201 zurückgegeben.

Option 2: Starten eines oder mehrerer Clientbackups mithilfe der Schutz-Policy:

Erzeugen Sie mithilfe der Schutz-Policy- und Workflownamen einen POST-URI für die Policy und den Workflow, die einen oder mehrere Clients enthalten, die Sie sichern möchten:

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

Da es sich um einen POST handelt, müssen Sie einen JSON-Text in der Anforderung angeben. In diesem Fall geben wir die Clientnamen an, die aus der Ausgabe in Schritt 1 erfasst werden können.

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

Zum Beispiel:

Abbildung 3: POST MAN-Beispiel, das den POST-Vorgang zum Starten einer Schutz-Policy zeigt, wobei nur einige der in der Schutzgruppe konfigurierten Clients ausgewählt werden.

Wenn erfolgreich, wird Statuscode 201 zurückgegeben.

Wenn Sie ein Backup für die gesamte Policy starten möchten: Geben Sie Folgendes im JSON-Text an:

{}

Auf diese Weise werden alle Clients gesichert, die in der Schutzgruppe konfiguriert sind, die dem Workflow zugewiesen ist.

Optional können Sie auch Savesets mit einem Client angeben:

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