NetWorker: Cómo iniciar un respaldo bajo demanda mediante la API REST

En este artículo de la base de conocimientos, se muestran las funciones de la API REST mediante POST MAN. POST MAN es una herramienta de API de otros fabricantes que se puede utilizar para realizar funciones de API REST. No se incluye con NetWorker. Se pueden utilizar herramientas de API similares. Los requisitos de NetWorker y la funcionalidad de la API REST siguen siendo los mismos en todas las herramientas, pero la apariencia y la ubicación pueden diferir según la herramienta utilizada.

Este artículo de la base de conocimientos está destinado a lectores que tienen una comprensión general de las funciones de la API REST (GET, POST, etc.) y los encabezados requeridos. Si necesita más información, consulte la siguiente guía de API REST: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

De manera opcional, puede filtrar por datos necesarios, como resourceId, hostName, protectionGroups y saveSets:

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

Por ejemplo:

Figura 1: Ejemplo de Post-Man que muestra la solicitud GET de la API REST para recopilar resourceId, nombre de host, protectionGroups y saveSets del cliente.

2. Obtenga el nombre de la política y el flujo de trabajo donde está asignado el grupo de protección:

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

Opción 1: Inicio de un respaldo de un solo cliente (todos los savesets) mediante el resourceId de los clientes.

Con el resourceId del paso 1, genere un URI de POST para el cliente que desea respaldar.

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

Debido a que se trata de una POST, debe especificar un cuerpo JSON en la solicitud. En este caso, especificamos la política y el flujo de trabajo que se pueden recopilar de la salida en el paso 2.

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

Por ejemplo:

Figura 2: Ejemplo de POST MAN que muestra una operación de POST de la API REST para iniciar un respaldo de cliente.

Si se realiza correctamente, se devuelve el código de estado 201.

Opción 2: Inicio de uno o más respaldos de clientes mediante la política de protección:

Con los nombres de flujo de trabajo y política de protección, genere un URI de POST para la política y el flujo de trabajo que contienen uno o más clientes que desea respaldar:

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

Debido a que se trata de una POST, debe especificar un cuerpo JSON en la solicitud. En este caso, especificamos los nombres de cliente que se pueden recopilar de la salida en el paso 1.

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

Por ejemplo:

Figura 3: Ejemplo de POST MAN que muestra la operación POST para iniciar una política de protección y seleccionar solo algunos de los clientes configurados en el grupo de protección.

Si se realiza correctamente, se devuelve el código de estado 201.

Si desea iniciar una copia de seguridad de toda la política: Especifique lo siguiente en el cuerpo JSON:

{}

Al hacerlo, se respaldarán todos los clientes configurados en el grupo de protección asignado al flujo de trabajo.

De manera opcional, también puede especificar savesets con un cliente:

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