Condividi tramite

Importare un'API gRPC

  • Articolo

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

Per aggiungere un'API diversa all'API esistente, seguire 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.

    Screenshot del passaggio a Gestione API'istanza nel portale.

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

    Screenshot della selezione delle API nella pagina Panoramica del portale.

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

  4. Nel menu a discesa selezionare Importa.

    Selezionare Importa

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

    Screenshot della selezione di un servizio nel portale.