NetWorker: Sådan starter du en on-demand-sikkerhedskopiering ved hjælp af REST API

Denne KB viser REST API-funktioner ved hjælp af POST MAN. POST MAN er et tredjeparts API-værktøj, der kan bruges til at udføre REST API-funktioner. Det er ikke inkluderet i NetWorker. Lignende API-værktøjer kan bruges. NetWorker-kravene og REST API-funktionaliteten forbliver de samme på tværs af værktøjer, men udseende og placering kan variere afhængigt af det anvendte værktøj.

Denne KB er beregnet til læsere, der har en generel forståelse af REST API-funktioner (GET, POST osv.) og påkrævede overskrifter. Hvis der er behov for flere oplysninger, skal du se følgende REST API-vejledning: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

Du kan også filtrere efter nødvendige data, f.eks. resourceId, hostName, protectionGroups og saveSets:

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

For eksempel:

Figur 1: PostMan-eksempel, der viser REST API GET-anmodning om at indsamle klientressource-id'et, værtsnavnet, protectionGroups og saveSets.

2. Få navnet på politik og arbejdsproces, hvor beskyttelsesgruppen er tildelt:

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

Valgmulighed 1: Start af en sikkerhedskopiering af en enkelt klient (alle gemte sæt) ved hjælp af klientens resourceId.

Brug resourceId et fra trin 1 til at oprette en POST URI for den klient, du vil sikkerhedskopiere.

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

Da dette er en POST, skal du angive en JSON-brødtekst i anmodningen. I dette tilfælde angiver vi den politik og arbejdsgang, der kan indsamles fra outputtet i trin 2.

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

For eksempel:

Figur 2: POST MAN-eksempel, der viser en REST API POST-handling for at starte en klientsikkerhedskopiering.

Hvis statuskoden 201 er gennemført, returneres statuskoden.

Valgmulighed 2: Start af en eller flere klientsikkerhedskopier ved hjælp af beskyttelsespolitikken:

Brug navnene Beskyttelsespolitik og Arbejdsproces til at generere en POST-URI for den politik og arbejdsgang, der indeholder en eller flere klienter, som du vil sikkerhedskopiere:

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

Da dette er en POST, skal du angive en JSON-brødtekst i anmodningen. I dette tilfælde angiver vi de klientnavne, der kan indsamles fra outputtet i trin 1.

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

For eksempel:

Figur 3: Eksempel på POST Man, der viser POST-handling for at starte en beskyttelsespolitik og kun vælge nogle af de klienter, der er konfigureret i beskyttelsesgruppen.

Hvis statuskoden 201 er gennemført, returneres statuskoden.

Hvis du vil starte en sikkerhedskopiering af hele politikken; angive følgende i JSON-brødteksten:

{}

Ved at gøre dette sikkerhedskopieres alle klienter, der er konfigureret i den beskyttelsesgruppe, der er tildelt arbejdsprocessen.

Du kan også vælge at angive gemte sæt med en klient:

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