Esponi le API serverless dagli endpoint di HTTP utilizzando Gestione API di Azure

Le Funzioni di Azure si integrano con Gestione API di Azure nel portale per consentire di esporre gli endpoint della funzione trigger HTTP in API REST. Queste API vengono descritte usando una definizione OpenAPI. Questo file JSON (o YAML) contiene informazioni sulle operazioni disponibili in un'API. Include informazioni dettagliate sulla struttura dei dati di richiesta e risposta per l'API. Integrando la tua app per le funzioni, puoi fare in modo che il servizio di gestione delle API generi 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 Gestione API di Azure.

Per le funzioni della libreria di classi C#, è anche possibile usare Visual Studio per creare e pubblicare API serverless che si integrano con Gestione API.

Creare l'istanza di Gestione API

Per creare un'istanza di Gestione API collegata all'app per le funzioni:

1. Selezionare l'app per le funzioni, scegliere Gestione API dal menu a sinistra e quindi selezionare Crea nuovo in Gestione API.

2. Usare le impostazioni di Gestione API come specificato nella tabella seguente:

   Impostazione	Valore suggerito	Descrizione
   Abbonamento	Il tuo abbonamento	Sottoscrizione in cui viene creata la nuova risorsa.
   Gruppo di risorse	il mio gruppo di risorse	La stessa risorsa della funzionalità dell'app, che dovrebbe essere configurata per te.
   Regione	Posizione del servizio	Valutare la possibilità di scegliere la stessa posizione dell'app per le funzioni.
   Nome risorsa	Nome globalmente univoco	Un nome viene generato in base al nome dell'app per le funzioni.
   Nome organizzazione	Contoso	Nome dell'organizzazione usato nel portale per sviluppatori e per le notifiche tramite posta elettronica.
   Indirizzo di posta elettronica dell'amministratore	il tuo messaggio di posta elettronica	Posta elettronica che ha ricevuto notifiche di sistema da Gestione API.
   Piano tariffario	Consumo	Il livello di consumo non è disponibile in tutte le aree. Per informazioni dettagliate sui prezzi completi, vedere la pagina dei prezzi di Gestione API

3. Scegliere Rivedi e crea e quindi Crea per creare l'istanza di Gestione API, che potrebbe richiedere alcuni minuti.

Funzioni di importazione

Dopo aver creato l'istanza di Gestione API, è possibile importare gli endpoint di funzione attivati tramite HTTP. Questo esempio importa un endpoint denominato TurbineRepair.

1. Nella pagina Gestione API selezionare Link API (API di collegamento).

2. Viene visualizzata l'opzione Importa funzioni di Azure con la funzione TurbineRepair evidenziata. Scegliere Seleziona per continuare.

3. Nella pagina Crea dalla Function App, accetta le impostazioni predefinite e quindi seleziona Crea. Azure crea l'API per la funzione.

Scaricare la definizione OpenAPI

Dopo aver importato le funzioni, è possibile scaricare la definizione OpenAPI dall'istanza di Gestione API.

1. Selezionare Scarica definizione OpenAPI nella parte superiore della pagina.

   

2. Salvare il file JSON scaricato e quindi aprirlo. Esaminare la definizione.

Passaggi successivi

È ora possibile perfezionare la definizione in Gestione API nel portale. Altre informazioni su Gestione API sono disponibili anche.

Modificare la definizione OpenAPI in Gestione API