Como migrar as 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 qualquer conta de armazenamento clássica, você deve migrá-los para o modelo de implantação do Azure Resource Manager até essa data. Depois de migrar sua conta, todos os benefícios do modelo de implantação do Azure Resource Manager estarão disponíveis para essa conta. Para obter mais informações sobre os modelos de implantação, consulte Gerenciador de recursos 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ássico 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 Compreender a migração da 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. Identifique as contas de armazenamento clássicas na sua subscrição.
2. Localize e exclua todos os artefatos de disco em contas clássicas.
3. Migre suas contas de armazenamento clássicas.
4. Atualize seus aplicativos para usar as APIs do Azure Resource Manager.

Identificar contas de armazenamento clássicas na sua subscrição

Portal

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

1. Navegue para a lista das suas 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. 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áquinas virtuais e imagens do sistema operacional (SO). Para migrar a conta, você precisará 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 como migrar discos não gerenciados para discos gerenciados, consulte Migrando discos não gerenciados para discos gerenciados.

Portal

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

1. Navegue para o portal do Azure.

2. Na barra de pesquisa na parte superior, procure por Discos (clássico), Imagens do SO (clássico) ou Imagens de VM (clássico) 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 ao excluir artefatos de disco e como resolvê-los, consulte Solucionar erros ao excluir contas de armazenamento clássico do Azure, contêineres ou VHDs.

PowerShell

Para saber como localizar e excluir artefatos de disco em contas de armazenamento clássicas com o PowerShell, consulte Migrar para o Gerenciador de Recursos 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. Prepare-se. Na fase Preparar, o Azure cria uma nova conta de armazenamento v1 de uso geral e alerta-o para quaisquer problemas que possam ter ocorrido. A nova conta é criada em um novo grupo de recursos na mesma região da sua conta clássica.

   Neste ponto, sua conta de armazenamento clássica ainda existe. Se houver algum problema relatado, você pode corrigi-los ou abortar o processo.

3. Verifique manualmente. É uma boa ideia fazer uma verificação manual da nova conta de armazenamento para se certificar de que a saída está conforme o esperado.

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

   Se houver algum problema com a migração, você poderá abortá-la neste momento. Se você optar por anular, o novo grupo de recursos e a nova conta de armazenamento serão excluídos. A 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, consulte Compreender a migração da conta de armazenamento do modelo de implantação clássico para o Azure Resource Manager

Nota

Contas deixadas em um estado de migração Preparar mais 30 dias podem ter suas migrações confirmadas em seu nome. Se precisar de mais de 30 dias para validar sua migração para o Azure Resource Manager, você poderá abortar a migração atual e reiniciá-la quando estiver pronto.

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 ARM.

3. Selecione Validar para determinar a viabilidade da 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 êxito, 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 não estiver satisfeito com os resultados da migração, selecione Anular para excluir a nova conta de armazenamento e o novo 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 ativado.

PowerShell

Para migrar uma conta de armazenamento clássica para o modelo de implantação do Azure Resource Manager com o PowerShell, você deve usar o módulo Azure PowerShell Service Management. Para saber como instalar este módulo, consulte Instalar e configurar o módulo Azure PowerShell Service Management. Os principais passos estão incluídos aqui por conveniência.

Nota

Os cmdlets no módulo Azure Service Management são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços, incluindo contas de armazenamento clássicas. Este módulo inclui os comandos necessários para migrar uma conta de armazenamento clássica para o Azure Resource Manager.

Para gerenciar recursos do Azure Resource Manager, recomendamos que você use o módulo Az PowerShell. O módulo Az substitui o módulo AzureRM preterido. Para obter mais informações sobre como mover do módulo AzureRM para o módulo Az, consulte Migrar scripts do Azure PowerShell do AzureRM para Az.

Primeiro, instale o PowerShellGet se ainda não o tiver instalado. Para obter mais informações sobre como instalar o PowerShellGet, consulte Instalando o PowerShellGet. Depois de instalar o PowerShellGet, feche e reabra o console do PowerShell.

Em seguida, instale o módulo Azure Service Management. Se você também tiver o módulo AzureRM instalado, precisará incluir o parâmetro, conforme descrito em Etapa 2: Instalar o -AllowClobber Azure PowerShell. Após a conclusão da instalação, importe o módulo Azure Service Management.

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

Faça login na sua conta executando Add-AzureAccount. Em seguida, chame Select-AzureSubscription para definir sua assinatura atual. Lembre-se de substituir os valores de 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 migração, 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 a 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

Finalmente, quando estiver satisfeito com a configuração preparada, avance com a migração e confirme os recursos com o seguinte comando:

Move-AzureStorageAccount -Commit -StorageAccountName $accountName

Atualize seus aplicativos para usar APIs do Azure Resource Manager

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

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

• Biblioteca de cliente de gerenciamento para .NET
• Biblioteca de cliente de gerenciamento para Java
• Biblioteca de cliente de gerenciamento para JavaScript
• Biblioteca de cliente 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:

• Azure PowerShell
• CLI do Azure

Para saber mais sobre provedores de recursos no Gerenciador de Recursos do Azure, consulte Provedores de recursos e tipos de recursos.

Consulte também

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