Risolvere gli errori comuni relativi alla distribuzione di Azure
Questo articolo descrive come risolvere gli errori comuni di distribuzione di Azure e fornisce informazioni sulle possibili soluzioni. Le risorse di Azure possono essere distribuite con file Bicep o modelli di Azure Resource Manager (modelli di ARM). Se non si trova il codice di errore per l'errore di distribuzione specifico, vedere Trovare il codice di errore.
Se il codice di errore non è elencato, inviare un problema di GitHub. Sul lato destro della pagina selezionare Feedback. Nella parte inferiore della pagina, in Feedback selezionare Questa pagina. Fornire il feedback sulla documentazione, ma non includere informazioni riservate perché i problemi GitHub sono pubblici.
Codici di errore
| Codice di errore | Mitigazione | Ulteriori informazioni |
|---|---|---|
| AccountNameInvalid | Rispettare le linee guida relative alla denominazione degli account di archiviazione. | Risolvere gli errori relativi ai nomi degli account di archiviazione |
| AccountPropertyCannotBeSet | Controllare le proprietà dell'account di archiviazione disponibili. | storageAccounts |
| AllocationFailed | Il cluster o l'area non ha risorse disponibili o non può supportare le dimensioni di macchina virtuale richieste. Ripetere la richiesta in un secondo momento oppure richiedere una dimensione di macchina virtuale diversa. | Problemi di provisioning e allocazione per Linux Problemi di provisioning e allocazione per Windows Risolvere i problemi relativi agli errori di allocazione |
| AnotherOperationInProgress | Attendere il completamento dell'operazione simultanea. | |
| AuthorizationFailed | L'account o l'entità servizio non dispone dell'accesso sufficiente per completare la distribuzione. Selezionare il ruolo a cui appartiene l'account e il relativo accesso per l'ambito della distribuzione. Questo errore potrebbe essere visualizzato quando un provider di risorse richiesto non è registrato. |
Controllo degli accessi in base al ruolo di Azure Risoluzione degli errori di registrazione del provider di risorse |
| BadRequest | I valori della distribuzione inviati non corrispondono ai valori previsti da Resource Manager. Per informazioni sulla risoluzione dei problemi, controllare il messaggio di stato interno. Convalidare la sintassi del modello per risolvere gli errori di distribuzione se si usa un modello esportato da una risorsa di Azure esistente. |
Informazioni di riferimento sul modello Percorso della risorsa nel modello di ARM Percorso della risorsa nel file Bicep Risolvere errori dovuti a modelli non validi |
| Conflitto | Si sta richiedendo un'operazione non consentita nello stato corrente della risorsa. Il ridimensionamento del disco, ad esempio, è consentito solo quando viene creata o deallocata una macchina virtuale. | |
| DeploymentActiveAndUneditable | Attendere il completamento della distribuzione simultanea al gruppo di risorse. | |
| DeploymentFailedCleanUp | Quando si distribuisce in modalità di completamento, tutte le risorse che non si trovano nel modello vengono eliminate. Questo errore viene visualizzato quando non si dispone di autorizzazioni adeguate per eliminare tutte le risorse che non si trovano nel modello. Per prevenire questo errore, impostare la modalità di distribuzione su incrementale. | Modalità di distribuzione di Azure Resource Manager |
| DeploymentNameInvalidCharacters | Il nome della distribuzione può contenere solo lettere, cifre, trattino (-), punto (.) o carattere di sottolineatura (_). |
|
| DeploymentNameLengthLimitExceeded | I nomi di distribuzione possono contenere un massimo di 64 caratteri. | |
| DeploymentFailed | DeploymentFailed è un errore generale che non fornisce i dettagli necessari per risolvere l'errore. Nei dettagli cercare un codice di errore che fornisca maggiori informazioni. | Trovare il codice di errore |
| DeploymentQuotaExceeded | Se si raggiunge il limite di 800 distribuzioni per gruppo di risorse, eliminare dalla cronologia le distribuzioni che non sono più necessarie. | Risolvere l'errore quando il numero di distribuzioni supera 800 |
| DeploymentJobSizeExceeded | Semplificare il modello per ridurre le dimensioni. | Risolvere gli errori di dimensioni del modello |
| DnsRecordInUse | Il nome del record DNS deve essere univoco. Immettere un altro nome. | |
| ImageNotFound | Controllare le impostazioni dell'immagine della macchina virtuale. | |
| InaccessibleImage | La distribuzione dell'istanza di Azure Container non viene completata. Potrebbe essere necessario includere il tag dell'immagine con la sintassi registry/image:tag per distribuire il contenitore. Per un registro privato, verificare che le credenziali siano corrette. |
Trovare il codice di errore |
| InternalServerError | Causato da un problema temporaneo. Ripetere la distribuzione. | |
| InUseSubnetCannotBeDeleted | Questo errore si può verificare quando si tenta di aggiornare una risorsa, se il processo di richiesta elimina e crea la risorsa. Assicurarsi di specificare tutti i valori invariati. | Aggiornare una risorsa |
| InvalidAuthenticationTokenTenant | Ottenere il token di accesso per il tenant appropriato. È possibile ottenere solo il token dal tenant a cui appartiene l'account. | |
| InvalidContentLink | Probabilmente è stato tentato il collegamento a un modello annidato non disponibile. Ricontrollare l'URI specificato per il modello annidato. Se il modello si trova in un account di archiviazione, verificare che l'URI sia accessibile. Potrebbe essere necessario passare un token di firma di accesso condiviso. Attualmente, non è possibile collegarsi a un modello che si trova in un account di archiviazione dietro un firewall di Archiviazione di Azure. Prendere in considerazione lo spostamento del modello in un altro repository, ad esempio GitHub. | Modelli di ARM collegati e annidati Moduli Bicep |
| InvalidDeploymentLocation | Durante la distribuzione a livello di sottoscrizione, è stato specificato un percorso diverso per un nome di distribuzione usato in precedenza. | Distribuzione sottoscrizione modello di ARM Distribuzione sottoscrizione file Bicep |
| InvalidParameter | Uno dei valori forniti per una risorsa non corrisponde al valore previsto. Questo errore può dipendere da molte condizioni diverse. Ad esempio, è possibile che una password non sia sufficiente o che un nome di BLOB non sia corretto. Il messaggio di errore deve indicare qual è il valore da correggere. | Parametri del modello di ARM Parametri Bicep |
| InvalidRequestContent | I valori della distribuzione includono valori non riconosciuti o dei valori obbligatori sono mancanti. Confermare i valori per il tipo di risorsa. | Informazioni di riferimento sul modello |
| InvalidRequestFormat | Abilitare la registrazione di debug quando si esegue la distribuzione e verificare il contenuto della richiesta. | Registrazione del debug |
| InvalidResourceLocation | Fornire un nome univoco per l'account di archiviazione. | Risolvere gli errori relativi ai nomi degli account di archiviazione |
| InvalidResourceNamespace | Controllare lo spazio dei nomi della risorsa specificato nella proprietà type. | Informazioni di riferimento sul modello |
| InvalidResourceReference | La risorsa non esiste ancora o viene referenziata in modo non corretto. Controllare se è necessario aggiungere una dipendenza. Verificare che l'utilizzo della funzione reference includa i parametri necessari per lo scenario in uso. | Risolvere gli errori relativi alle risorse di Azure non trovate |
| InvalidResourceType | Controllare il tipo di risorsa specificato nella proprietà type. | Informazioni di riferimento sul modello |
| InvalidSubscriptionRegistrationState | Registrare la sottoscrizione con il provider di risorse. | Risoluzione degli errori di registrazione del provider di risorse |
| InvalidTemplateDeployment InvalidTemplate |
Ricercare eventuali errori nella sintassi del modello. | Risolvere errori dovuti a modelli non validi |
| InvalidTemplateCircularDependency | Rimuovere le dipendenze non necessarie. | Risolvere le dipendenze circolari |
| JobSizeExceeded | Semplificare il modello per ridurre le dimensioni. | Risolvere gli errori di dimensioni del modello |
| LinkedAuthorizationFailed | Controllare se l'account appartiene allo stesso tenant del gruppo di risorse in fase di distribuzione. | |
| LinkedInvalidPropertyId | L'ID della risorsa per una data risorsa non è stato eseguito correttamente. Verificare di aver specificato tutti i valori necessari per l'ID della risorsa. Ad esempio, l'ID sottoscrizione, il nome del gruppo di risorse, il tipo di risorsa, il nome della risorsa padre (se necessario) e il nome della risorsa. | Risolvere gli errori relativi al nome e al tipo di risorsa |
| LocationRequired | Specificare un percorso per la risorsa. | Percorso della risorsa nel modello di ARM Percorso della risorsa nel file Bicep |
| MismatchingResourceSegments | Assicurarsi che la risorsa annidata abbia il numero di segmenti corretto nel nome e nel tipo. | Risolvere i segmenti di risorse |
| MissingRegistrationForLocation | Controllare lo stato della registrazione del provider di risorse e i percorsi supportati. | Risoluzione degli errori di registrazione del provider di risorse |
| MissingSubscriptionRegistration | Registrare la sottoscrizione con il provider di risorse. | Risoluzione degli errori di registrazione del provider di risorse |
| NoRegisteredProviderFound | Controllare lo stato della registrazione del provider di risorse. | Risoluzione degli errori di registrazione del provider di risorse |
| NotFound | È possibile che si stia tentando di distribuire una risorsa dipendente in parallelo con una risorsa padre. Controllare se è necessario aggiungere una dipendenza. | Risolvere gli errori relativi alle risorse di Azure non trovate |
| OperationNotAllowed | Questo messaggio di errore può essere visualizzato per varie ragioni. 1. La distribuzione sta tentando di eseguire un'operazione non consentita nello SKU specificato. 2. La distribuzione sta tentando di eseguire un'operazione che supera la quota per la sottoscrizione, il gruppo di risorse o l'area. Se possibile, modificare la distribuzione in modo da non superare le quote. In alternativa è possibile richiedere una modifica delle quote. |
Risolvere gli errori di quota delle risorse |
| OperationNotAllowedOnVMImageAsVMsBeingProvisioned | È possibile che si stia tentando di eliminare un'immagine attualmente in uso per effettuare il provisioning delle macchine virtuali. Non è possibile eliminare un'immagine usata da una macchina virtuale durante il processo di distribuzione. Ripetere l'operazione di eliminazione dell'immagine quando la distribuzione della macchina virtuale è stata completata. | |
| ParentResourceNotFound | Assicurarsi che esista una risorsa padre prima di creare le risorse figlio. | Risolvere gli errori delle risorse padre |
| PasswordTooLong | Potrebbe essere stata selezionata una password con troppi caratteri oppure il valore della password può essere stato convertito in una stringa sicura prima di specificarlo come parametro. Se il modello include un parametro secure string, non è necessario convertire il valore in una stringa sicura. Specificare il valore della password come testo. | |
| PrivateIPAddressInReservedRange | L'indirizzo IP specificato include un intervallo di indirizzi richiesto da Azure. Modificare l'indirizzo IP in modo da evitare l'intervallo riservato. | Indirizzi IP privati |
| PrivateIPAddressNotInSubnet | L'indirizzo IP specificato non è compreso nell'intervallo di subnet. Modificare l'indirizzo IP in modo che sia compreso nell'intervallo di subnet. | Indirizzi IP privati |
| PropertyChangeNotAllowed | Alcune proprietà non possono essere modificate in una risorsa distribuita. Quando si aggiorna una risorsa, è possibile limitare le modifiche alle proprietà consentite. | Aggiornare una risorsa |
| PublicIPCountLimitReached | È stato raggiunto il limite per il numero di IP pubblici in esecuzione. Arrestare le risorse non necessarie o contattare il supporto tecnico di Azure e richiedere di aumentare il limite. Ad esempio, in Azure Databricks, vedere Arresto imprevisto del cluster e Il limite degli indirizzi IP impedisce la creazione del cluster. | Limiti degli indirizzi IP pubblici |
| RegionDoesNotAllowProvisioning | Selezionare un'altra area o inviare una richiesta di supporto per la quota per l'accesso all'area. | |
| RequestDisallowedByPolicy | La sottoscrizione include un criterio di risorsa che impedisce di eseguire l'azione desiderata in fase distribuzione. Individuare il criterio che blocca l'azione. Se possibile, modificare la distribuzione affinché soddisfi le limitazioni del criterio. | Errore RequestDisallowedByPolicy con i criteri delle risorse di Azure |
| ReservedResourceName | Specificare un nome di risorsa che non includa un nome riservato. | Nomi di risorse riservati |
| ResourceGroupBeingDeleted | Attendere il completamento dell'eliminazione. | |
| ResourceGroupNotFound | Controllare il nome del gruppo della risorse di destinazione per la distribuzione. Il gruppo di risorse di destinazione deve essere già esistente nella sottoscrizione. Controllare il contesto della sottoscrizione. | PowerShell dell'interfaccia della riga di comando di Azure |
| ResourceNotFound | La distribuzione referenzia una risorsa di cui non è possibile eseguire la risoluzione. Verificare che l'utilizzo della funzione reference includa i parametri necessari per lo scenario in uso. | Risolvere gli errori relativi ai riferimenti |
| ResourceQuotaExceeded | La distribuzione sta tentando di creare risorse che superano la quota per la sottoscrizione, il gruppo di risorse o l'area. Se possibile, modificare l'infrastruttura in modo da non superare le quote. In alternativa è possibile richiedere una modifica delle quote. | Risolvere gli errori di quota delle risorse |
| SkuNotAvailable | Selezionare lo SKU, ad esempio le dimensioni delle macchine virtuali, disponibile per la posizione selezionata. | Risolvere gli errori dovuti all'indisponibilità di SKU |
| StorageAccountAlreadyTaken StorageAccountAlreadyExists |
Fornire un nome univoco per l'account di archiviazione. | Risolvere gli errori relativi ai nomi degli account di archiviazione |
| StorageAccountInAnotherResourceGroup | Fornire un nome univoco per l'account di archiviazione. | Risolvere gli errori relativi ai nomi degli account di archiviazione |
| StorageAccountNotFound | Controllare la sottoscrizione, il gruppo di risorse e il nome dell'account di archiviazione che si sta tentando di usare. | |
| SubnetsNotInSameVnet | Una macchina virtuale può avere solo una rete virtuale. Quando si distribuiscono più schede di interfaccia di rete, assicurarsi che appartengano alla stessa rete virtuale. | Più schede di interfaccia di rete delle macchine virtuali Windows Più schede di interfaccia di rete delle macchine virtuali Linux |
| SubnetIsFull | Nella subnet non sono disponibili indirizzi sufficienti per distribuire le risorse. È possibile rilasciare gli indirizzi dalla subnet, usarne una diversa o creare una nuova subnet. | Gestione delle subnet e Domande frequenti sulla rete virtuale Indirizzi IP privati |
| SubscriptionNotFound | Non è possibile accedere a una sottoscrizione specificata per la distribuzione. L'ID sottoscrizione potrebbe essere errato, l'utente che distribuisce il modello non dispone delle autorizzazioni adeguate per la distribuzione nella sottoscrizione o l'ID sottoscrizione è nel formato errato. Se si usano distribuzioni annidate di modelli di ARM da distribuire in diversi ambiti, specificare il GUID della sottoscrizione. | Distribuzione di un modello di ARM in diversi ambiti Distribuzione di file Bicep in diversi ambiti |
| SubscriptionNotRegistered | Quando si distribuisce una risorsa, il provider di risorse deve essere registrato per la sottoscrizione. Quando si usa un modello di Azure Resource Manager per la distribuzione, il provider di risorse viene registrato automaticamente nella sottoscrizione. A volte, la registrazione automatica non viene completata in tempo. Per evitare questo errore intermittente, registrare il provider di risorse prima di iniziare la distribuzione. | Risoluzione degli errori di registrazione del provider di risorse |
| SubscriptionRequestsThrottled | Azure Resource Manager limita le richieste a livello di sottoscrizione o tenant. Anche i provider di risorse come Microsoft.Compute limitano le richieste specifiche per le operazioni. Quando si raggiunge un limite, viene visualizzato un messaggio e un valore che indica il tempo di attesa prima di poter inviare una nuova richiesta. Ad esempio: Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds. Una risposta HTTP restituisce un messaggio HTTP status code 429 Too Many Requests con un valore Retry-After che specifica il numero di secondi di attesa prima di poter inviare un'altra richiesta. |
Limitazione delle richieste di Resource Manager Risoluzione degli errori di limitazione delle API - macchine virtuali Limitazione del servizio Azure Kubernetes |
| TemplateResourceCircularDependency | Rimuovere le dipendenze non necessarie. | Risolvere le dipendenze circolari |
| TooManyTargetResourceGroups | Ridurre il numero di gruppi di risorse per una distribuzione singola. | Distribuzione di un modello di ARM in diversi ambiti Distribuzione di file Bicep in diversi ambiti |
Passaggi successivi
- Per informazioni sugli errori di convalida o di distribuzione, vedere Trovare i codici di errore.
- Per maggiori dettagli su come risolvere i problemi di una distribuzione, vedere Abilitare la registrazione di debug.
- Per isolare la causa di un errore di distribuzione, vedere Creare un modello di risoluzione dei problemi.