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 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 commenti e suggerimenti sulla documentazione, ma non includere informazioni riservate perché i problemi di GitHub sono pubblici.
Codici di errore
| Codice di errore | Strategia di riduzione del rischio | Altre informazioni |
|---|---|---|
| AccountNameInvalid | Seguire le linee guida di denominazione per gli 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 quando si usa un modello esportato da una risorsa di Azure esistente. |
Informazioni di riferimento sul modello Percorso delle risorse nel modello di Resource Manager Percorso delle risorse 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à completa, tutte le risorse che non sono presenti nel modello vengono eliminate. Questo errore viene visualizzato quando non si dispone di autorizzazioni adeguate per eliminare tutte le risorse non presenti nel modello. Per evitare l'errore, modificare la modalità di distribuzione in modo incrementale. | Modelli di distribuzione Azure Resource Manager |
| DeploymentNameInvalidCharacters | Il nome della distribuzione può contenere solo lettere, cifre, trattino , punto (.) o sottolineatura (_)(-). |
|
| DeploymentNameLengthLimitExceeded | I nomi di distribuzione sono limitati a 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 relativi alle dimensioni del modello |
| DnsRecordInUse | Il nome del record DNS deve essere univoco. Immettere un nome diverso. | |
| ImageNotFound | Controllare le impostazioni dell'immagine della macchina virtuale. | |
| InaccessibileImage | La distribuzione dell'istanza di Azure Container ha esito negativo. 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. Riprovare la distribuzione. | |
| InUseSubnetCannotBeDeleted | Questo errore può verificarsi 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 | È probabile che si sia tentato di collegare un modello annidato che 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 collegare un modello 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 Resource Manager collegati e annidati Moduli Bicep |
| InvalidDeploymentLocation | Quando si distribuisce a livello di sottoscrizione, è stato fornito un percorso diverso per un nome di distribuzione usato in precedenza. | Distribuzione della sottoscrizione del modello di Resource Manager Distribuzione di sottoscrizioni 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 quale valore deve essere corretto. | Parametri del modello di Azure Resource Manager Parametri Bicep |
| InvalidRequestContent | I valori di distribuzione includono valori non riconosciuti o i valori obbligatori mancano. Confermare i valori per il tipo di risorsa. | Informazioni di riferimento sul modello |
| InvalidRequestFormat | Abilitare la registrazione di debug durante l'esecuzione della distribuzione e verificare il contenuto della richiesta. | Registrazione di 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 relativi alle dimensioni del modello |
| LinkedAuthorizationFailed | Verificare se l'account appartiene allo stesso tenant del gruppo di risorse in cui si sta distribuendo. | |
| LinkedInvalidPropertyId | L'ID risorsa per una risorsa non viene risolto. Verificare che siano stati forniti tutti i valori necessari per l'ID 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 per il nome e il tipo di risorsa |
| LocationRequired | Specificare un percorso per la risorsa. | Percorso delle risorse nel modello di Resource Manager Percorso delle risorse nel file Bicep |
| MismatchingResourceSegments | Assicurarsi che una risorsa annidata abbia il numero corretto di segmenti in nome e tipo. | Risolvere i segmenti di risorse |
| MissingRegistrationForLocation | Controllare lo stato di registrazione del provider di risorse e le posizioni supportate. | 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 provare a 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 | Esistono diversi motivi per questo messaggio di errore. 1. La distribuzione tenta di eseguire un'operazione che non è consentita nello SKU spcecified. 2. La distribuzione tenta di eseguire un'operazione che supera la quota per la sottoscrizione, il gruppo di risorse o l'area geografica. 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 tentare di eliminare un'immagine attualmente usata per effettuare il provisioning delle macchine virtuali. Non è possibile eliminare un'immagine usata da qualsiasi macchina virtuale durante il processo di distribuzione. Ripetere l'operazione di eliminazione dell'immagine dopo il completamento della distribuzione della macchina virtuale. | |
| ParentResourceNotFound | Assicurarsi che esista una risorsa padre prima di creare le risorse figlio. | Risolvere gli errori delle risorse padre |
| PasswordTooLong | È possibile che sia stata selezionata una password con troppi caratteri o convertita il valore della password in una stringa sicura prima di passarla 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 indirizzi IP pubblici in esecuzione. Arrestare le risorse non necessarie o contattare supporto tecnico di Azure per richiedere un aumento. Ad esempio, in Azure Databricks, vedere Terminazione imprevista del cluster e limite di indirizzi IP impedisce la creazione del cluster. | Limiti di indirizzi IP pubblici |
| RegionDoesNotAllowProvisioning | Selezionare un'area diversa o inviare una richiesta di supporto quota per l'accesso all'area. | |
| RequestDisallowedByPolicy | La sottoscrizione include criteri di risorsa che impediscono l'esecuzione di un'azione durante la distribuzione. Individuare il criterio che blocca l'azione. Se possibile, modificare la distribuzione in modo da soddisfare le limitazioni dei criteri. | 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 già esistere nella sottoscrizione. Controllare il contesto della sottoscrizione. | Interfaccia della riga di comando di AzurePowerShell |
| 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. | Vm Windows con più schede di interfaccia di rete Vm Linux con più schede di interfaccia di rete |
| SubnetIsFull | Non sono disponibili indirizzi sufficienti nella subnet per distribuire le risorse. È possibile rilasciare gli indirizzi dalla subnet, usare una subnet diversa o creare una nuova subnet. | Gestire le subnet e le domandefrequenti sulla rete virtuale Indirizzi IP privati |
| SubscriptionNotFound | Non è possibile accedere a una sottoscrizione specificata per la distribuzione. Potrebbe essere errato l'ID sottoscrizione, l'utente che distribuisce il modello non dispone di autorizzazioni adeguate per la distribuzione nella sottoscrizione o l'ID sottoscrizione è nel formato errato. Quando si usano distribuzioni nidificate del modello di Resource Manager per la distribuzione tra ambiti, specificare il GUID della sottoscrizione. | Modello di Resource Manager distribuito tra ambiti Distribuzione di file Bicep tra ambiti |
| SubscriptionNotRegistered | Quando viene distribuita una risorsa, il provider di risorse deve essere registrato per la sottoscrizione. Quando si usa un modello di Resource Manager di Azure 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 della distribuzione. | Risoluzione degli errori di registrazione del provider di risorse |
| SubscriptionRequestsThrottled | Azure Resource Manager limita le richieste a livello di sottoscrizione o tenant. I provider di risorse, ad esempio Microsoft.Compute , limitano anche le richieste specifiche per le relative operazioni. Quando viene raggiunto un limite, viene visualizzato un messaggio e un valore con il tempo necessario attendere prima di 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 simile HTTP status code 429 Too Many Requests a un Retry-After valore che specifica il numero di secondi da attendere prima di inviare un'altra richiesta. |
Limitazione delle richieste di Resource Manager Risoluzione degli errori di limitazione delle API - Macchine virtuali servizio Azure Kubernetes limitazione |
| TemplateResourceCircularDependency | Rimuovere le dipendenze non necessarie. | Risolvere le dipendenze circolari |
| TooManyTargetResourceGroups | Ridurre il numero di gruppi di risorse per una distribuzione singola. | Modello di Resource Manager distribuito tra ambiti Distribuzione di file Bicep tra ambiti |
Passaggi successivi
- Per informazioni sugli errori di convalida o distribuzione, vedere Trovare i codici di errore.
- Per ottenere altri dettagli per 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.