Restaurar compartilhamentos de arquivos do Azure com a CLI do Azure

  • Artigo

A CLI do Azure fornece uma experiência de linha de comando para gerenciar recursos do Azure. É uma ótima ferramenta para criar automação personalizada para usar recursos do Azure. Este artigo explica como restaurar um compartilhamento de arquivos inteiro ou arquivos específicos de um ponto de restauração criado pelo Backup do Azure usando a CLI do Azure. Também pode realizar estes passos com o Azure PowerShell ou no portal do Azure.

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

  • Exiba pontos de restauração para um compartilhamento de arquivos do Azure com backup.
  • Restaure um compartilhamento de arquivos completo do Azure.
  • Restaure ficheiros ou pastas individuais.

Nota

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. Consulte a seção Restaurar vários arquivos ou pastas para o local original ou alternativo deste documento para saber mais.

Pré-requisitos

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

Partilha de ficheiros Conta de armazenamento País/Região Detalhes
azurefiles AFSACCOUNT EastUS Backup da fonte original usando o Backup do Azure
azurefiles1 AFACCOUNT1 EastUS Origem de destino usada para recuperação de local alternativo

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

Prepare o seu ambiente para o CLI do Azure

  • Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  • Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

    • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

    • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

    • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

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

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

Use o cmdlet az backup recoverypoint list para listar todos os pontos de recuperação para o compartilhamento de arquivos de backup.

O exemplo a seguir busca a lista de pontos de recuperação para o compartilhamento de arquivos 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 dois parâmetros adicionais a seguir:

  • --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 tempo 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 total de compartilhamento usando a CLI do Azure

Você pode usar essa opção de restauração para restaurar o compartilhamento de arquivos 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 arquivos original do backup. Para recuperar o nome ou o nome amigável do seu contêiner, use o comando az backup container list .
  • --item-name: O nome do compartilhamento de arquivos original do backup que você deseja usar para a operação de restauração. Para recuperar o nome ou o nome amigável do item de backup, use o comando az backup item list.

Restaurar um compartilhamento completo para o local original

Ao restaurar para um local original, você não precisa especificar parâmetros relacionados ao destino. Apenas a opção Resolver Conflito deve ser fornecida.

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 arquivos azurefiles no local original. Use o 932883129628959823 de ponto de recuperação, obtido em Buscar pontos de recuperação para o compartilhamento de arquivos 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 criado pelo serviço de backup para sua operação de restauração. Para controlar 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 arquivos para um local alternativo e manter o compartilhamento de arquivos 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 do cofre.
  • --target-file-share: O compartilhamento de arquivos dentro da conta de armazenamento de destino para a qual o conteúdo de backup é restaurado.
  • --target-folder: A pasta sob o compartilhamento de arquivos para o qual os dados são restaurados. Se o conteúdo do backup for restaurado para uma pasta raiz, forneça os valores da pasta de destino como uma cadeia de caracteres vazia.
  • --resolve-conflict: Instrução se houver um conflito com os dados restaurados. Aceita Substituir ou Ignorar.

O exemplo a seguir usa az backup restore restore-azurefileshare com modo de restauração como alternatelocation para restaurar o compartilhamento de arquivos azurefiles na conta de armazenamento afsaccount para o compartilhamento de arquivos 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 criado pelo serviço de backup para sua operação de restauração. Para controlar o status do trabalho, use o cmdlet az backup job show .

Recuperação ao nível do 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 arquivos original do backup. Para recuperar o nome ou o nome amigável do seu contêiner, use o comando az backup container list .
  • --item-name: O nome do compartilhamento de arquivos original do backup que você deseja usar para a operação de restauração. Para recuperar o nome ou o nome amigável do 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 dentro do compartilhamento de arquivos, como uma cadeia de caracteres. Esse caminho é o mesmo usado nos comandos az storage file download ou az storage file show CLI .
  • SourceFileType: Escolha se um diretório ou um arquivo está selecionado. Aceita diretório ou arquivo.
  • ResolveConflict: Instrução se houver um conflito com os dados restaurados. Aceita Substituir ou Ignorar.

Restaurar ficheiros ou pastas individuais para a localização original

Use o cmdlet az backup restore restore-azurefiles com o modo restore definido como originallocation para restaurar arquivos ou pastas específicos para seu local original.

O exemplo a seguir restaura o arquivo RestoreTest.txt em seu local original: O compartilhamento de arquivos 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 criado pelo serviço de backup para sua operação de restauração. Para controlar o status do trabalho, use o cmdlet az backup job show .

Restaurar ficheiros ou pastas individuais para uma localização alternativa

Para restaurar arquivos ou pastas específicos 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 do cofre.
  • --target-file-share: O compartilhamento de arquivos dentro da conta de armazenamento de destino para a qual o conteúdo de backup é restaurado.
  • --target-folder: A pasta sob o compartilhamento de arquivos para o qual os dados são restaurados. Se o conteúdo do backup for restaurado para 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 originalmente presente no compartilhamento de arquivos azurefiles para um local alternativo: A pasta RestoreData no compartilhamento de arquivos AzureFiles1 hospedado na conta de armazenamento AFContice1.

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 criado pelo serviço de backup para sua operação de restauração. Para controlar o status do trabalho, use o cmdlet az backup job show .

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

Para executar a restauração de 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 Report.docx de teste Restore.txt e AFS em seu 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

O resultado será semelhante ao seguinte:

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

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

Se desejar 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 ou pastas individuais para um local alternativo.

Próximos passos

Saiba como Gerenciar backups de compartilhamento de arquivos do Azure com a CLI do Azure.