API REST serverless che usano Funzioni di Azure
Funzioni di Azure è un servizio di calcolo essenziale usato per creare API basate su REST serverless. I trigger HTTP espongono endpoint REST che possono essere chiamati dai client, ad esempio browser, app per dispositivi mobili e altri servizi back-end. Con il supporto nativo per le route, una singola funzione attivata tramite HTTP può esporre un'API REST altamente funzionale. Funzioni fornisce anche un proprio schema di autorizzazione basato su chiavi di base per limitare l'accesso solo a client specifici. Per altre informazioni, vedere Funzioni di Azure trigger HTTP
In alcuni scenari potrebbe essere necessaria l'API per supportare un set più complesso di comportamenti REST. Ad esempio, potrebbe essere necessario combinare più endpoint di funzione HTTP in una singola API. È anche possibile passare le richieste a uno o più servizi basati su REST back-end. Infine, le API potrebbero richiedere un livello di sicurezza superiore che consente di monetizzare l'uso.
Oggi, l'approccio consigliato per creare API più complesse e affidabili basate sulle funzioni consiste nell'usare i servizi API completi forniti da Azure Gestione API. Gestione API usa un modello basato su criteri per controllare l'integrazione di routing, sicurezza e OpenAPI. Supporta anche criteri avanzati come la limitazione della monetizzazione della frequenza. Le versioni precedenti del runtime di Funzioni usavano la funzionalità proxy di Funzioni legacy.
Importante
I proxy di Funzioni di Azure sono una funzionalità legacy per le versioni da 1.x a 3.x del runtime di Funzioni di Azure. Il supporto per i proxy può essere riabilitato nella versione 4.x per aggiornare correttamente le app per le funzioni alla versione di runtime più recente. Appena possibile, è consigliabile passare all'integrazione delle app per le funzioni con Azure Gestione API. Gestione API consente di sfruttare un set di funzionalità più completo per definire, proteggere, gestire e monetizzare le API basate su Funzioni. Per altre informazioni, vedere Integrazione di Gestione API.
Per informazioni su come riabilitare il supporto dei proxy in Funzioni versione 4.x, vedere Riabilitare i proxy in Funzioni v4.x.
Passaggio da proxy di funzioni a Gestione API
Quando si passa dai proxy di Funzioni all'uso di Gestione API, è necessario integrare l'app per le funzioni con un'istanza di Gestione API e quindi configurare l'istanza di Gestione API in modo che si comporti come il proxy precedente. La sezione seguente fornisce collegamenti agli articoli pertinenti che consentono di usare Gestione API con Funzioni di Azure.
In caso di problemi durante il passaggio da proxy o se Azure Gestione API non risolve gli scenari specifici, pubblicare una richiesta nel forum di feedback Gestione API.
integrazione di Gestione API
Gestione API consente di importare un'app per le funzioni esistente. Dopo l'importazione, ogni endpoint della funzione attivata da HTTP diventa un'API che è possibile modificare e gestire. Dopo l'importazione, è anche possibile usare Gestione API per generare un file di definizione OpenAPI per le API. Durante l'importazione, gli endpoint con un admin livello di autorizzazione vengono ignorati. Per altre informazioni sull'uso di Gestione API con Funzioni, vedere gli articoli seguenti:
| Articolo | Descrizione |
|---|---|
| Esporre le API serverless dagli endpoint HTTP usando Azure Gestione API | Illustra come creare una nuova istanza di Gestione API da un'app per le funzioni esistente nel portale di Azure. Supporta tutte le lingue. |
| Creare API serverless in Visual Studio usando Funzioni di Azure e integrazione Gestione API | Illustra come usare Visual Studio per creare un progetto C# che usa l'estensione OpenAPI. L'estensione OpenAPI consente di definire le API .NET applicando gli attributi direttamente al codice C#. |
| Guida introduttiva: Creare una nuova istanza del servizio azure Gestione API usando il portale di Azure | Creare una nuova istanza di Gestione API nel portale. Dopo aver creato un'istanza di Gestione API, è possibile connetterla all'app per le funzioni. Sono supportati altri metodi di creazione non del portale. |
| Importare un'app per le funzioni di Azure come API in Azure Gestione API | Illustra come importare un'app per le funzioni esistente per esporre gli endpoint trigger HTTP esistenti come API gestita. Questo articolo supporta sia la creazione di una nuova API che l'aggiunta degli endpoint a un'API gestita esistente. |
Dopo aver esposto gli endpoint dell'app per le funzioni usando Gestione API, gli articoli seguenti forniscono informazioni generali su come gestire le API basate su Funzioni nell'istanza di Gestione API.
| Articolo | Descrizione |
|---|---|
| Modificare un'API | Illustra come usare un'API esistente ospitata in Gestione API. |
| Criteri in Gestione API di Azure | In Gestione API gli editori possono modificare il comportamento dell'API tramite la configurazione usando i criteri. I criteri sono una raccolta di istruzioni che vengono eseguite in sequenza sulla richiesta o sulla risposta di un'API. |
| Informazioni di riferimento per i criteri di Gestione API di Azure | Fare riferimento a tutti i criteri di Gestione API supportati. |
| Esempi di criteri di Gestione API | Raccolta utile di esempi che usano criteri di Gestione API in scenari chiave. |
Proxy di funzioni legacy
La funzionalità proxy di Funzioni legacy offre anche un set di funzionalità API di base per la versione 3.x e la versione precedente del runtime di Funzioni.
Importante
I proxy di Funzioni di Azure sono una funzionalità legacy per le versioni da 1.x a 3.x del runtime di Funzioni di Azure. Il supporto per i proxy può essere riabilitato nella versione 4.x per aggiornare correttamente le app per le funzioni alla versione di runtime più recente. Appena possibile, è consigliabile passare all'integrazione delle app per le funzioni con Azure Gestione API. Gestione API consente di sfruttare un set di funzionalità più completo per definire, proteggere, gestire e monetizzare le API basate su Funzioni. Per altre informazioni, vedere Integrazione di Gestione API.
Per informazioni su come riabilitare il supporto dei proxy in Funzioni versione 4.x, vedere Riabilitare i proxy in Funzioni v4.x.
Alcuni suggerimenti di base su come eseguire attività equivalenti usando Gestione API sono stati aggiunti all'articolo Proxy di Funzioni. Attualmente non sono disponibili documentazione o strumenti che consentono di eseguire la migrazione di un'implementazione dei proxy di Funzioni esistente a Gestione API.