Risoluzione errori con Azure Blueprint
Importante
Il 11 luglio 2026, Blueprints (anteprima) sarà deprecato. Eseguire la migrazione delle definizioni e delle assegnazioni di progetto esistenti a Specifiche modello e stack di distribuzione. Gli artefatti del progetto devono essere convertiti in modelli JSON arm o 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. È anche possibile ordinare la tabella delle assegnazioni in base alla colonna Stato provisioning per visualizzare tutte le assegnazioni non riuscite raggruppate.
Selezionare il progetto con stato Non riuscito o fare clic con il pulsante destro del mouse 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 blueprint è 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. Il servizio Blueprints inserisce quindi la funzione sull'artefatto che lo consente di essere dinamico come previsto. Per altre informazioni, vedere Sintassi ed espressioni nei modelli di Azure Resource Manager.
Eliminare errori
Scenario: timeout di eliminazione dell'assegnazione
Problema
L'eliminazione di un'assegnazione di progetto non viene completata.
Causa
Un'assegnazione di progetto può essere bloccata in uno stato non terminale quando è stata eliminata. Questo stato viene causato quando le risorse create dall'assegnazione del progetto sono ancora in sospeso o non restituiscono un codice di stato a Azure Blueprints.
Risoluzione
Le assegnazioni di progetto in uno stato non terminale vengono contrassegnate automaticamente non riuscite dopo un timeout di sei ore . Una volta modificato lo stato dell'assegnazione del progetto, è possibile ripetere 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.
- Connettersi con @AzureSupport : l'account ufficiale di Microsoft Azure per migliorare l'esperienza dei clienti connettendo la community di Azure alle risorse appropriate: 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.