Risolvere i problemi durante la creazione, l'eliminazione o il ripristino di app per le funzioni di Azure
Questo articolo elenca alcuni problemi comuni che possono verificarsi durante la creazione, l'eliminazione o il ripristino delle app per le funzioni di Azure e i passaggi per risolvere i problemi.
Creare app per le funzioni
Le app per le funzioni di Azure usano l'infrastruttura di Servizio app di Azure. È possibile creare un'app per le funzioni di Azure usando:
- Azure portal
- Interfaccia della riga di comando di Azure
- PowerShell
- Modello di Azure Resource Manager o Bicep
È possibile anche creare un'app durante la distribuzione di un progetto di funzione da Visual Studio o Visual Studio Code.
Considerazioni per un account Archiviazione di Azure usato da Funzioni di Azure
Quando si crea un'app per le funzioni, è possibile creare o collegarsi a un account di Archiviazione di Azure per utilizzo generico che supporti l'archiviazione BLOB, code e tabelle. Funzioni di Azure si basa su Archiviazione di Azure per operazioni come la gestione dei trigger e la registrazione dell'esecuzione delle funzioni. Per altre informazioni, vedere Considerazioni sull'archiviazione per Funzioni di Azure.
- Assicurarsi di disporre delle autorizzazioni per creare un account di archiviazione e altre risorse. Non possono esserci violazioni del controllo degli accessi in base al ruolo, dei criteri o dell'ambito.
- Usare l'identità gestita per la stringa di connessione di Archiviazione di Azure, solo per
AzureWebJobsStorage
. Per altre informazioni, vedere Connessione all'archiviazione host con un'identità (anteprima).
Proteggere l'account Archiviazione di Azure usato da Funzioni di Azure
È possibile creare un'app per le funzioni di Azure e un nuovo account di archiviazione protetto con endpoint privati. Ospitare l'app per le funzioni in un piano che supporta l'integrazione della rete virtuale.
- Per informazioni sulla creazione dal portale, vedere l'esercitazione sulla rete.
- Per i modelli di Azure Resource Manager, consultare la sezione Azure/modelli di avvio rapido di Azure.
- È anche possibile aggiornare un'app per le funzioni esistente in modo che punti a un nuovo account di archiviazione sicuro. Per altre informazioni, vedere Limitare l'account di archiviazione a una rete virtuale.
Eseguire la migrazione di un'app per le funzioni di Azure in piani di hosting diversi
In Windows è possibile usare i comandi dell'interfaccia della riga di comando di Azure per eseguire la migrazione di un'app per le funzioni tra un piano a consumo e un piano Premium o viceversa. Per altre informazioni, vedere Migrazione del piano.
- La migrazione diretta da/a un piano dedicato (servizio app) a/da un piano a consumo/Premium non è supportato perché le funzionalità per la scalabilità basata su eventi e l'uso di funzionalità serverless differiscono nei diversi piani di hosting.
Note
Linux non supporta la migrazione dei piani di hosting.
Consultare le offerte del piano di hosting (A consumo, Premium, Dedicato) come connettività rete virtuale, timeout, fatturazione e così via. Per altre informazioni, vedere Opzioni di hosting di Funzioni di Azure.
Risolvere l'errore "Questa area ha una quota di 0 istanze per la sottoscrizione. Provare a selezionare un'altra area o un altro SKU"
Se si verificano costantemente problemi di creazione delle risorse in una determinata area, provare a creare la risorsa in un'area geograficamente abbinata se l'azienda lo consente. Ad esempio, Stati Uniti occidentali 2 e Stati Uniti centro-occidentali sono aree associate. Anche l'Asia orientale (Hong Kong SAR) e l'Asia sud-orientale (Singapore) sono aree abbinate.
Per altre informazioni, vedi:
Risolvere l'errore "Il piano tariffario non è consentito in questo gruppo di risorse" o "SkuNotAllowedForResourceGroup"
È consigliabile creare il piano in un nuovo gruppo di risorse. Gli SKU diversi richiedono computer univoci. Quando si crea un'app in un gruppo di risorse, tale app viene mappata e assegnata a un pool di risorse. Se si crea un altro piano in tale gruppo di risorse e il pool mappato non dispone delle risorse necessarie, viene visualizzato l'errore.
Per altre informazioni, vedere Creazione di app per le funzioni in un gruppo di risorse esistente.
La creazione di una condivisione file di contenuto dell'app per le funzioni non riesce con: "Il server remoto ha restituito un errore: (403) Accesso negato"
Per le app per le funzioni nel piano a consumo o nel piano Elastic Premium, viene creata una condivisione file nell'account di archiviazione e viene fatto riferimento usando l'impostazione WEBSITE_CONTENT_SHARE
dell'app . Questo errore può verificarsi perché l'account di archiviazione ha un firewall, endpoint privati o altre restrizioni di sicurezza della rete virtuale, ad esempio regole del gruppo di sicurezza di rete.
Per risolvere l'errore, creare prima una condivisione file nell'account di archiviazione sicuro e configurarla in WEBSITE_CONTENT_SHARE
. Per altre informazioni, vedere Limitare l'account di archiviazione a una rete virtuale.
Strumenti alternativi per la creazione
È possibile usare strumenti alternativi come l'interfaccia della riga di comando di Azure, PowerShell e Az.Functions
. Assicurarsi di usare le versioni più recenti degli strumenti. Se si verifica un problema quando si usa uno degli strumenti, ad esempio portale di Azure, provare a usare un'altra, ad esempio l'interfaccia della riga di comando di Azure.
Impostare la versione del runtime della funzione per Windows e Linux
Per le app di Windows, impostare la versione di runtime nella portale di Azure (Impostazioni della>versione runtime della funzione>di configurazione>) o creare un'impostazione FUNCTIONS_EXTENSION_VERSION
dell'applicazione e impostarla sulla versione di runtime principale, ad esempio, ~4
sulla versione V4 di destinazione. Per altre informazioni, vedere Come specificare le versioni del runtime per Funzioni di Azure. Aggiungerla a una versione secondaria in base alle versioni host impostando FUNCTIONS_EXTENSION_VERSION
su una versione secondaria. Vedere anche Versioni host di Funzioni di Azure.
Per le app Linux, vedere Aggiornamenti manuali delle versioni in Linux.
Risolvere gli errori HTTP 429
La limitazione avviene a due livelli: Azure Resource Manager e provider di risorse (Microsoft.Web). Il livello dipende dal tipo di sottoscrizione e dal piano di hosting. Per altre informazioni, vedere:
- Limitazione delle richieste di Azure Resource Manager
- Sottoscrizione di Azure e limiti, quote e vincoli dei servizi
- Limiti dei servizi app Azure
Note
Se il problema è poco frequente, attendere e riprovare dopo qualche tempo per verificare se il problema viene risolto. Se il problema è frequente, è possibile acquistare una sottoscrizione diversa o aggiornare il piano di hosting per risolvere l'errore.
Eliminare o ripristinare le app per le funzioni
Dopo la pubblicazione del codice da Visual Studio e l'uso WEBSITE_RUN_FROM_PACKAGE
di , il portale di Azure imposta funzioni come di sola lettura per impedire la modifica di asset precompilati nel portale. Per eliminare le funzioni in un'app per le funzioni, rimuovere le funzioni indesiderate dal codice, abilitare l'opzione Rimuovi file aggiuntivi nella destinazione nelle impostazioni del profilo e ridistribuire il codice.
Il ripristino delle app per le funzioni di Azure ospitate in un piano a consumo o in un piano Elastic Premium non è supportato. Se si dispone del contenuto dell'app per le funzioni o si può accedere all'account di archiviazione, aggiornare le impostazioni dell'app o creare una nuova app per le funzioni e usare il contenuto. È possibile ripristinare le app per le funzioni di Azure in un piano di servizio app dedicato se non usa File di Azure per l'archiviazione del contenuto.
Per altre informazioni, vedere: Ripristinare (annullare l'eliminazione) di app Web eliminate.
Assicurarsi di disporre di autorizzazioni sufficienti per eliminare un'app per le funzioni di Azure. Non possono esserci violazioni del controllo degli accessi in base al ruolo, dei criteri o dell'ambito.
Raccogliere dati prima di contattare il supporto tecnico Microsoft
Se la creazione o l'eliminazione dell'app per le funzioni non riesce, raccogliere e condividere i dati seguenti durante la creazione di un ticket di supporto:
portale di Azure: riprodurre il problema e acquisire una traccia del browser.
Interfaccia della riga di comando di Azure o Azure PowerShell: condividere il comando che ha segnalato l'errore e la registrazione dettagliata.
Per gli errori di distribuzione di Azure Resource Manager, trovare il messaggio di errore nel portale di Azure:
- Selezionare Gruppo di risorse>Distribuzioni.
- Condividere l'ID di correlazione dell'attività non riuscita.
Contattaci per ricevere assistenza
In caso di domande o bisogno di assistenza, creare una richiesta di supporto tecnico oppure formula una domanda nel Supporto della community di Azure. È possibile anche inviare un feedback sul prodotto al feedback della community di Azure.