Trovare i codici di errore

Quando una distribuzione delle risorse di Azure non riesce a usare i modelli di Azure Resource Manager (modelli di ARM) o i file Bicep e viene ricevuto il codice di errore. Questo articolo descrive come trovare i codici di errore per risolvere il problema. Per altre informazioni sui codici di errore, vedere Errori comuni di distribuzione.

Tipi di errore

Esistono tre tipi di errore correlati a una distribuzione:

  • Gli errori di convalida si verificano prima dell'inizio di una distribuzione e sono causati da errori di sintassi nel file. L'editor può identificare questi errori.
  • Gli errori di convalida di verifica preliminare si verificano quando si esegue un comando di distribuzione, ma le risorse non vengono distribuite. Questi errori vengono rilevati senza avviare la distribuzione. Ad esempio, se il valore di un parametro non è corretto, l'errore viene trovato nella convalida preliminare.
  • Gli errori di distribuzione si verificano durante il processo di distribuzione e possono essere rilevati solo valutando lo stato di avanzamento della distribuzione.

Tutti i tipi di errore restituiscono un codice di errore che consente di risolvere i problemi di distribuzione. Gli errori di convalida e verifica preliminare vengono visualizzati nel log attività, ma non nella cronologia della distribuzione. Un file Bicipite con errori di sintassi non viene compilato in JSON e non viene visualizzato nel log attività.

Per identificare gli errori di sintassi, è possibile usare Visual Studio Code con l'estensione bicipite più recente o l'estensione strumenti di Azure Resource Manager.

Errori di convalida

I modelli vengono convalidati durante il processo di distribuzione e vengono visualizzati i codici di errore. Prima di eseguire una distribuzione, è possibile eseguire test di convalida con Azure PowerShell o l'interfaccia della riga di comando di Azure per identificare gli errori di convalida e verifica preliminare.

Un ARM modello può essere distribuito dal portale. Se il modello contiene errori di sintassi, quando si prova a eseguire la distribuzione viene visualizzato un errore di convalida. Per altre informazioni sulle distribuzioni del portale, vedere Distribuire risorse da un modello personalizzato.

L'esempio seguente tenta di distribuire un account di archiviazione e si verifica un errore di convalida.

Screenshot of an Azure portal validation error.

Selezionare il messaggio per altri dettagli. Il modello presenta un errore di sintassi con codice di errore InvalidTemplate . Il riepilogo mostra che a un'espressione manca una parentesi di chiusura.

Screenshot of a validation error message that shows a syntax error.

Errori di distribuzione

Per distribuire una risorsa di Azure vengono elaborate diverse operazioni. Gli errori di distribuzione si verificano quando un'operazione supera la convalida ma non riesce durante la distribuzione. È possibile visualizzare i messaggi relativi a ogni operazione di distribuzione e a ogni distribuzione per un gruppo di risorse.

Per visualizzare i messaggi relativi alle operazioni di una distribuzione, usare il log attività del gruppo di risorse:

  1. Accedere al portale di Azure.

  2. Passare a Gruppi di risorse e selezionare il nome del gruppo di risorse della distribuzione.

  3. Selezionare Log attività.

  4. Usare i filtri per trovare il log degli errori di un'operazione.

    Screenshot of the resource group's activity log that highlights a failed deployment.

  5. Selezionare il log degli errori per visualizzare i dettagli dell'operazione.

    Screenshot of the activity log details that shows a failed deployment's error message.

Per visualizzare il risultato di una distribuzione:

  1. Passare al gruppo di risorse.

  2. Selezionare Impostazionidistribuzioni .

  3. Selezionare Dettagli errore per la distribuzione.

    Screenshot of a resource group's link to error details for a failed deployment.

  4. Vengono visualizzati il messaggio di errore NoRegisteredProviderFound e il codice di errore.

    Screenshot of a message that shows deployment error details.

Passaggi successivi