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.

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

    Creare un nuovo servizio 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.

    Importare funzioni di Azure in Gestione API

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

    Crea da app per le funzioni

    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.

    Scaricare la definizione OpenAPI

  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.