Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
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. Você também pode restaurar Arquivos do Azure usando o portal do Azure, Azure PowerShell, API REST.
No final deste artigo, você aprenderá como executar as seguintes operações com a CLI do Azure:
- Exiba os pontos de restauração de um backup dos Arquivos do Azure.
- Restaure um Azure Files completo.
- Restaure ficheiros ou pastas individuais.
Observação
- A restauração dos Arquivos do Azure só é suportada 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 o local original ou alternativo deste documento para saber mais.
Pré-requisitos
Este artigo pressupõe que você já tenha um arquivo do Azure cujo backup é feito pelo Backup do Azure. Se você não tiver um, consulte Fazer backup 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 | Região | Detalhes |
|---|---|---|---|
azurefiles |
AFSACCOUNT | Leste dos EUA | Backup da fonte original usando o Backup do Azure |
| azurefiles1 | AFACCOUNT1 | Leste dos EUA | Fonte de destino utilizada para recuperação em 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 na Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale o CLI do Azure. Se você estiver executando no Windows ou macOS, considere executar a CLI do Azure em um contêiner do 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 Autenticar no Azure usando a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.
Execute az version para descobrir a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute 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 os Arquivos do Azure
Use o az backup recoverypoint list cmdlet 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 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:
-
--tipo-de-gestão-de-backup:
azurestorage -
--tipo de carga de trabalho:
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 da partilha de ficheiros original do backup que pretende 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 com o modo de restauração definido como az backup restore restore-azurefileshare para restaurar o Compartilhamento de Arquivos originallocation no local original. Use o ponto de recuperação 932883129628959823, que obteve em Obter 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 controlar o estado da tarefa, use o cmdlet az backup job show.
Restaurar um compartilhamento completo para um local alternativo
Pode utilizar esta opção para restaurar uma Partilha de Ficheiros para uma localização alternativa e manter a Partilha de Ficheiros original tal 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 sob o Compartilhamento de Arquivos para a 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 o modo de restauração como alternatelocation para restaurar a azurefiles partilha de ficheiros na conta de armazenamento afsaccount para a partilha de ficheiros 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 estado da tarefa, 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 da partilha de ficheiros original do backup que pretende 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 com o az backup restore restore-azurefiles modo de restauração definido para originallocation 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 controlar o estado da tarefa, 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 com o az backup restore restore-azurefiles 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 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 a 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 azurefiles Compartilhamento de Arquivos para um local alternativo: a restoredata pasta no Compartilhamento de Arquivos 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 criado pelo serviço de backup para sua operação de restauração. Para controlar o estado da tarefa, 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 Restore.txt e teste Report.docxAFS nos seus locais originais.
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 estado da tarefa, 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
Gerencie backups de Arquivos do Azure usando o portal do Azure, Azure PowerShell, CLI do Azure, API REST.