NetWorker. Как начать резервное копирование по требованию с помощью REST API

В этой статье базы знаний показаны функции API-интерфейса REST, использующие POST MAN. POST MAN — это сторонний инструмент API, который можно использовать для выполнения функций REST API. Он не входит в состав NetWorker. Можно использовать аналогичные API-инструменты. Требования NetWorker и функциональность REST API остаются одинаковыми для всех инструментов, но внешний вид и расположение могут отличаться в зависимости от используемого инструмента.

Эта статья базы знаний предназначена для читателей, имеющих общее представление о функциях REST API (GET, POST и т. д.) и необходимых заголовках. Если требуется дополнительная информация, см. следующее руководство по REST API: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

При необходимости можно отфильтровать необходимые данные, такие как resourceId, hostName, protectionGroups и saveSets:

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

Например:Рис.

1. Пример PostMan, показывающий запрос GET API-интерфейса REST для сбора данных о resourceId, имени хоста, группах защиты и наборах сохранений.

2. Получите имя политики и рабочего процесса, в котором назначена protectionGroup:

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

Вариант 1. Запуск одного клиента резервного копирования (всех наборов сохранения) с использованием client'resourceId.

Используя resourceId из шага 1, создайте URI POST для клиента, для которого требуется выполнить резервное копирование.

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

Поскольку это POST, в запросе необходимо указать текст JSON. В этом случае мы указываем политику и рабочий процесс, которые могут быть собраны из выходных данных на шаге 2.

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

Например:

Рис. 2. Пример POST MAN, в котором показана операция POST API-интерфейса REST для запуска резервного копирования клиента.

В случае успешного выполнения возвращается код состояния 201.

Вариант 2. Запуск одного или нескольких клиентских резервных копий с использованием политики защиты:

Используя политику защиты и имена рабочих процессов, создайте URI POST для политики и рабочего процесса, содержащего один или несколько клиентов, резервное копирование которых требуется выполнить:

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

Поскольку это POST, в запросе необходимо указать текст JSON. В этом случае мы указываем имена клиентов, которые могут быть собраны из выходных данных на шаге 1.

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

Например:

Рис. 3. Пример POST MAN, демонстрирующий операцию POST для запуска политики защиты и выбор только некоторых клиентов, настроенных в группе защиты.

В случае успешного выполнения возвращается код состояния 201.

Если вы хотите запустить резервное копирование для всей политики; В теле JSON укажите следующее:

{}

Таким образом будет выполнено резервное копирование всех клиентов, настроенных в группе защиты, назначенной рабочему процессу.

При необходимости вы также можете указать наборы сохранений с клиентом:

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