Partilhar via

Eliminações automáticas do histórico de implementações

Quando você implanta recursos no Azure, os detalhes da implantação são registrados no histórico de implantação no escopo em que a implantação ocorre. Cada escopo, seja um grupo de recursos, assinatura, grupo de gestão, locatário, pode armazenar até 800 implantações no seu histórico. Quando esse limite é atingido, o Azure exclui automaticamente as implantações mais antigas para abrir espaço para as novas. Este processo de limpeza automática foi implementado em 6 de agosto de 2020.

Nota

Eliminar uma implementação do histórico não afeta nenhum dos recursos que foram implementados.

Visão geral das exclusões automáticas do histórico de implantação

As implantações são excluídas do seu histórico quando você excede 700 implantações. O Azure Resource Manager exclui implantações até que o histórico seja reduzido para 600. As implantações mais antigas são sempre excluídas primeiro.

Diagrama de exclusão do histórico de implantação.

Importante

Se o escopo já estiver no limite de 800, sua próxima implantação falhará com um erro. O processo de exclusão automática começa imediatamente. Você pode tentar sua implantação novamente após uma curta espera.

Além das implantações, você também aciona exclusões quando executa a operação hipotética ou valida uma implantação.

Quando você dá a uma implantação o mesmo nome que uma no histórico, você redefine seu lugar no histórico. A implantação passa para o lugar mais recente da história. Você também redefine o local de uma implantação quando reverte para essa implantação após um erro.

Permissões necessárias para exclusões automáticas

As exclusões são solicitadas sob a identidade do usuário que implantou o modelo. Para excluir implantações, o usuário deve ter acesso à ação Microsoft.Resources/deployments/delete . Se o usuário não tiver as permissões necessárias, as implantações não serão excluídas do histórico.

Se o usuário atual não tiver as permissões necessárias, a exclusão automática será tentada novamente durante a próxima implantação.

Manipulando bloqueios de recursos

Se você tiver um bloqueio CanNotDelete em um grupo de recursos ou uma assinatura, as implantações desse escopo não poderão ser excluídas automaticamente. Para habilitar a limpeza automática do histórico de implantação, você precisa remover o bloqueio.

Para excluir um bloqueio de grupo de recursos, execute os seguintes comandos:

$lockId = (Get-AzResourceLock -ResourceGroupName lockedRG).LockId
Remove-AzResourceLock -LockId $lockId

Para excluir um bloqueio de grupo de recursos, execute os seguintes comandos:

Desativação de exclusões automáticas

Você pode desativar a exclusão automática para gerenciar manualmente seu histórico de implantação. Use essa opção com cautela, pois o limite de 800 implantações permanece imposto, e excedê-lo causa falhas de implantação.

Importante

A desativação está disponível apenas para escopos de subscrição, pois é controlada pelo indicador da funcionalidade ao nível da subscrição Microsoft.Resources/DisableDeploymentGrooming. Não pode optar por não participar apenas num grupo de recursos específico. Para âmbitos de arrendatário ou grupo de gestão, abra um tíquete de suporte para desativar a eliminação automática.

Para desativar a exclusão automática no escopo da assinatura (afeta todos os grupos de recursos dentro dela):

Para PowerShell, use Register-AzProviderFeature.

Register-AzProviderFeature -ProviderNamespace Microsoft.Resources -FeatureName DisableDeploymentGrooming

Para ver o estado atual da sua subscrição, utilize:

Get-AzProviderFeature -ProviderNamespace Microsoft.Resources -FeatureName DisableDeploymentGrooming

Para reativar exclusões automáticas, use a API REST do Azure ou a CLI do Azure.

Próximos passos