Importare un'app per le funzioni di Azure come API in Gestione API di Azure

2025-05-20

SI APPLICA A: tutti i livelli di Gestione API

Gestione API di Azure supporta l'importazione di app per le funzioni di Azure come nuove API o l'aggiunta alle API esistenti. Il processo genera automaticamente una chiave host nell'app per le funzioni di Azure, che viene quindi assegnata a un valore denominato in Gestione API.

Nota

Attualmente, questa funzionalità non è disponibile nelle aree di lavoro.

Questo articolo descrive come importare un'app per le funzioni di Azure come API in Gestione API di Azure e testare l'API.

Si apprenderà come:

Importare un'app per le funzioni di Azure come API
Aggiungere un'app per le funzioni di Azure a un'API
Visualizzare la nuova chiave host dell'app per le funzioni e il valore denominato di Gestione API
Testare l'API nel portale di Azure

Prerequisiti

Completare l'avvio rapido Creare un'istanza di Gestione API di Azure.
Assicurarsi di avere un'app per le funzioni di Azure nella sottoscrizione. Per altre informazioni, vedere Introduzione a Funzioni di Azure. La funzione deve avere un trigger HTTP. Il livello di autorizzazione deve essere impostato su Anonimo o Funzione.

Nota

È anche possibile usare l'estensione Gestione API per Visual Studio Code per importare e gestire le API. Completare l'esercitazione sull'estensione Gestione API per iniziare.

Importare un'app per le funzioni di Azure come nuova API

Per creare una nuova API da un'app per le funzioni di Azure:

Passare al servizio Gestione API nel portale di Azure.
Selezionare API>API nel riquadro sinistro.
In Crea dalla risorsa di Azure selezionare App per le funzioni:
Selezionare il pulsante Sfoglia :
Fare clic sul pulsante Seleziona in Configura le impostazioni necessarie per scegliere dall'elenco delle app per le funzioni disponibili:
Trovare l'app per le funzioni da cui si vuole importare le funzioni, selezionarla e quindi fare clic su Seleziona:
Selezionare le funzioni da importare e fare clic su Seleziona. È possibile importare solo le funzioni con un trigger HTTP e un livello di autorizzazione Anonimo o Funzione .
Passare alla visualizzazione Completa e assegnare un prodotto alla nuova API.
Nota

I prodotti sono associazioni di una o più API offerte agli sviluppatori tramite il portale per sviluppatori. Per avere accesso all'API, gli sviluppatori devono prima sottoscrivere un prodotto. Quando sottoscrivono, ottengono una chiave di sottoscrizione per qualsiasi API nel prodotto. Se hai creato l'istanza di Gestione API, sei un amministratore e sei iscritto a ogni prodotto per impostazione predefinita.

In alcuni piani tariffari, le istanze di Gestione API sono dotate di due prodotti di esempio predefiniti:
- Antipasto
- Illimitato
Se necessario, specificare altre impostazioni. È anche possibile specificare le impostazioni in un secondo momento tramite la scheda Impostazioni . Queste impostazioni sono illustrate nell'esercitazione Importare e pubblicare la prima API .
Fare clic su Crea.

Aggiungere un'app per le funzioni a un'API esistente

Per aggiungere un'app per le funzioni a un'API esistente:

Nell'istanza del servizio Gestione API di Azure selezionare API>nel riquadro sinistro.
Scegli un'API a cui vuoi importare una funzione app. Selezionare i puntini di sospensione (...) accanto all'API e quindi selezionare Importa:
Selezionare il riquadro Funzioni App
Nella finestra Importa da app per le funzioni selezionare Sfoglia:
Fare clic sul pulsante Seleziona in Configura le impostazioni necessarie per scegliere dall'elenco delle app per le funzioni disponibili:
Trovare l'app per le funzioni da cui si vuole importare le funzioni, selezionarla e quindi fare clic su Seleziona:
Selezionare le funzioni da importare e quindi fare clic su Seleziona:
Selezionare Importa:

Autorizzazione

Quando si importa un'app per le funzioni di Azure, questi elementi vengono generati automaticamente:

Chiave host nell'app per le funzioni. La chiave è denominata apim-<your API Management service instance name>.
Valore denominato nell'istanza di Gestione API con il nome <your Azure function app instance name>-key. Questo valore contiene la chiave host.

Per le API create dopo il 4 aprile 2019, la chiave host viene passata nelle richieste HTTP da *API Management* all'applicazione funzione in un'intestazione. Le API precedenti passano la chiave host come parametro di query. È possibile modificare questo comportamento usando la PATCH Backendchiamata API REST sull'entità Backend associata all'app per le funzioni.

Avviso

La rimozione o la modifica del valore della chiave host dell'app per le funzioni di Azure o del valore denominato di Gestione API disabiliterà la comunicazione tra i servizi. I valori non vengono sincronizzati automaticamente.

Se è necessario ruotare la chiave host, assicurarsi di modificare anche il valore denominato in Gestione API.

Accedere a una chiave host dell'app per le funzioni

Vai all'istanza della tua app di funzioni Azure:
Nella sezione Funzioni del riquadro sinistro selezionare Chiavi dell'app:
Trovare le chiavi nella sezione Chiavi host :

Accedere al valore nominato in Gestione API

Passare all'istanza di Gestione API e selezionare API>Valori denominati nel riquadro sinistro. La chiave dell'app per le funzioni di Azure viene archiviata in questa posizione.

Testare la nuova API nel portale di Azure

È possibile chiamare le operazioni direttamente dal portale di Azure. Il portale di Azure offre un sistema pratico per visualizzare e testare le operazioni di un'API.

Selezionare l'API creata nella sezione precedente.
Selezionare la scheda Test.
Selezionare l'operazione da testare.
- La pagina visualizza campi per le intestazioni e per i parametri di query.
- Una delle intestazioni è Ocp-Apim-Subscription-Key. Questa intestazione si riferisce alla chiave di abbonamento del prodotto associata all'API.
- Se è stata creata l'istanza di Gestione API, si è un amministratore, quindi la chiave viene compilata automaticamente.
Selezionare Invia.

Quando il test ha esito positivo, il back-end risponde con 200 OK e alcuni dati.

Condividi tramite