Esporre API serverless da endpoint HTTP tramite Azure Gestione API
Funzioni di Azure si integra con Azure Gestione API nel portale per consentire di esporre gli endpoint della funzione trigger HTTP come API REST. Queste API sono descritte usando una definizione OpenAPI. Questo file JSON (o YAML) contiene informazioni sulle operazioni disponibili in un'API. Include informazioni dettagliate sul modo in cui devono essere strutturati i dati di richiesta e risposta per l'API. Integrando l'app per le funzioni, è possibile avere Gestione API generare queste definizioni OpenAPI.
Questo articolo illustra come integrare l'app per le funzioni con Gestione API. Questa integrazione funziona per le app per le funzioni sviluppate in qualsiasi linguaggio supportato. È anche possibile importare l'app per le funzioni da Azure Gestione API.
Per le funzioni della libreria di classi C# è anche possibile usare Visual Studio per creare e pubblicare API serverless integrate con Gestione API.
Per creare un'istanza di Gestione API collegata all'app per le funzioni:
Selezionare l'app per le funzioni, scegliere Gestione API nel menu a sinistra e quindi selezionare Crea nuova in Gestione API.
Usare le impostazioni di Gestione API specificate nella tabella seguente:
Impostazione Valore consigliato Descrizione Nome Nome globalmente univoco Viene generato un nome basato sul nome dell'app per le funzioni. Sottoscrizione Sottoscrizione in uso Sottoscrizione in cui viene creata questa nuova risorsa. Gruppo di risorse myResourceGroup Stessa risorsa dell'app per le funzioni, che dovrebbe essere impostata automaticamente. Posizione Posizione del servizio Valutare la scelta della stessa posizione dell'app per le funzioni. Nome organizzazione Contoso Nome dell'organizzazione usato nel portale per sviluppatori e per le notifiche di posta elettronica. Indirizzo di posta elettronica dell'amministratore Indirizzo di posta elettronica in uso Indirizzo di posta elettronica che ha ricevuto le notifiche di sistema da Gestione API. Piano tariffario Consumo Il livello Consumo non è disponibile in tutte le aree. Per informazioni dettagliate sui prezzi, vedere la pagina Prezzi di Gestione API. Scegliere Esporta per creare l'istanza di Gestione API, che può richiedere diversi minuti.
Dopo aver creato l'istanza, Azure abilita l'opzione Abilita Application Insights nella pagina. Selezionarlo per inviare i log alla stessa posizione dell'applicazione per le funzioni.
Dopo aver creato l'istanza di Gestione API, è possibile importare gli endpoint di funzione attivati HTTP. In questo esempio viene importato un endpoint denominato TurbineRepair.
Nella pagina Gestione API selezionare API collegamento.
Viene visualizzata la schermata Importa funzioni di Azure, in cui risulta evidenziata la funzione TurbineRepair. Scegliere Seleziona per continuare.
Nella pagina Crea da app per le funzioni accettare le impostazioni predefinite e quindi selezionare Crea.
Azure creerà l'API per la funzione.
Dopo l'importazione delle funzioni, è possibile scaricare la definizione OpenAPI dall'istanza di Gestione API.
Selezionare Scarica definizione OpenAPI nella parte superiore della pagina.
Salvare il file JSON scaricato e quindi aprirlo. Esaminare la definizione.
È ora possibile perfezionare la definizione in Gestione API nel portale. Sono anche disponibili altre informazioni su Gestione API.