Importare un'API gRPC (anteprima)

SI APPLICA A: Sviluppatore | Premium

Questo articolo illustra come importare una definizione di servizio gRPC come API in Gestione API. È quindi possibile gestire l'API in Gestione API, proteggere l'accesso e applicare altri criteri e passare richieste API gRPC al back-end gRPC tramite il gateway.

Per aggiungere un'API gRPC a Gestione API, è necessario:

• Caricare il file di definizione Protobuf (buffer del protocollo) dell'API in Gestione API
• Specificare la posizione del servizio gRPC
• Configurare l'API in Gestione API

Gestione API supporta il pass-through con i seguenti tipi di metodi del servizio gRPC: unario, streaming server, streaming client e streaming bidirezionale. Per informazioni generali su gRPC, vedere Introduzione a gRPC.

Nota

• L'importazione di un'API gRPC è in anteprima. Attualmente, le API gRPC sono supportate solo nel gateway self-hosted, non nel gateway gestito per l'istanza di Gestione API.
• Attualmente, il test delle API gRPC non è supportato nella console di test del portale di Azure o nel portale per sviluppatori di Gestione API.

Prerequisiti

• Un'istanza di Gestione API. Se non è già disponibile, completare l’avvio rapido seguente: Creare un'istanza di Gestione API di Azure.

• Risorsa gateway di cui è stato effettuato il provisioning nell'istanza. Se non è già disponibile, vedere Effettuare il provisioning di un gateway self-hosted in Gestione API di Azure.

• Un file gRPC Protobuff (con estensione proto) disponibile localmente e un servizio gRPC accessibile tramite HTTPS.

Aggiungere un'API gRPC

Portale

1. Nel portale di Azure accedere all'istanza di Gestione API.

2. Nel menu a sinistra selezionare API >+ Aggiungi API.

3. In Definisci una nuova API selezionare gRPC.

   

4. Nella finestra Crea un'API gRPC selezionare Completa.

5. Per un'API gRPC, è necessario specificare le impostazioni seguenti:

   1. In Carica schema selezionare un file .proto locale associato all'API da importare.

   2. In URL del server gRPC immettere l'indirizzo del servizio gRPC. L'indirizzo deve essere accessibile tramite HTTPS.

   3. In Gateway selezionare la risorsa gateway che si vuole usare per esporre l'API.

      Importante

      Nell'anteprima pubblica è possibile selezionare solo un gateway self-hosted. Il gateway gestito non è supportato.

6. Immettere le impostazioni rimanenti per configurare l'API. Queste impostazioni sono illustrate nell'esercitazione Importare e pubblicare la prima API.

7. Seleziona Crea.

   L'API viene aggiunta all'elenco API. È possibile visualizzare l'aggiornamento delle impostazioni passando alla scheda Impostazioni dell'API.

Aggiungere altre API

È possibile comporre un'API di API esposte da diversi servizi, tra cui:

• Una specifica OpenAPI
• Un’API SOAP
• Un’API GraphQL
• Un'app Web ospitata nel servizio app di Azure
• App per le funzioni di Azure
• App per la logica di azure
• Azure Service Fabric

Aggiungere un'API diversa all'API esistente seguendo questa procedura.

Nota

Quando si importa un'altra API, le operazioni vengono aggiunte all'API corrente.

1. Vai alla tua istanza di Gestione API di Azure nel portale di Azure.

   

2. Selezionare API nella pagina Panoramica o nel menu a sinistra.

   

3. Fare clic su ... accanto all'API a cui si vuole aggiungere un'altra API.

4. Nel menu a discesa selezionare Importa.

   

5. Selezionare un servizio da cui importare un'API.

   

Argomenti correlati

• Limitazioni relative all'importazione di API
• Importare una specifica OpenAPI
• Importare un'API SOAP
• Importare un'API SOAP e convertirla in REST
• Importare un'API del servizio app
• Importare un'API dell'app contenitore
• Importare un'API WebSocket
• Importare un'API GraphQL
• Importare uno schema di GraphQL e configurare resolver di campo
• Importare un'app per le funzioni di Azure
• Importare un'app per la logica di Azure
• Importare un servizio Service Fabric
• Importare un'API OData
• Importare metadati OData SAP
• Importare un'API gRPC
• Modificare un'API