NetWorker: Så här startar du en säkerhetskopiering på begäran med REST API

I den här kunskapsbas-artikeln visas REST API-funktioner med hjälp av POST MAN. POST MAN är ett API-verktyg från tredje part som kan användas för att utföra REST API-funktioner. Det ingår inte i NetWorker. Liknande API-verktyg kan användas. NetWorker-kraven och REST API-funktionerna förblir desamma för alla verktyg, men utseende och placering kan variera beroende på vilket verktyg som används.

Den här kunskapsbasartikeln är avsedd för läsare som har en allmän förståelse för REST API-funktioner (GET, POST och så vidare) och obligatoriska rubriker. Om mer information behövs kan du läsa följande REST API-guide: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

Du kan också filtrera efter data som behövs, till exempel resourceId, hostName, protectionGroups och saveSets:

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

Till exempel:

Figur 1: Post-Man-exempel som visar REST API GET-begäran om att samla in klientens resourceId, hostname, protectionGroups och saveSets.

2. Hämta princip- och arbetsflödesnamnet där protectionGroup har tilldelats:

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

Alternativ 1: Starta en säkerhetskopiering av en enskild klient (alla sparade uppsättningar) med hjälp av klientens resourceId.

Med hjälp av resourceId från steg 1 genererar du en POST-URI för den klient som du vill säkerhetskopiera.

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

Eftersom det här är en POST måste du ange en JSON-brödtext i begäran. I det här fallet anger vi den princip och det arbetsflöde som kan samlas in från utdata i steg 2.

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

Till exempel:

Figur 2: POST MAN-exempel som visar en REST API POST-åtgärd för att starta en klientsäkerhetskopiering.

Om det lyckas returneras statuskod 201.

Alternativ 2: Starta en eller flera klientsäkerhetskopieringar med hjälp av skyddspolicyn:

Med hjälp av namnen Protection Policy och Workflow genererar du en POST-URI för principen och arbetsflödet som innehåller en eller flera klienter som du vill säkerhetskopiera:

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

Eftersom det här är en POST måste du ange en JSON-brödtext i begäran. I det här fallet anger vi de klientnamn som kan samlas in från utdata i steg 1.

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

Exempel:

Bild 3: POST MAN-exempel som visar POST-åtgärden för att starta en skyddsprincip och endast väljer några av klienterna som konfigurerats i skyddsgruppen.

Om det lyckas returneras statuskod 201.

Om du vill starta en säkerhetskopiering för hela policyn; ange följande i JSON-brödtexten:

{}

Genom att göra detta säkerhetskopieras alla klienter som konfigurerats i skyddsgruppen som tilldelats arbetsflödet.

Du kan också ange sparuppsättningar med en klient:

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