NetWorker: Uruchamianie kopii zapasowej na żądanie przy użyciu interfejsu API REST

Ta baza wiedzy przedstawia funkcje interfejsu API REST korzystające z POST MAN. POST MAN to narzędzie API innej firmy, które może być używane do wykonywania funkcji REST API. Nie jest dołączony do NetWorker. Można użyć podobnych narzędzi API. Wymagania NetWorker i funkcje interfejsu API REST pozostają takie same w różnych narzędziach, ale wygląd i lokalizacja mogą się różnić w zależności od używanego narzędzia.

Ten artykuł bazy wiedzy jest przeznaczony dla czytelników, którzy mają ogólną wiedzę na temat funkcji interfejsu API REST (GET, POST itd.) i wymaganych nagłówków. Jeśli potrzebujesz więcej informacji, zapoznaj się z następującym przewodnikiem po interfejsie API REST: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

Opcjonalnie można filtrować potrzebne dane, takie jak resourceId, hostName, protectionGroups i saveSets:

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

Przykład:

Rysunek 1: Przykład Post-Man pokazujący żądanie REST API GET w celu zebrania identyfikatorów resourceId klienta, nazwy hosta, protectionGroups i saveSets.

2. Pobierz nazwę zasady i przepływu pracy, do której przypisano grupę protectionGroup:

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

Opcja 1: Rozpoczęcie tworzenia kopii zapasowej pojedynczego klienta (wszystkie zestawy zapisu) przy użyciu identyfikatora resourceId klienta.

Za pomocą resourceId z kroku 1 wygeneruj identyfikator URI POST dla klienta, którego kopię zapasową chcesz wykonać.

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

Ponieważ jest to test POST, należy określić treść JSON w żądaniu. W takim przypadku określamy zasady i przepływ pracy, które mogą być zbierane z danych wyjściowych w kroku 2.

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

Przykład:

Rysunek 2: Przykład POST MAN przedstawiający operację REST API POST w celu uruchomienia kopii zapasowej klienta.

W przypadku pomyślnej operacji zwracany jest kod stanu 201.

Opcja 2: Uruchamianie jednej lub większej liczby kopii zapasowych klienta przy użyciu zasad ochrony:

Korzystając z nazw zasad ochrony i przepływów pracy, wygeneruj identyfikator URI POST dla zasady i przepływu pracy zawierającego jednego lub więcej klientów, których chcesz zarchiwizować:

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

Ponieważ jest to test POST, należy określić treść JSON w żądaniu. W takim przypadku określamy nazwy klientów, które mogą być zbierane z danych wyjściowych w kroku 1.

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

Na przykład:

Rysunek 3. Przykład testu POST MAN pokazujący operację POST w celu uruchomienia polityki ochrony i wybranie tylko niektórych klientów skonfigurowanych w grupie ochrony.

W przypadku pomyślnej operacji zwracany jest kod stanu 201.

Jeśli chcesz rozpocząć tworzenie kopii zapasowej dla całej polityki; określ następujące elementy w treści JSON:

{}

W ten sposób zostanie utworzona kopia zapasowa wszystkich klientów skonfigurowanych w grupie ochrony przypisanej do przepływu pracy.

Opcjonalnie można również określić zestawy zapisu z klientem:

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