Résoudre les erreurs liées aux ressources introuvables

Article
06/20/2024

Cet article décrit l’erreur que vous rencontrez quand une ressource est introuvable au cours d’une opération. En règle générale, vous voyez cette erreur lors du déploiement de ressources avec un fichier Bicep ou un modèle Azure Resource Manager (modèle ARM). Elle peut aussi survenir quand vous effectuez des tâches de gestion et que Azure Resource Manager ne trouve pas la ressource nécessaire. Par exemple, si vous essayez d’ajouter des étiquettes à une ressource qui n’existe pas, vous obtenez cette erreur.

Symptômes

Deux codes d’erreur indiquent que la ressource est introuvable. L’erreur NotFound retourne un résultat qui se présente comme ceci :

Code=NotFound;
Message=Cannot find ServerFarm with name exampleplan.

L’erreur ResourceNotFound retourne un résultat qui se présente comme ceci :

Code=ResourceNotFound;
Message=The Resource 'Microsoft.Storage/storageAccounts/{storage name}' under resource
group {resource group name} was not found.

Cause

Resource Manager a besoin de récupérer les propriétés d’une ressource, mais ne trouve pas la ressource dans votre abonnement.

Solution 1 : Vérifier les propriétés de la ressource

Quand vous obtenez cette erreur pendant que vous effectuez une tâche de gestion, vérifiez les valeurs que vous spécifiez pour la ressource. Les trois valeurs à vérifier sont les suivantes :

Nom de la ressource
Nom de groupe ressources
Abonnement

Si vous utilisez PowerShell ou Azure CLI, vérifiez que vous exécutez bien la commande dans l’abonnement qui contient la ressource. Vous pouvez changer d’abonnement avec Set-AzContext ou az account set. De nombreuses commandes proposent un paramètre d’abonnement qui vous permet de spécifier un abonnement différent du contexte actuel.

Si vous ne pouvez pas vérifier les propriétés, connectez-vous au Portail Microsoft Azure. Recherchez la ressource que vous essayez d’utiliser et examinez le nom de la ressource, le groupe de la ressource et l’abonnement.

Solution 2 : Définir des dépendances

Si vous obtenez cette erreur pendant le déploiement d’un modèle, il peut être nécessaire d’ajouter une dépendance. Resource Manager optimise les déploiements en créant des ressources en parallèle, quand cela est possible.

Par exemple, quand vous déployez une application web, le plan App Service doit être présent. Si vous n’avez pas spécifié que l’application web est dépendante du plan App Service, Resource Manager crée les deux ressources en même temps. L’application web échoue avec une erreur qui signifie que la ressource du plan App Service est introuvée, car elle n’existe pas encore. Vous pouvez éviter cette erreur en définissant une dépendance dans l’application web.

Bicep
JSON

Utilisez une dépendance implicite plutôt que la fonction resourceId. La dépendance est créée à l’aide du nom symbolique et de la propriété d’ID d’une ressource .

Par exemple, la propriété de l’application web serverFarmId utilise servicePlan.id pour créer une dépendance sur le plan App Service.

resource webApp 'Microsoft.Web/sites@2022-03-01' = {
  properties: {
    serverFarmId: servicePlan.id
  }
}

resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' = {
  name: hostingPlanName
  ...

Pour la plupart des déploiements, il n’est pas nécessaire d’utiliser dependsOn pour créer une dépendance explicite.

Évitez de définir des dépendances qui ne sont pas nécessaires. Les dépendances inutiles allongent la durée du déploiement, car les ressources ne sont pas déployées en parallèle. Par ailleurs, il se peut que créiez des dépendances circulaires qui bloquent le déploiement.

Si une ressource doit être déployée après une autre ressource, utilisez l’élément dependsOn de votre modèle.

{
  "type": "Microsoft.Web/sites",
  "apiVersion": "2022-03-01",
  "dependsOn": [
    "[variables('hostingPlanName')]"
  ],
  ...
}

Les fonctions reference et list* créent une dépendance implicite envers la ressource référencée, lorsque cette ressource est déployée dans le même modèle et référencée par son nom (et non l’ID de la ressource). Il se peut donc que vous ayez des dépendances en plus des dépendances spécifiées dans la propriété dependsOn.

La fonction resourceId ne crée pas de dépendance implicite pas plus qu’elle ne valide l’existence de la ressource. La fonction reference et les fonctions list* ne créent pas de dépendance implicite lorsque la ressource est référencée par son ID. Pour créer une dépendance implicite, transmettez le nom de la ressource qui est déployée dans le même modèle.

Ordre de déploiement

Si vous observez des problèmes de dépendance, vous devez déterminer l’ordre de déploiement des ressources. Vous pouvez utiliser le portail pour afficher l’ordre des opérations de déploiement :

Connectez-vous au portail.
Dans la vue d’ensemble du groupe de ressources, sélectionnez le lien pour l’historique du déploiement.
Pour le nom du déploiement à passer en revue, sélectionnez Événements connexes.
Examinez la séquence d’événements de chaque ressource. Faites attention à l’état de chaque opération et à l’horodaage. Par exemple, l’image suivante montre trois comptes de stockage déployés en parallèle. Remarquez que les trois déploiements de compte de stockage ont démarré en même temps.

L’image suivante montre trois comptes de stockage non déployés en parallèle. Le deuxième compte de stockage dépend du premier compte de stockage, et le troisième du deuxième. Le premier compte de stockage est étiqueté Démarré, Accepté et Réussi avant le début du suivant.

Solution 3 : Obtenir une ressource externe

Bicep
JSON

Bicep utilise le nom symbolique pour créer une dépendance implicite sur une autre ressource. Le mot clé existant fait référence à une ressource déployée. Si une ressource existante se trouve dans un groupe de ressources différent de celui de la ressource que vous voulez déployer, incluez l’étendue et utilisez la fonction resourceGroup.

Dans cet exemple, une application web est déployée et utilise un plan App Service existant d’un autre groupe de ressources.

resource servicePlan 'Microsoft.Web/serverfarms@2022-03-01' existing = {
  name: hostingPlanName
  scope: resourceGroup(rgname)
}

resource webApp 'Microsoft.Web/sites@2022-03-01' = {
  name: siteName
  properties: {
    serverFarmId: servicePlan.id
  }
}

Quand vous déployez un modèle et que vous devez obtenir une ressource qui existe dans un abonnement ou un groupe de ressources différent, utilisez la fonction resourceId. Cette fonction retourne le nom complet de la ressource.

Les paramètres d’abonnement et de groupe de ressources de la fonction resourceId sont facultatifs. Si vous ne les spécifiez pas, ils indiquent par défaut l’abonnement et le groupe de ressources actuels. Quand vous utilisez une ressource située dans un groupe de ressources ou un abonnement différent, veillez à fournir ces valeurs.

L’exemple suivant obtient l’ID d’une ressource qui appartient à un groupe de ressources différent.

"properties": {
  "name": "[parameters('siteName')]",
  "serverFarmId": "[resourceId('plangroup', 'Microsoft.Web/serverfarms', parameters('hostingPlanName'))]"
}

Solution 4 : Obtenir une identité managée à partir d'une ressource

Bicep
JSON

Si vous déployez une ressource qui crée une identité managée, vous devez attendre que cette ressource soit déployée avant de récupérer des valeurs sur l'identité managée. Utilisez une dépendance implicite pour la ressource à laquelle l’identité est appliquée. Cette approche garantit que la ressource et l'identité gérée seront déployées avant que Resource Manager n’utilise la dépendance.

Vous pouvez obtenir l’ID du principal et l’ID de locataire pour une identité gérée appliquée à une machine virtuelle. Par exemple, si une ressource de machine virtuelle a un nom symbolique vm, utilisez la syntaxe suivante :

vm.identity.principalId

vm.identity.tenantId

Si vous déployez une ressource qui crée une identité managée, vous devez attendre que cette ressource soit déployée avant de récupérer des valeurs sur l'identité managée. Si vous transmettez le nom de l'identité managée à la fonction reference, Resource Manager tente de résoudre la référence avant que la ressource et l'identité ne soient déployées. Transmettez plutôt le nom de la ressource à laquelle l'identité est appliquée. Cette approche garantit que la ressource et l'identité gérée seront déployées avant que Resource Manager ne résolve la fonction reference.

Dans la fonction reference, utilisez Full pour obtenir toutes les propriétés, y compris l'identité managée.

Le modèle est :

"[reference(resourceId(<resource-provider-namespace>, <resource-name>), <API-version>, 'Full').Identity.propertyName]"

Important

N’utilisez pas le modèle :

"[reference(concat(resourceId(<resource-provider-namespace>, <resource-name>),'/providers/Microsoft.ManagedIdentity/Identities/default'),<API-version>).principalId]"

Votre modèle échouera.

Par exemple, pour obtenir l'ID de principal d'une identité managée appliquée à une machine virtuelle, utilisez :

"[reference(resourceId('Microsoft.Compute/virtualMachines', variables('vmName')), '2022-03-01', 'Full').identity.principalId]",

Ou, pour obtenir l'ID de locataire d'une identité managée appliquée à un groupe de machines virtuelles identiques, utilisez :

"[reference(resourceId('Microsoft.Compute/virtualMachineScaleSets',  variables('vmNodeType0Name')), '2022-03-01', 'Full').Identity.tenantId]"

Vous pouvez utiliser le nom symbolique d’une ressource pour obtenir des valeurs d’une ressource. Vous pouvez référencer un compte de stockage dans le même groupe de ressources ou un autre groupe de ressources en utilisant un nom symbolique. Pour obtenir une valeur d’une ressource déployée, utilisez le mot clé existant. Si une ressource se trouve dans un autre groupe de ressources, utilisez scope avec la fonction resourceGroup. Dans la plupart des cas, la fonction reference n’est pas nécessaire.

L’exemple suivant référence un compte de stockage existant dans un autre groupe de ressources.

resource stgAcct 'Microsoft.Storage/storageAccounts@2022-05-01' existing = {
  name: stgname
  scope: resourceGroup(rgname)
}

Quand vous déployez un modèle, recherchez des expressions qui utilisent les fonctions reference ou listKeys. Les valeurs que vous fournissez varient selon si la ressource fait partie des mêmes modèle, groupe de ressources et abonnement. Vérifiez que vous fournissez les valeurs de paramètres nécessaires pour votre scénario. Si la ressource se trouve dans un autre groupe de ressources, fournissez l’ID complet de la ressource. Par exemple, pour faire référence à un compte de stockage dans un autre groupe de ressources, utilisez :

"[reference(resourceId('exampleResourceGroup', 'Microsoft.Storage/storageAccounts', 'myStorage'), '2022-05-01')]"

Solution 6 : Après la suppression de la ressource

Lorsque vous supprimez une ressource, la durée d’apparition de la ressource dans le portail peut être courte, mais elle n’est pas disponible. Si vous sélectionnez la ressource, vous verrez un message d’erreur indiquant que la ressource est introuvable.

Capture d'écran du portail Azure montrant une ressource supprimée avec un message d'erreur « Not found » dans la section Vue d’ensemble de la ressource.

Actualisez le portail et la ressource supprimée doit être supprimée de votre liste de ressources disponibles. Si une ressource supprimée continue d’être affichée comme disponible pendant plus de quelques minutes, contactez le support.

Partager via