Como migrar suas contas de armazenamento clássicas para o Azure Resource Manager

A Microsoft desativará as contas de armazenamento clássicas em 31 de agosto de 2024. Para preservar os dados em contas de armazenamento clássicas, você deve migrá-los para o modelo de implantação do Azure Resource Manager até essa data. Após você migrar a conta, todos os benefícios do modelo de implantação do Azure Resource Manager estarão disponíveis para essa conta. Para saber mais sobre modelos de implantação, confira Resource Manager e implantação clássica.

Este artigo descreve como migrar suas contas de armazenamento clássicas para o modelo de implantação do Azure Resource Manager. Para obter mais informações, consulte Migrar suas contas de armazenamento clássicas para o Azure Resource Manager até 31 de agosto de 2024.

Visão geral do processo de migração

Antes de começar a migração, leia Entenda a migração de conta de armazenamento do modelo de implantação clássico para o Azure Resource Manager para obter uma visão geral do processo.

Para migrar suas contas de armazenamento clássicas, você deve:

1. Identificar todas as contas de armazenamento clássicas em sua assinatura.
2. Localizar e excluir quaisquer artefatos de disco em contas clássicas.
3. Migrar suas contas de armazenamento clássicas.
4. Atualize seus aplicativos para usar APIs de Resource Manager do Azure.

Identificar todas as contas de armazenamento clássicas em sua assinatura

Portal

Para listar as contas de armazenamento clássicas em sua assinatura com o portal do Azure:

1. Navegue até a lista de contas de armazenamento no portal do Azure.

2. Selecione Adicionar filtro. Na caixa de diálogo Filtro, defina o campo Filtro como Tipo e o campo Operador como Igual a. Em seguida, defina o campo Valor como microsoft.classicstorage/storageaccounts.

   

PowerShell

Para listar contas de armazenamento clássicas em sua assinatura com o PowerShell, execute o seguinte comando:

Get-AzResource -ResourceType Microsoft.ClassicStorage/storageAccounts

Localizar e excluir quaisquer artefatos de disco em uma conta clássica

As contas de armazenamento clássicas podem conter discos clássicos (não gerenciados), imagens de máquina virtual e imagens do sistema operacional (SO). Para migrar a conta, será necessário excluir esses artefatos primeiro.

Importante

Se você não excluir artefatos de disco clássicos primeiro, a migração poderá falhar.

Para saber mais sobre a migração de discos não gerenciados para discos gerenciados, consulte Migração de discos não gerenciados para discos gerenciados.

Portal

Para excluir os artefatos de disco do portal do Azure, siga estas etapas:

1. Navegue até o portal do Azure.

2. Na barra Pesquisar na parte superior, pesquise Discos (clássico), Imagens do sistema operacional (clássico)ou Imagens de VM (clássicas) para exibir artefatos de disco clássicos.

3. Localize o artefato de disco clássico a ser excluído e selecione-o para exibir suas propriedades.

4. Selecione o botão Excluir para excluir o artefato de disco.

   

Para obter mais informações sobre erros que podem ocorrer quando você excluir artefatos de disco e como resolvê-los, confira Solucionar erros ao excluir contas de armazenamento clássicas, contêineres ou VHDs do Azure.

PowerShell

Para saber como localizar e excluir artefatos de disco em contas de armazenamento clássicas com o PowerShell, confira Migrar para Resource Manager com o PowerShell.

Migrar uma conta de armazenamento clássica

O processo de migração de uma conta de armazenamento clássica envolve quatro etapas:

1. Validar. Durante a fase de validação, o Azure verifica a conta de armazenamento para garantir que ela possa ser migrada.

2. Preparar. Na fase preparar, o Azure cria uma nova conta de armazenamento de uso geral v1 e alerta você sobre quaisquer problemas que possam ter ocorrido. A nova conta é criada em um novo grupo de recursos na mesma região que sua conta clássica.

   Neste ponto, sua conta de armazenamento clássica continua existindo. Se houver algum problema relatado, você poderá corrigi-los ou anular o processo.

3. Verificar manualmente. É uma boa ideia fazer uma marcar manual da nova conta de armazenamento para garantir que a saída seja a esperada.

4. Confirmar ou anular. Se você estiver satisfeito que a migração foi bem-sucedida, você poderá confirmá-la. Confirmar a migração exclui permanentemente a conta de armazenamento clássica.

   Se houver problemas com a migração, você poderá anular a migração neste momento. Se você optar por anular, o novo grupo de recursos e a nova conta de armazenamento serão excluídos. Sua conta clássica permanece disponível. Você pode resolver quaisquer problemas e tentar a migração novamente.

Para obter mais informações sobre o processo de migração, confira Entender a migração da conta de armazenamento do modelo de implantação clássico para o Azure Resource Manager

Você pode migrar uma conta de armazenamento clássica para o modelo de implantação do Azure Resource Manager com o portal do Azure ou o PowerShell.

Portal

Para migrar uma conta de armazenamento clássica para o modelo de implantação do Azure Resource Manager com o portal do Azure:

1. Navegue até sua conta de armazenamento clássica no portal do Azure.

2. Na seção Configurações, selecione Migrar para o ARM.

3. Selecione Validar para determinar a viabilidade de migração.

   

4. Após uma validação bem-sucedida, selecione o botão Preparar para simular a migração.

5. Se a etapa Preparar for concluída com sucesso, você verá um link para o novo grupo de recursos. Selecione esse link para navegar até o novo grupo de recursos. A conta de armazenamento migrada aparece na guia Recursos na página Visão geral do novo grupo de recursos.

   Neste ponto, você pode comparar a configuração e os dados na conta de armazenamento clássica com a conta de armazenamento recém-migrada. Você verá ambos na lista de contas de armazenamento no portal. Tanto a conta clássica quanto a conta migrada têm o mesmo nome.

   

6. Se você não estiver satisfeito com os resultados da migração, selecione Anular para excluir a nova conta de armazenamento e o grupo de recursos. Em seguida, você pode resolver quaisquer problemas e tentar novamente.

7. Quando estiver pronto para confirmar, digite sim para confirmar e selecione Confirmar para concluir a migração.

Importante

Pode haver um atraso de alguns minutos após a conclusão da validação antes que o botão Preparar seja habilitado.

PowerShell

Para migrar a conta de armazenamento clássica para o modelo de implantação do Azure Resource Manager com o PowerShell, você precisa usar o módulo de Gerenciamento de Serviços do Azure PowerShell. Para saber como instalar esse módulo, confira Instalar e configurar o módulo de Gerenciamento de Serviços do Azure PowerShell. As etapas principais estão incluídas aqui para sua conveniência.

Observação

Os cmdlets no módulo de Gerenciamento de Serviços do Azure destinam-se a gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviço, incluindo as contas de armazenamento clássicas. Esse módulo inclui os comandos necessários para migrar uma conta de armazenamento clássica para o Azure Resource Manager.

Para gerenciar os recursos do Azure Resource Manager, recomendamos que você use o módulo Az PowerShell. O módulo Az está substituindo o módulo AzureRM que foi descontinuado. Para obter mais informações sobre como migrar do módulo AzureRM para o módulo Az, confira Migrar os scripts do Azure PowerShell do AzureRM para o Az.

Primeiro, instale o PowerShellGet, se não o tiver instalado ainda. Para obter mais informações sobre como instalar o PowerShellGet, confira Como instalar o PowerShellGet. Após instalar o PowerShellGet, feche e reabra o console do PowerShell.

A seguir, instale o módulo de Gerenciamento de Serviços do Azure. Se também tiver o módulo AzureRM instalado, você precisará incluir o parâmetro -AllowClobber, conforme descrito na Etapa 2: Instalar o Azure PowerShell. Após a conclusão da instalação, importe o módulo de Gerenciamento de Serviços do Azure.

Install-Module -Name Azure -AllowClobber
Import-Module -Name Azure

Entre na sua conta executando o comando Add-AzureAccount. A seguir, chame o comando Select-AzureSubscription para configurar sua assinatura atual. Lembre-se de substituir os valores do espaço reservado entre colchetes pelo nome da sua assinatura:

Add-AzureAccount
Select-AzureSubscription -SubscriptionName <subscription-name>

Para validar se a conta está pronta para migrar, chame o comando Move-AzureStorageAccount. Lembre-se de substituir os valores de espaço reservado entre colchetes pelo nome da sua conta de armazenamento clássica:

$accountName = "<storage-account>"
Move-AzureStorageAccount -Validate -StorageAccountName $accountName

Em seguida, prepare a conta para migração:

Move-AzureStorageAccount -Prepare -StorageAccountName $accountName

Verifique a configuração da conta de armazenamento preparada com o Azure PowerShell ou o Portal do Azure. Se você não estiver pronto para a migração, use o seguinte comando para reverter sua conta para o estado anterior:

Move-AzureStorageAccount -Abort -StorageAccountName $accountName

Por fim, quando estiver satisfeito com a configuração preparada, prossiga com a migração e confirme os recursos com o seguinte comando:

Move-AzureStorageAccount -Commit -StorageAccountName $accountName

Atualizar seus aplicativos para usar APIs de Resource Manager do Azure

Depois de migrar sua conta de armazenamento clássica para o Azure Resource Manager, você deve atualizar seus aplicativos e scripts para usar APIs de Resource Manager do Azure. O provedor de recursos do Armazenamento do Azure é a implementação do Resource Manager do Azure para o Armazenamento do Microsoft Azure.

O Armazenamento do Azure fornece SDKs para conveniência ao chamar as APIs do provedor de recursos do Armazenamento do Microsoft Azure:

• Biblioteca de clientes de gerenciamento para .NET
• Biblioteca de clientes de gerenciamento para Java
• Biblioteca de clientes de gerenciamento para JavaScript
• Biblioteca de clientes de gerenciamento para Python

Você também pode usar as versões mais recentes do Azure PowerShell e da CLI do Azure para gerenciar suas contas de armazenamento migradas:

• PowerShell do Azure
• CLI do Azure

Para saber mais sobre os provedores de recursos no Azure Resource Manager, consulte Provedores de recursos e tipos de recursos.

Confira também

• Migrar suas contas de armazenamento clássicas para o Azure Resource Manager até 31 de agosto de 2024
• Entenda a migração da conta de armazenamento do modelo de implantação clássico para o Azure Resource Manager