NetWorker: Como iniciar um backup sob demanda usando a API REST

Este artigo da KB mostra as funções da API REST usando o POST MAN. POST MAN é uma ferramenta de API de terceiros que pode ser usada para executar funções de API REST. Ele não está incluído no NetWorker. Ferramentas de API semelhantes podem ser usadas. Os requisitos do NetWorker e a funcionalidade da API REST permanecem os mesmos entre as ferramentas, mas a aparência e o local podem ser diferentes, dependendo da ferramenta usada.

Este artigo da KB destina-se a leitores que tenham uma compreensão geral das funções da API REST (GET, POST e assim por diante) e dos cabeçalhos necessários. Se mais informações forem necessárias, consulte o seguinte Guia da API REST: https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md

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

Como opção, você pode filtrar os dados necessários, como resourceId, hostName, protectionGroups e saveSets:

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

Por exemplo:

Figura 1: Exemplo de Post-man mostrando a solicitação GET da API REST para coletar o resourceId, o nome do host, a protectionGroups e os savesets do client.

2. Obtenha o nome da política e do fluxo de trabalho em que o protectionGroup está atribuído:

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

Opção 1: Iniciando um backup de client único (todos os savesets) usando o resourceId dos clients.

Usando o resourceId da etapa 1, gere um URI de POST para o client do qual você deseja fazer backup.

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

Como se trata de um POST, você deve especificar um corpo JSON na solicitação. Nesse caso, especificamos a política e o fluxo de trabalho que podem ser coletados do resultado na etapa 2.

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

Por exemplo:

Figura 2: Exemplo de POST MAN mostrando uma operação POST da API REST para iniciar um backup do client.

Se for bem-sucedido, o código de status 201 será retornado.

Opção 2: Iniciando um ou mais backups de client usando a política de proteção:

Usando os nomes de política de proteção e fluxo de trabalho, gere um URI de POST para a política e o fluxo de trabalho que contêm um ou mais clients dos quais você deseja fazer backup:

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

Como se trata de um POST, você deve especificar um corpo JSON na solicitação. Nesse caso, especificamos os nomes de client que podem ser coletados do resultado na etapa 1.

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

Por exemplo:

Figura 3: Exemplo de POST MAN mostrando a operação POST para iniciar uma política de proteção e selecionando apenas alguns dos clients configurados no grupo de proteção.

Se for bem-sucedido, o código de status 201 será retornado.

Se você gostaria de iniciar um backup de toda a política; especifique o seguinte no corpo JSON:

{}

Ao fazer isso, todos os clients configurados no grupo de proteção atribuído ao fluxo de trabalho passarão por backup.

Opcionalmente, você também pode especificar savesets com um client:

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