Restaurar compartilhamentos de arquivo do Azure com a CLI do Azure

A CLI do Azure fornece uma experiência de linha de comando para gerenciamento de recursos do Azure. Ela é uma excelente ferramenta para a criação de automação personalizada para usar os recursos do Azure. Este artigo explica como restaurar um compartilhamento de arquivo inteiro ou arquivos específicos de um ponto de restauração criado pelo Backup do Azure usando a CLI do Azure. Você também pode executar essas etapas usando o Azure PowerShell ou o portal do Azure.

Ao final deste artigo, você aprenderá a executar as seguintes operações usando a CLI do Azure:

• Ver os pontos de restauração de um compartilhamento de arquivo salvo em backup no Azure.
• Restaurar um compartilhamento de arquivos completo do Azure.
• Restaurar arquivos ou pastas individuais.

Observação

O Backup do Azure agora dá suporte à restauração de vários arquivos ou pastas para o local original ou alternativo usando a CLI do Azure. Confira a seção Restaurar vários arquivos ou pastas no local original ou alternativo deste documento para saber mais.

Pré-requisitos

Este artigo pressupõe que você já tenha um compartilhamento de arquivo do Azure cujo backup é feito pelo Backup do Azure. Se você não tiver um, confira Fazer backup de compartilhamentos de arquivo do Azure com a CLI para configurar o backup para o compartilhamento de arquivo. Neste artigo, você usará os seguintes recursos:

Compartilhamento de arquivo	Conta de armazenamento	Região	Detalhes
azurefiles	afsaccount	EastUS	Backup da fonte de origem realizado usando o Backup do Azure
azurefiles1	afaccount1	EastUS	Backup da fonte de destino usada para recuperação de local alternativo

Você pode usar uma estrutura semelhante para seus compartilhamentos de arquivo para experimentar os diferentes tipos de restaurações explicados neste artigo.

Preparar o ambiente para a CLI do Azure

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

• Este tutorial exige a versão 2.0.18 ou posterior da CLI do Azure. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.

Buscar pontos de recuperação para o compartilhamento de arquivo do Azure

Use o cmdlet az backup recoverypoint list para listar todos os pontos de recuperação para o compartilhamento de arquivo cujo backup foi realizado.

O exemplo a seguir busca a lista de pontos de recuperação para o compartilhamento de arquivo azurefiles na conta de armazenamento afsaccount.

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --backup-management-type azurestorage --item-name "AzureFileShare;azurefiles" --workload-type azurefileshare --out table

Você também pode executar o cmdlet anterior usando o nome amigável para o contêiner e o item fornecendo os seguintes dois parâmetros adicionais:

• --backup-management-type: azurestorage
• --workload-type: azurefileshare

az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --item-name azurefiles --workload-type azurefileshare --out table

O conjunto de resultados é uma lista de pontos de recuperação com detalhes de hora e consistência para cada ponto de restauração.

Name                Time                        Consistency
------------------  -------------------------   --------------------
932887541532871865  2020-01-05T07:08:23+00:00   FileSystemConsistent
932885927361238054  2020-01-05T07:08:10+00:00   FileSystemConsistent
932879614553967772  2020-01-04T21:33:04+00:00   FileSystemConsistent

O atributo Name na saída corresponde ao nome do ponto de recuperação que pode ser usado como um valor para o parâmetro --rp-name em operações de recuperação.

Recuperação de compartilhamento completa usando a CLI do Azure

Você pode usar essa opção de restauração para restaurar o compartilhamento de arquivo completo no local original ou alternativo.

Defina os seguintes parâmetros para executar operações de restauração:

• --container-name: o nome da conta de armazenamento que hospeda o compartilhamento de arquivo original cujo backup foi realizado. Para recuperar o nome ou nome amigável do seu contêiner, use o comando az backup container list.
• --item-name: o nome do compartilhamento de arquivo original cujo backup foi realizado e que você deseja usar para a operação de restauração. Para recuperar o nome ou nome amigável de seu item de backup, use o comando az backup item list.

Restaurar um compartilhamento completo para o local original

Ao restaurar para um local original, não é necessário especificar os parâmetros relacionados ao destino. Somente ResolveConflict precisa ser fornecido.

O exemplo a seguir usa o cmdlet az backup restore restore-azurefileshare com o modo de restauração definido como originallocation para restaurar o compartilhamento de arquivo azurefiles no local original. Você usa o ponto de recuperação 932883129628959823, que foi obtido em Buscar pontos de recuperação para o compartilhamento de arquivo do Azure:

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932887541532871865   --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
6a27cc23-9283-4310-9c27-dcfb81b7b4bb  azurefiles

O atributo Name na saída corresponde ao nome do trabalho que é criado pelo serviço de backup para a operação de restauração. Para acompanhar o status do trabalho, use o cmdlet az backup job show.

Restaurar um compartilhamento completo para um local alternativo

Você pode usar essa opção para restaurar um compartilhamento de arquivo para um local alternativo e manter o compartilhamento de arquivo original como está. Especifique os seguintes parâmetros para recuperação de local alternativo:

• --target-storage-account: a conta de armazenamento para a qual o conteúdo de backup é restaurado. A conta de armazenamento de destino deve estar no mesmo local que o cofre.
• --target-file-share: o compartilhamento de arquivo dentro da conta de armazenamento de destino na qual o conteúdo de backup é restaurado.
• --target-folder: a pasta no compartilhamento de arquivo para a qual os dados são restaurados. Se for para restaurar o conteúdo do backup em uma pasta raiz, forneça os valores da pasta de destino como uma cadeia de caracteres vazia.
• --resolve-conflict: a instrução para o caso de um conflito com os dados restaurados. Aceita Overwrite ou Skip.

O exemplo a seguir usa az backup restore restore-azurefileshare com o modo de restauração como alternatelocation para restaurar o compartilhamento de arquivo azurefiles na conta de armazenamento afsaccount para o compartilhamento de arquivo azurefiles1" na conta de armazenamento afaccount1.

az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932883129628959823 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --out table

Name                                  ResourceGroup
------------------------------------  ---------------
babeb61c-d73d-4b91-9830-b8bfa83c349a  azurefiles

O atributo Name na saída corresponde ao nome do trabalho que é criado pelo serviço de backup para a operação de restauração. Para acompanhar o status do trabalho, use o cmdlet az backup job show.

Recuperação em nível de item

Você pode usar essa opção de restauração para restaurar arquivos ou pastas individuais no local original ou alternativo.

Defina os seguintes parâmetros para executar operações de restauração:

• --container-name: o nome da conta de armazenamento que hospeda o compartilhamento de arquivo original cujo backup foi realizado. Para recuperar o nome ou nome amigável do seu contêiner, use o comando az backup container list.
• --item-name: o nome do compartilhamento de arquivo original cujo backup foi realizado e que você deseja usar para a operação de restauração. Para recuperar o nome ou nome amigável de seu item de backup, use o comando az backup item list.

Especifique os seguintes parâmetros para os itens que você deseja recuperar:

• SourceFilePath: o caminho absoluto do arquivo a ser restaurado no compartilhamento de arquivo, como uma cadeia de caracteres. Esse caminho é o mesmo caminho usado nos comandos az storage file download or az storage file show da CLI.
• SourceFileType: se um diretório ou um arquivo está selecionado. Aceita Directory ou File.
• ResolveConflict: a instrução para o caso de um conflito com os dados restaurados. Aceita Overwrite ou Skip.

Restaurar arquivos ou pastas individuais para o local original

Use o cmdlet az backup restore restore-azurefiles com o modo de restauração definido como originallocation para restaurar arquivos ou pastas específicas para o local original.

O exemplo a seguir restaura o arquivo RestoreTest.txt no local original: o compartilhamento de arquivo azurefiles.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore/RestoreTest.txt" --resolve-conflict overwrite  --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

O atributo Name na saída corresponde ao nome do trabalho que é criado pelo serviço de backup para a operação de restauração. Para acompanhar o status do trabalho, use o cmdlet az backup job show.

Restaurar arquivos ou pastas individuais para um local alternativo

Para restaurar arquivos ou pastas específicas para um local alternativo, use o cmdlet az backup restore restore-azurefiles com o modo de restauração definido como alternatelocation e especifique os seguintes parâmetros relacionados ao destino:

• --target-storage-account: a conta de armazenamento para a qual o conteúdo de backup é restaurado. A conta de armazenamento de destino deve estar no mesmo local que o cofre.
• --target-file-share: o compartilhamento de arquivo dentro da conta de armazenamento de destino na qual o conteúdo de backup é restaurado.
• --target-folder: a pasta no compartilhamento de arquivo para a qual os dados são restaurados. Se for para restaurar o conteúdo do backup em uma pasta raiz, forneça o valor da pasta de destino como uma cadeia de caracteres vazia.

O exemplo a seguir restaura o arquivo RestoreTest.txt presente originalmente no compartilhamento de arquivo azurefiles para um local alternativo: a pasta restoredata no compartilhamento de arquivo azurefiles1, hospedado na conta de armazenamento afaccount1.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --source-file-type file --source-file-path "Restore/RestoreTest.txt" --out table

Name                                  ResourceGroup
------------------------------------  ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319  azurefiles

O atributo Name na saída corresponde ao nome do trabalho que é criado pelo serviço de backup para a operação de restauração. Para acompanhar o status do trabalho, use o cmdlet az backup job show.

Restaurar vários arquivos ou pastas para o local original ou alternativo

Para executar a restauração para vários itens, passe o valor do parâmetro source-file-path como caminhos separados por espaço de todos os arquivos ou pastas que você deseja restaurar.

O exemplo a seguir restaura os arquivos Restore.txt e AFS testing Report.docx no local original.

az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932889937058317910 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation  --source-file-type file --source-file-path "Restore Test.txt" "AFS Testing Report.docx" --resolve-conflict overwrite  --out table

A saída será semelhante ao seguinte:

Name                                          ResourceGroup
------------------------------------          ---------------
649b0c14-4a94-4945-995a-19e2aace0305          azurefiles

O atributo Name na saída corresponde ao nome do trabalho que é criado pelo serviço de backup para a operação de restauração. Para acompanhar o status do trabalho, use o cmdlet az backup job show.

Se você quiser restaurar vários itens para um local alternativo, use o comando acima especificando parâmetros relacionados ao destino, conforme explicado na seção Restaurar arquivos individuais ou pastas em um local alternativo.

Próximas etapas

Saiba como Gerenciar backups de compartilhamentos de arquivo do Azure com a CLI do Azure.