Suppressions automatiques de l’historique de déploiement

Lorsque vous déployez des ressources sur Azure, les détails du déploiement sont enregistrés dans l’historique de déploiement dans l’étendue où le déploiement se produit. Chaque étendue, qu’il s’agisse d’un groupe de ressources, d’un abonnement, d’un groupe d’administration, d’un locataire, peut stocker jusqu’à 800 déploiements dans son historique. Une fois cette limite atteinte, Azure supprime automatiquement les déploiements les plus anciens pour en faire de nouveaux. Ce processus de nettoyage automatique a été implémenté le 6 août 2020.

Remarque

La suppression d'un déploiement de l'historique n'a aucun impact sur les ressources déployées.

Vue d’ensemble des suppressions automatiques de l’historique de déploiement

Les déploiements sont supprimés de votre historique lorsque vous dépassez 700 déploiements. Azure Resource Manager en supprime jusqu’à ce que l’historique descende à 600. Les déploiements les plus anciens sont toujours supprimés en premier.

Important

Si votre étendue est déjà à la limite de 800, votre prochain déploiement échoue avec une erreur. Le processus de suppression automatique démarre immédiatement. Vous pouvez réessayer votre déploiement après une brève attente.

En plus des déploiements, vous déclenchez également des suppressions lorsque vous exécutez l’opération de simulation ou validez un déploiement.

Lorsque vous donnez à un déploiement le même nom qu’un autre dans l’historique, vous réinitialisez sa place dans l’historique. Le déploiement passe au rang le plus récent dans l’historique. Vous pouvez également réinitialiser le rang d’un déploiement lorsque vous restaurer ce déploiement après une erreur.

Autorisations requises pour les suppressions automatiques

Les suppressions sont demandées sous l’identité de l’utilisateur qui a déployé le modèle. Pour supprimer des déploiements, l’utilisateur doit avoir accès à l’action Microsoft.Resources/deployments/delete. Si l’utilisateur ne dispose pas des autorisations requises, les déploiements ne sont pas supprimés de l’historique.

Si l’utilisateur actuel ne dispose pas des autorisations requises, la suppression automatique est tentée à nouveau lors du déploiement suivant.

Gestion des verrous de ressources

Si vous disposez d’un verrou CanNotDelete sur un groupe de ressources ou un abonnement, les déploiements pour cette étendue ne peuvent pas être supprimés automatiquement. Pour activer le nettoyage automatique de l’historique de déploiement, vous devez supprimer le verrou.

Pour supprimer un verrou de groupe de ressources, exécutez les commandes suivantes :

PowerShell

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

Pour supprimer un verrou de groupe de ressources, exécutez les commandes suivantes :

Azure CLI

lockid=$(az lock show --resource-group lockedRG --name deleteLock --output tsv --query id)
az lock delete --ids $lockid

Se reposer

DELETE https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Authorization/locks/{lockName}?api-version=2016-09-01

Désactivation des suppressions automatiques

Vous pouvez refuser la suppression automatique pour gérer manuellement votre historique de déploiement. Utilisez cette option avec prudence, car la limite de déploiement 800 reste appliquée et le dépassement entraîne des échecs de déploiement.

Important

La désactivation est disponible uniquement pour les étendues d’abonnement, car elle est contrôlée par l’indicateur de fonctionnalité au niveau de l’abonnement Microsoft.Resources/DisableDeploymentGrooming. Vous ne pouvez pas refuser uniquement pour un groupe de ressources particulier. Pour les étendues de locataire ou de groupe d’administration, ouvrez un ticket de support pour désactiver la suppression automatique.

Pour désactiver la suppression automatique au niveau de l’étendue de l’abonnement (affecte tous les groupes de ressources qu’il contient) :

PowerShell

Pour PowerShell, utilisez Register-AzProviderFeature.

Register-AzProviderFeature -ProviderNamespace Microsoft.Resources -FeatureName DisableDeploymentGrooming

Pour afficher l’état actuel de votre abonnement, utilisez :

Get-AzProviderFeature -ProviderNamespace Microsoft.Resources -FeatureName DisableDeploymentGrooming

Pour réactiver les suppressions automatiques, utilisez l’API REST Azure ou Azure CLI.

Azure CLI

Pour Azure CLI, utilisez az feature register.

az feature register --namespace Microsoft.Resources --name DisableDeploymentGrooming

Pour afficher l’état actuel de votre abonnement, utilisez :

az feature show --namespace Microsoft.Resources --name DisableDeploymentGrooming

Pour réactiver les suppressions automatiques, utilisez az Feature Unregister.

az feature unregister --namespace Microsoft.Resources --name DisableDeploymentGrooming

Se reposer

Pour l’API REST, utilisez Fonctionnalités – Inscrire.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/Microsoft.Resources/features/DisableDeploymentGrooming/register?api-version=2015-12-01

Pour afficher l’état actuel de votre abonnement, utilisez :

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/Microsoft.Resources/features/DisableDeploymentGrooming/register?api-version=2015-12-01

Pour réactiver les suppressions automatiques, utilisez fonctionnalités - annuler l’inscription

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Features/providers/Microsoft.Resources/features/DisableDeploymentGrooming/unregister?api-version=2015-12-01

Étapes suivantes

• Pour en savoir plus sur l’affichage de l’historique des déploiements, consultez Afficher l’historique des déploiements avec Azure Resource Manager.