Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 Arquivos 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 restaurar arquivos do Azure usando o portal do Azure, o Azure PowerShell, a API REST.
Ao final deste artigo, você aprenderá a executar as seguintes operações com a CLI do Azure:
- Exiba os pontos de restauração de arquivos do Azure com backup.
- Restaurar arquivos completos do Azure.
- Restaurar arquivos ou pastas individuais.
Observação
- A restauração dos Arquivos do Azure só tem suporte na mesma assinatura ao usar o PowerShell ou a CLI.
- 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 a seção local original ou alternativa deste documento para saber mais.
Pré-requisitos
Este artigo pressupõe que você já tenha um Azure Files com backup do Azure Backup. Se você não tiver um, consulte Fazer backup dos Arquivos do Azure com a CLI para configurar o backup para o Compartilhamento de Arquivos. Neste artigo, você usará os seguintes recursos:
| Compartilhamento de arquivo | Conta de armazenamento | Região | Detalhes |
|---|---|---|---|
azurefiles |
afsaccount | EastUS | Backup de origem original usando o Backup do Azure |
| azurefiles1 | afaccount1 | EastUS | Fonte de destino usada para recuperação de localização alternativa |
Você pode usar uma estrutura semelhante para seus Compartilhamentos de Arquivos para experimentar os diferentes tipos de restaurações explicados neste artigo.
Preparar o ambiente para a CLI do Azure
Utilize o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Se você estiver executando 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 você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas em seu terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando 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 e gerenciar extensões com a CLI do Azure.
Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar 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 estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.
Buscar pontos de recuperação para os Arquivos do Azure
Use o az backup recoverypoint list cmdlet para listar todos os pontos de recuperação para o Compartilhamento de Arquivos com backup.
O exemplo a seguir obtém a lista dos pontos de recuperação do azurefiles Compartilhamento de Arquivos 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 completa 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 com backup. Para recuperar o nome ou o nome amigável do contêiner, use o comando az backup container list .
- --item-name: o nome do Compartilhamento de Arquivos original que foi copiado para backup e 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. Somente ResolveConflict precisa ser fornecido.
O exemplo a seguir usa o cmdlet az backup restore restore-azurefileshare com o modo de restauração definido para originallocation para restaurar o Compartilhamento de Arquivos azurefiles na localização original. Você usa o ponto de recuperação 932883129628959823, que você obteve em Buscar pontos de recuperação para os 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 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 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 que o 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 no Compartilhamento de Arquivos para a qual os dados são restaurados. Se o conteúdo de 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 Overwrite ou Skip.
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 acompanhar o status do trabalho, use o cmdlet az backup job show.
Recuperação no 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 com backup. Para recuperar o nome ou o nome amigável do contêiner, use o comando az backup container list .
- --item-name: o nome do Compartilhamento de Arquivos original que foi copiado para backup e 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 no Compartilhamento de Arquivos, como uma cadeia de caracteres. Esse caminho é o mesmo caminho usado nos comandos az storage file download ou az storage file show da CLI.
- SourceFileType: escolha 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 com o modo de restauração definido como az backup restore restore-azurefiles 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 azurefiles Compartilhamento de Arquivos.
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 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íficos para um local alternativo, use o cmdlet com o modo de restauração definido como az backup restore restore-azurefiles 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 Arquivos dentro da conta de armazenamento de destino para a qual o conteúdo de backup é restaurado.
- --target-folder: a pasta no Compartilhamento de Arquivos para a qual os dados são restaurados. Se o conteúdo de backup for restaurado para uma pasta raiz, dê o valor da pasta de destino como uma cadeia de caracteres vazia.
O exemplo a seguir restaura o arquivo RestoreTest.txt que estava originalmente presente no Compartilhamento de Arquivos, para um local alternativo: a pasta azurefiles no Compartilhamento de Arquivos restoredata, 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 criado pelo serviço de backup para sua 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 para o parâmetro de caminho de arquivo de origem 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 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
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 criado pelo serviço de backup para sua 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 ou pastas individuais para uma seção de local alternativa .
Próximas etapas
Gerenciar backups dos Arquivos do Azure usando o portal do Azure, o Azure PowerShell, a CLI do Azure, a API REST.