NetWorker: Como fazer POST de restaurações de imagem de VM da VMware com a API REST

Summary: Este artigo da KB apresenta uma breve visão geral de como executar restaurações de imagem de VM da VMware a partir da API REST.

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Este artigo da KB apresenta uma breve visão geral/genérica de como executar restaurações de imagem de VM da VMware a partir da API REST. O guia completo da API REST está disponível em: 

https://developer.dell.com/apis/2378/versions/v3/docs/GettingStarted.md1) Você pode consultar todas as VMs protegidas para obter o UUID da VM que deseja restaurar. A sintaxe do link seguiria:
https:// NETWORKER_SERVER:9090/nwrestapi/v3/global/vmware/vcenters/VCENTER_SERVER/protectedvms

2) Você deve coletar os valores necessários de MoRef (VMware Managed Object Reference) para a VM específica que deseja restaurar: A sintaxe do link seguiria: 
https:// NETWORKER_SERVER:9090/nwrestapi/v3/global/vmware/vcenters/VCENTER_SERVER/protectedvms/VM_UUID/backups

Os valores necessários aparecem na linha vm_info e na seção vmInformation do resultado.

Exemplo:
kA53a0000004OcKCAU_1_0
 
3) Você pode coletar informações adicionais adicionais adicionando o ID de backup à solicitação GET: 
https:// NETWORKER_SERVER:9090/nwrestapi/v3/global/vmware/vcenters/VCENTER_SERVER/protectedvms/VM_UUID/backups/BACKUP_ID

4) Para fazer o POST da restauração, você deve usar a seguinte sintaxe de link
https:// NETWORKER_SERVER:9090/nwrestapi/v3/global/vmware/vcenters/VCENTER_SERVER/protectedvms/VM_UUID/backups/BACKUP_ID/op/recover

Um exemplo do conteúdo do corpo JSON seria substituir os valores por valores coletados nas etapas 2 e 3:
{
	"recoverMode": "New",
	"datacenterMoref": "DATACENTER_MOREF",
	"datastoreMoref": "DATASTORE_MOREF",
	"computeResourceMoref": "COMPUTE_RESOURCE_MOREF",
		"disks": [
                    {
                        "datastoreMoref": "DATASTORE_MOREF",
                        "key": "2000",
                        "name": "Hard disk 1"
                    }
                ],
	"vCenterHostname": "VCENTER_NAME",
	"hostMoref": "VCENTER_MOREF",
	"vmName": "RESTORED_VM_NAME",
	"powerOn": "true/false",
	"reconnectNic": "true/false"
}

 
Exemplo:
kA53a0000004OcKCAU_1_1
Nota: O status 201 indica que a solicitação foi enviada. Este é apenas um exemplo de uma restauração completa de imagem em um ambiente específico. As propriedades e os requisitos podem mudar com base no ambiente VMware.
 
A sessão de restauração é vista no client VMware.
 
Solução de problemas genérica:
 
Código Descrição Exemplos
1XX Informativo 100 – Continuar
2XXX Success 200 – OK
201 – Criado
202 – Aceito
3XXX Redirecionamento 301 - Movido permanentemente
307 - Redirecionamento temporário
4XXX Erro client 400 - Solicitação incorreta
401 - Não autorizado
404 - Não encontrado
5XXX Erro de SERVIDOR 500 - Erro interno do servidor
503 - Serviço indisponível.
 
 

Additional Information

Os registros da sessão de restauração podem ser encontrados:

servidor do NetWorker:
Linux: /nsr/logs/recover/
Windows: [INSTALL_DRIVE]:\Program Files\EMC NetWorker\nsr\logs\recover
vProxy usado para restauração: /opt/emc/vproxy/runtime/logs/recycle/vrecoverd/
Nota: Na maioria das situações depois que a restauração for concluída, ela será movida para: /opt/emc/vproxy/runtime/logs/recycle/vrecoverd/

Affected Products

NetWorker

Products

NetWorker
Article Properties
Article Number: 000021344
Article Type: How To
Last Modified: 06 May 2025
Version:  5
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.