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.

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 nel menu a sinistra e quindi selezionare Crea nuova in Gestione API.

   

2. 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.

   

3. Scegliere Esporta per creare l'istanza di Gestione API, che può richiedere diversi minuti.

4. 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.

Funzioni di importazione

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.

1. Nella pagina Gestione API selezionare API collegamento.

2. Viene visualizzata la schermata Importa funzioni di Azure, in cui risulta evidenziata la funzione TurbineRepair. Scegliere Seleziona per continuare.

   

3. Nella pagina Crea da app per le funzioni accettare le impostazioni predefinite e quindi selezionare Crea.

   

   Azure creerà l'API per la funzione.

Scaricare la definizione OpenAPI

Dopo l'importazione delle 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. Sono anche disponibili altre informazioni su Gestione API.

Modificare la definizione OpenAPI in Gestione API