NetWorker: Een on-demand back-up starten met REST API

Deze KB toont REST API-functies met behulp van POST MAN. POST MAN is een API-tool van derden die kan worden gebruikt om REST API-functies uit te voeren. Het is niet inbegrepen bij NetWorker. Vergelijkbare API-tools kunnen worden gebruikt. De NetWorker-vereisten en REST API-functionaliteit blijven hetzelfde voor alle tools, maar het uiterlijk en de locatie kunnen verschillen afhankelijk van de gebruikte tool.

Dit KB-artikel is bedoeld voor lezers die een algemeen begrip hebben van REST API-functies (GET, POST, enzovoort) en de vereiste headers. Als er meer informatie nodig is, raadpleegt u de volgende REST API-handleiding: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

Optioneel kunt u filteren op benodigde gegevens, zoals de resourceId, hostName, protectionGroups en saveSets:

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

Bijvoorbeeld:

Figuur 1: Post-Man voorbeeld van een REST API GET-aanvraag voor het verzamelen van de client resourceId, hostname, protectionGroups en saveSets.

2. Haal de naam van het beleid en de werkstroom op waaraan de protectionGroup is toegewezen:

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

Optie 1: Een enkele clientback-up starten (alle opslagsets) met behulp van de resourceId van de client.

Gebruik de resourceId van stap 1 om een POST-URI te genereren voor de client waarvan u een back-up wilt maken.

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

Omdat dit een POST is, moet u een JSON-body opgeven in de aanvraag. In dit geval specificeren we het beleid en de werkstroom die kunnen worden opgehaald uit de uitvoer in stap 2.

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

Bijvoorbeeld:

Figuur 2: Voorbeeld van POST MAN met een REST API POST-bewerking om een clientback-up te starten.

Als dit is gelukt, wordt de statuscode 201 geretourneerd.

Optie 2: Een of meer clientback-ups starten met behulp van het beschermingsbeleid:

Met behulp van de namen Beveiligingsbeleid en Werkstroom genereert u een POST-URI voor het beleid en de werkstroom met een of meer clients waarvan u een back-up wilt maken:

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

Omdat dit een POST is, moet u een JSON-body opgeven in de aanvraag. In dit geval specificeren we de clientnamen die kunnen worden verzameld uit de uitvoer in stap 1.

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

Bijvoorbeeld:

Afbeelding 3: Voorbeeld van POST MAN waarin de POST-bewerking wordt weergegeven om een beveiligingsbeleid te starten en slechts enkele van de clients die in de beveiligingsgroep zijn geconfigureerd, worden geselecteerd.

Als dit is gelukt, wordt de statuscode 201 geretourneerd.

Als u een back-up wilt starten voor het volledige beleid; Geef het volgende op in de JSON-body:

{}

Hiermee wordt van alle clients die zijn geconfigureerd in de beveiligingsgroep die aan de workflow is toegewezen, een back-up gemaakt.

Optioneel kunt u ook opslagsets met een client opgeven:

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