Risolvere gli errori per la risorsa non trovata

Questo articolo descrive l'errore visualizzato quando non è possibile trovare una risorsa durante un'operazione. In genere, questo errore viene visualizzato durante la distribuzione di risorse con un file Bicep o un modello di Azure Resource Manager (modello arm). Questo errore viene visualizzato anche quando si eseguono attività di gestione e Azure Resource Manager non riesce a trovare la risorsa necessaria. Ad esempio, se si tenta di aggiungere tag a una risorsa che non esiste, viene visualizzato questo errore.

Sintomi

Esistono due codici di errore che indicano che la risorsa non è stata trovata. L'errore NotFound restituisce un risultato simile a:

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

L'errore ResourceNotFound restituisce un risultato simile a:

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

Causa

Resource Manager deve recuperare le proprietà per una risorsa, ma non è possibile trovare la risorsa nella sottoscrizione.

Soluzione 1: Controllare le proprietà delle risorse

Quando viene visualizzato questo errore durante l'esecuzione di un'attività di gestione, controllare i valori specificati per la risorsa. I tre valori da controllare sono:

• Nome risorsa
• Nome del gruppo di risorse
• Subscription

Se si usa PowerShell o l'interfaccia della riga di comando di Azure, verificare di eseguire i comandi nella sottoscrizione che contiene la risorsa. È possibile modificare la sottoscrizione con Set-AzContext o az account set. Molti comandi forniscono un parametro di sottoscrizione che consente di specificare una sottoscrizione diversa rispetto al contesto corrente.

Se non è possibile verificare le proprietà, accedere al portale di Azure Microsoft. Trovare la risorsa che si sta provando a usare ed esaminare il nome della risorsa, il gruppo di risorse e la sottoscrizione.

Soluzione 2: Impostare le dipendenze

Se si verifica questo errore durante la distribuzione di un modello, potrebbe essere necessario aggiungere una dipendenza. Resource Manager ottimizza le distribuzioni creando risorse in parallelo, quando possibile.

Ad esempio, quando si distribuisce un'app Web, il piano di servizio app deve esistere. Se non è stato specificato che l'app Web dipende dal piano di servizio app, Resource Manager crea entrambe le risorse contemporaneamente. L'app Web ha esito negativo e viene visualizzato un errore che indica che la risorsa del piano di servizio app non è ancora stata trovata perché non esiste già. Per evitare questo errore, impostare una dipendenza nell'app Web.

Bicep

Usare una dipendenza implicita anziché la funzione resourceId . La dipendenza viene creata usando il nome simbolico e la proprietà ID di una risorsa.

Ad esempio, la proprietà dell'app serverFarmId Web usa servicePlan.id per creare una dipendenza dal piano servizio app.

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

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

Per la maggior parte delle distribuzioni, non è necessario usare dependsOn per creare una dipendenza esplicita.

Evitare di impostare le dipendenze non necessarie. Le dipendenze non necessarie prolungare la durata della distribuzione perché le risorse non vengono distribuite in parallelo. È anche possibile creare dipendenze circolari che bloccano la distribuzione.

JSON

Se una risorsa deve essere distribuita dopo un'altra risorsa, usare l'elemento dependsOn nel modello.

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

Evitare di impostare le dipendenze non necessarie. Le dipendenze non necessarie prolungare la durata della distribuzione perché le risorse non vengono distribuite in parallelo. È anche possibile creare dipendenze circolari che bloccano la distribuzione.

Le funzioni reference e list* creano una dipendenza implicita dalla risorsa a cui si fa riferimento, quando tale risorsa viene distribuita nello stesso modello e viene fatto riferimento al nome (non all'ID risorsa). Pertanto, potrebbero essere presenti più dipendenze rispetto alle dipendenze specificate nella dependsOn proprietà .

La funzione resourceId non crea una dipendenza implicita né esegue la convalida dell'esistenza della risorsa. Le funzioni reference e list* non creano una dipendenza implicita se si fa riferimento alla risorsa tramite l'ID risorsa. Per creare una dipendenza implicita, passare il nome della risorsa distribuita nello stesso modello.

Ordine di distribuzione

In caso di problemi relativi alle dipendenze, è necessario esaminare in modo approfondito l'ordine di distribuzione delle risorse. È possibile usare il portale per visualizzare l'ordine delle operazioni di distribuzione:

1. Accedere al portale.

2. Nella panoramica del gruppo di risorse selezionare il collegamento per la cronologia di distribuzione.

   

3. Per Nome distribuzione da rivedere selezionare Eventi correlati.

   

4. Esaminare la sequenza degli eventi per ogni risorsa. Prestare attenzione allo stato di ogni operazione ed è timestamp. Ad esempio, l'immagine seguente mostra tre account di archiviazione distribuiti in parallelo. Si noti che le tre distribuzioni dell'account di archiviazione vengono avviate contemporaneamente.

   

   L'immagine successiva mostra tre account di archiviazione che non vengono distribuiti in parallelo. Il secondo account di archiviazione dipende dal primo e il terzo account di archiviazione dipende dal secondo. Il primo account di archiviazione è denominato Started, Accepted e Succeeded prima dell'avvio successivo.

   

Soluzione 3: Ottenere una risorsa esterna

Bicep

Bicep usa il nome simbolico per creare una dipendenza implicita da un'altra risorsa. La parola chiave esistente fa riferimento a una risorsa distribuita. Se una risorsa esistente si trova in un gruppo di risorse diverso rispetto alla risorsa da distribuire, includere l'ambito e usare la funzione resourceGroup .

In questo esempio viene distribuita un'app Web che usa un piano di servizio app esistente da un altro gruppo di risorse.

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
  }
}

JSON

Quando si distribuisce un modello ed è necessario ottenere una risorsa esistente in una sottoscrizione o in un gruppo di risorse diverso, usare la funzione resourceId. Questa funzione restituisce il nome completo della risorsa.

I parametri della sottoscrizione e del gruppo di risorse nella resourceId funzione sono facoltativi. Se non vengono forniti, vengono usati per impostazione predefinita per la sottoscrizione corrente e il gruppo di risorse. Quando si usa una risorsa in un gruppo di risorse o una sottoscrizione diversa, assicurarsi di specificare tali valori.

L'esempio seguente ottiene l'ID risorsa per una risorsa presente in un gruppo di risorse diverso.

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

Soluzione 4: Ottenere l'identità gestita dalla risorsa

Bicep

Se si distribuisce una risorsa con un'identità gestita, è necessario attendere che tale risorsa venga distribuita prima di recuperare i valori nell'identità gestita. Usare una dipendenza implicita per la risorsa a cui viene applicata l'identità. Questo approccio garantisce che la risorsa e l'identità gestita vengano distribuite prima che Resource Manager usi la dipendenza.

È possibile ottenere l'ID entità e l'ID tenant per un'identità gestita applicata a una macchina virtuale. Ad esempio, se una risorsa macchina virtuale ha un nome simbolico di vm, usare la sintassi seguente:

vm.identity.principalId

vm.identity.tenantId

JSON

Se si distribuisce una risorsa con un'identità gestita, è necessario attendere che tale risorsa venga distribuita prima di recuperare i valori nell'identità gestita. Se si passa il nome dell'identità gestita alla funzione di riferimento, Resource Manager tenta di risolvere il riferimento prima della distribuzione della risorsa e dell'identità. Passare invece il nome della risorsa a cui viene applicata l'identità. Questo approccio garantisce che la risorsa e l'identità gestita vengano distribuite prima che Resource Manager risolva la funzione di riferimento.

Nella funzione di riferimento usare Full per ottenere tutte le proprietà, inclusa l'identità gestita.

Il modello è:

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

Importante

Non usare il modello:

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

Il modello avrà esito negativo.

Ad esempio, per ottenere l'ID entità per un'identità gestita applicata a una macchina virtuale, usare:

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

In alternativa, per ottenere l'ID tenant per un'identità gestita applicata a un set di scalabilità di macchine virtuali, usare:

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

Soluzione 5: Controllare le funzioni

Bicep

È possibile usare il nome simbolico di una risorsa per ottenere valori da una risorsa. È possibile fare riferimento a un account di archiviazione nello stesso gruppo di risorse o in un altro gruppo di risorse usando un nome simbolico. Per ottenere un valore da una risorsa distribuita, usare la parola chiave esistente . Se una risorsa si trova in un gruppo di risorse diverso, usare scope con la funzione resourceGroup . Per la maggior parte dei casi, la funzione di riferimento non è necessaria.

Nell'esempio seguente viene fatto riferimento a un account di archiviazione esistente in un gruppo di risorse diverso.

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

JSON

Quando si distribuisce un modello, cercare espressioni che usano le funzioni reference o listKeys . I valori forniti variano a seconda che la risorsa sia nello stesso modello, gruppo di risorse e sottoscrizione. Verificare di specificare i valori dei parametri necessari per lo scenario. Se la risorsa è in un altro gruppo di risorse, fornire l'ID risorsa completo. Ad esempio, per fare riferimento a un account di archiviazione in un altro gruppo di risorse, usare:

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

Soluzione 6: Dopo l'eliminazione della risorsa

Quando si elimina una risorsa, potrebbe verificarsi un breve periodo di tempo in cui la risorsa viene visualizzata nel portale ma non è disponibile. Se si seleziona la risorsa, verrà visualizzato un errore che indica che la risorsa non viene trovata.

Aggiornare il portale e la risorsa eliminata deve essere rimossa dall'elenco di risorse disponibili. Se una risorsa eliminata continua a essere visualizzata come disponibile per più di pochi minuti, contattare il supporto tecnico.