Condividi tramite


API REST serverless usando Funzioni di Azure

Funzioni di Azure è un servizio di calcolo essenziale usato per creare API basate su REST serverless. I trigger HTTP espongono gli 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 HTTP può esporre un'API REST altamente funzionale. Le funzioni offrono anche uno schema di autorizzazione basato su chiavi di base per limitare l'accesso solo a client specifici. Per altre informazioni, vedere trigger HTTP Funzioni di Azure

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 superiore di sicurezza che consente di monetizzare il relativo 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 consentire di controllare l'integrazione di routing, sicurezza e OpenAPI. Supporta anche criteri avanzati come la limitazione della monetizzazione. Le versioni precedenti del runtime di Funzioni hanno usato la funzionalità Proxy funzioni legacy.

Importante

Funzioni di Azure proxy è una funzionalità legacy per le versioni 1.x e 3.x del runtime di Funzioni di Azure. È possibile abilitare nuovamente il supporto per i proxy nella versione 4.x per aggiornare correttamente le app per le funzioni alla versione di runtime più recente. Non appena possibile, è necessario 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 Gestione API.

Per informazioni su come abilitare nuovamente 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 per comportarsi come il proxy precedente. La sezione seguente fornisce collegamenti agli articoli pertinenti che consentono di usare Gestione API con Funzioni di Azure.

Se si hanno difficoltà a passare da proxy o se Azure Gestione API non risolve gli scenari specifici, pubblicare una richiesta nel forum di feedback Gestione API.

integrazione 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 adminlivello di autorizzazione vengono ignorati. Per altre informazioni sull'uso di Gestione API con Funzioni, vedere gli articoli seguenti:

Articolo Descrizione
Esporre API serverless da endpoint HTTP tramite Azure Gestione API Illustra come creare una nuova istanza di Gestione API da un'app per le funzioni esistente nella portale di Azure. Supporta tutte le lingue.
Creare API serverless in Visual Studio usando Funzioni di Azure e Gestione API integrazione 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 attributi direttamente al codice C#.
Avvio rapido: Creare una nuova istanza del servizio Gestione API di Azure 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 la creazione di una nuova API e 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 eseguite in sequenza nella richiesta o nella 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 funzioni legacy offre anche un set di funzionalità API di base per la versione 3.x e versione precedente del runtime di Funzioni.

Importante

Funzioni di Azure proxy è una funzionalità legacy per le versioni 1.x e 3.x del runtime di Funzioni di Azure. È possibile abilitare nuovamente il supporto per i proxy nella versione 4.x per aggiornare correttamente le app per le funzioni alla versione di runtime più recente. Non appena possibile, è necessario 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 Gestione API.

Per informazioni su come abilitare nuovamente il supporto dei proxy in Funzioni versione 4.x, vedere Riabilitare i proxy in Funzioni v4.x.

Alcuni hint di base per 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 esistenti in Gestione API.

Passaggi successivi