Condividi tramite

Importare un'API gRPC

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

  • 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.
  • L'importazione è limitata a un singolo file Protobuff (estensione .proto).

Prerequisiti

Aggiungere un'API gRPC

  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.

    Screenshot della creazione di una API gRPC nel portale.

  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.

Chiamare servizi gRPC con .NET

Per informazioni sulla chiamata di servizi gRPC con .NET, vedere gli articoli seguenti:

Aggiungere altre API

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

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

Nota

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

Per aggiungere un'API a un'API esistente:

  1. Passare all'istanza di Gestione API di Azure nel portale di Azure:

    Screenshot che mostra la pagina Dei servizi gestione API.

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

    Screenshot che mostra la selezione delle API nella pagina Panoramica.

  3. Selezionare i puntini di sospensione (...) accanto all'API a cui si vuole aggiungere un'altra API.

  4. Selezionare Importa dal menu a discesa:

    Screenshot che mostra il comando Import.

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

Contenuti correlati