Risoluzione errori con Azure Blueprint
Importante
L’11 luglio 2026, Blueprints (anteprima) sarà deprecato. Eseguire la migrazione delle definizioni e delle assegnazioni di progetto esistenti a specifiche di modello e stack di distribuzione. Gli artefatti del progetto devono essere convertiti in modelli JSON ARM o in file Bicep usati per definire gli stack di distribuzione. Per informazioni su come creare un artefatto come risorsa ARM, vedere:
È possibile riscontrare errori durante la creazione, l'assegnazione o la rimozione dei progetti. Questo articolo descrive i diversi errori che possono verificarsi e come risolverli.
Ricerca dei dettagli di errore
L'assegnazione di un progetto a un ambito comporta una serie di errori. Quando si verifica un errore di assegnazione, il progetto fornisce i dettagli relativi alla distribuzione non riuscita. Le informazioni indicano il problema in modo da poterlo risolvere e garantire la riuscita della distribuzione successiva.
Selezionare Tutti i servizi nel riquadro a sinistra. Cercare e selezionare Progetti.
Selezionare Progetti assegnati nella pagina a sinistra e usare la casella di ricerca per filtrare le assegnazioni di progetto in modo da individuare l'assegnazione non riuscita. È inoltre possibile ordinare la tabella delle assegnazioni tramite la colonna Stato di provisioning per visualizzare tutte le assegnazioni non riuscite raggruppate.
Selezionare il progetto con stato Non riuscito oppure fare clic con il pulsante destro e selezionare Visualizza i dettagli dell'assegnazione.
Nella parte superiore della pagina di assegnazione del progetto viene visualizzato un banner rosso che avvisa dell'esito negativo dell'assegnazione. Selezionare il banner per ottenere altri dettagli.
In genere l'errore è dovuto a un artefatto e non al progetto stesso. Se un artefatto crea un insieme di credenziali delle chiavi e Criteri di Azure impedisce la creazione di tale insieme, l'intera assegnazione ha esito negativo.
Errori generali
Scenario: violazione dei criteri
Problema
La distribuzione del modello non è riuscita a causa di una violazione dei criteri.
Causa
Un criterio può essere in conflitto con la distribuzione per i motivi seguenti:
- La risorsa da creare è limitata da criteri (si tratta in genere di restrizioni relative al codice di riferimento del prodotto o al percorso)
- La distribuzione è l'impostazione di campi configurati dai criteri (comune con i tag)
Risoluzione
Modificare il progetto in modo che non entri in conflitto con i criteri nei dettagli dell'errore. Nel caso in cui la modifica non sia possibile, l'alternativa consiste nel modificare l'ambito di assegnazione dei criteri in modo che il progetto non entri più in conflitto con i criteri.
Scenario: il parametro del progetto è una funzione
Problema
I parametri del progetto che sono funzioni vengono elaborati prima di essere trasmessi agli artefatti.
Causa
Il passaggio di un parametro del progetto che usa una funzione, ad esempio [resourceGroup().tags.myTag], a un artefatto comporta che il risultato dell'elaborazione della funzione sia impostato sull'artefatto invece che sulla funzione dinamica.
Risoluzione
Per passare a una funzione come parametro, l'intera stringa con carattere di escape [ tale che il parametro del progetto è simile a [[resourceGroup().tags.myTag]. Il carattere di escape fa sì che i progetti trattino il valore come una stringa durante l'elaborazione di progetto. Successivamente, il servizio Blueprints inserisce la funzione sull'artefatto in modo che possa essere dinamica come previsto. Per altre informazioni, vedere Sintassi ed espressioni nei modelli di Azure Resource Manager.
Errori di eliminazione
Scenario: timeout eliminazione assegnazione
Problema
L'eliminazione di un'assegnazione di progetto non viene completata.
Causa
Un'assegnazione di progetto può rimanere bloccata in uno stato non terminale quando viene eliminata. Questo stato si verifica quando le risorse create dall'assegnazione del progetto sono ancora in sospeso o non restituiscono un codice di stato in Azure Blueprints.
Risoluzione
Le assegnazioni di progetto in uno stato non terminale vengono contrassegnate automaticamente come Non riuscite dopo un timeout di sei ore. Dopo che il timeout ha modificato lo stato dell'assegnazione del progetto, è possibile ritentare l'eliminazione.
Passaggi successivi
Se il problema riscontrato non è presente in questo elenco o se non si riesce a risolverlo, visitare uno dei canali seguenti per ottenere ulteriore assistenza:
- Ottenere risposte dagli esperti di Azure tramite i forum di Azure.
- Contatta @AzureSupport, l'account Microsoft Azure ufficiale per il miglioramento dell'esperienza dei clienti che mette in contatto la community di Azure con le risorse corrette: risposte, supporto ed esperti.
- Se è necessaria un'assistenza maggiore, è possibile inviare una richiesta al supporto tecnico di Azure. Accedere al sito del supporto di Azure e selezionare Ottenere supporto.