Exclusão de recursos e grupo de recursos do Azure Resource Manager

Artigo
10/05/2023

Este artigo mostra como excluir recursos e grupos de recursos. Ele descreve como o Azure Resource Manager ordena a exclusão de recursos quando você exclui um grupo de recursos.

Como a ordem de exclusão é determinada

Quando você exclui um grupo de recursos, o Gerenciador de Recursos determina a ordem para excluir recursos. Ele usa a seguinte ordem:

Todos os recursos filho (aninhados) são excluídos.
Recursos que gerenciam outros recursos são excluídos a seguir. Um recurso pode ter a propriedade managedBy definida para indicar que um recurso diferente a gerencia. Quando essa propriedade é configurada, o recurso que gerencia o outro recurso é excluído antes dos outros recursos.
Os recursos restantes são excluídos após as duas categorias anteriores.

Depois que o pedido é determinado, o Gerenciador de recursos emite uma operação DELETE para cada recurso. Aguarda que quaisquer dependências terminem antes de prosseguir.

Para operações síncronas, os códigos de resposta bem-sucedidos esperados são:

Para operações assíncronas, a resposta bem-sucedida esperada é 202. O Gerenciador de Recursos rastreia o cabeçalho do local ou o cabeçalho da operação azure-async para determinar o status da operação de exclusão assíncrona.

Erros de exclusão

Quando uma operação de exclusão retorna um erro, o Gerenciador de Recursos repete a chamada DELETE. As novas tentativas ocorrem para os códigos de status 5xx, 429 e 408. Por padrão, o período de repetição é de 15 minutos.

Após a exclusão

Gerenciador de recursos emite uma chamada GET em cada recurso que ele tentou excluir. Espera-se que a resposta desta chamada GET seja 404. Quando o Gerenciador de Recursos recebe um erro 404, ele considera a exclusão concluída com êxito. O Gerenciador de recursos remove o recurso do cache.

No entanto, se a chamada GET no recurso retornar um 200 ou 201, o Gerenciador de recursos recria o recurso.

Se a operação GET retornar um erro, o Gerenciador de Recursos tentará novamente o GET para o seguinte código de erro:

Menos de 100
408
429
Maior que 500

Para outros códigos de erro, o Gerenciador de Recursos falha na exclusão do recurso.

Importante

A exclusão do grupo de recursos é irreversível.

Excluir grupo de recursos

Use um dos seguintes métodos para excluir o grupo de recursos.

Remove-AzResourceGroup -Name ExampleResourceGroup

az group delete --name ExampleResourceGroup

import os
from azure.identity import AzureCliCredential
from azure.mgmt.resource import ResourceManagementClient

credential = AzureCliCredential()
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]

resource_client = ResourceManagementClient(credential, subscription_id)

rg_result = resource_client.resource_groups.begin_delete("exampleGroup")

Excluir recurso

Use um dos seguintes métodos para excluir um recursos.

Remove-AzResource `
  -ResourceGroupName ExampleResourceGroup `
  -ResourceName ExampleVM `
  -ResourceType Microsoft.Compute/virtualMachines

az resource delete \
  --resource-group ExampleResourceGroup \
  --name ExampleVM \
  --resource-type "Microsoft.Compute/virtualMachines"

import os
from azure.identity import AzureCliCredential
from azure.mgmt.resource import ResourceManagementClient

credential = AzureCliCredential()
subscription_id = os.environ["AZURE_SUBSCRIPTION_ID"]

resource_client = ResourceManagementClient(credential, subscription_id)

resource_client.resources.begin_delete_by_id(
    "/subscriptions/{}/resourceGroups/{}/providers/{}/{}".format(
        subscription_id,
        "exampleGroup",
        "Microsoft.Compute",
        "virtualMachines/exampleVM"
    ),
    "2022-11-01"
)

Falhas de acesso e exclusão necessárias

Para excluir um grupo de recursos, você precisa de acesso à ação de exclusão do recurso Microsoft.Resources/subscriptions/resourceGroups.

Importante

A única permissão necessária para excluir um grupo de recursos é a permissão para a ação de exclusão para excluir grupos de recursos. Você não precisa de permissão para excluir recursos individuais dentro desse grupo de recursos. Além disso, as ações de exclusão especificadas em notActions para um roleAssignment são substituídas pela ação de exclusão do grupo de recursos. Isso é consistente com a hierarquia de escopo no modelo de controle de acesso baseado em função do Azure.

Para obter uma lista de operações, confira Operações do provedor de recursos do Azure. Para obter uma lista de todas as funções internas, confira Funções internas do Azure.

Se você tiver o acesso necessário, mas a solicitação de exclusão falhar, talvez seja porque há um bloqueio de recursos no grupo de recursos. Mesmo que você não tenha bloqueado manualmente um grupo de recursos, um serviço relacionado pode tê-lo bloqueado automaticamente. Ou a exclusão poderá falhar se os recursos estão conectados a recursos em outros grupos de recursos que não estão sendo excluídos. Por exemplo, você não pode excluir uma rede virtual com sub-redes que ainda estão em uso por uma máquina virtual.

Posso recuperar um grupo de recursos excluído?

Não, você não pode recuperar um grupo de recursos excluído. No entanto, talvez você consiga recuperar alguns recursos excluídos recentemente.

Alguns tipos de recursos dão suporte à exclusão reversível. Talvez seja necessário configurar a exclusão reversível para usá-la. Para obter informações sobre como habilitar a exclusão temporária, confira:

Para restaurar recursos excluídos, confira:

Você também pode abrir um caso de Suporte do Azure. Forneça o máximo possível de detalhes sobre os recursos excluídos, incluindo seus IDs, tipos e nomes de recursos. Solicite que o engenheiro de suporte verifique se os recursos podem ser restaurados.

Observação

Nem sempre é possível recuperar recursos excluídos. Um engenheiro de suporte investigará seu cenário e aconselhará se é possível.

Próximas etapas

Para reconhecer os conceitos do Gerenciador de Recursos, consulte Visão geral do Azure Resource Manager.
Para comandos de exclusão, consulte PowerShell, CLI do Azure e API REST.