Compartilhar via

Importar uma API do gRPC

  • Artigo

APLICA-SE A: Desenvolvedor | Premium

Este artigo mostra como importar uma definição de serviço gRPC como uma API no Gerenciamento de API. Em seguida, você poderá gerenciar a API no Gerenciamento de API, proteger o acesso e aplicar outras polícias e transmitir solicitações de API gRPC por meio do gateway para o back-end gRPC.

Para adicionar uma API gRPC ao Gerenciamento de API, você precisa:

  • Carregar o arquivo de definição Protobuf (buffer de protocolo) da API no Gerenciamento de API
  • Especificar o local do serviço gRPC
  • Configurar a API no Gerenciamento de API

O Gerenciamento de API dá suporte à passagem com os seguintes tipos de métodos de serviço gRPC: unário, streaming de servidor, streaming de cliente e streaming bidirecional. Para obter informações sobre o gRPC, confira Introdução ao gRPC.

Observação

  • Atualmente, só há suporte para as APIs gRPC no gateway auto-hospedado, não no gateway gerenciado da sua instância do Gerenciamento de API.
  • Atualmente, não há suporte para o teste de APIs gRPC no console de teste do portal do Azure nem no portal do desenvolvedor do Gerenciamento de API.
  • A importação é limitada a um único arquivo Protobuff (.proto).

Pré-requisitos

Adicionar uma API gRPC

  1. No portal do Azure, navegue até a instância do Gerenciamento de API.

  2. No menu à esquerda, selecione APIs>+ Adicionar API.

  3. Em Definir uma nova API, selecione gRPC.

    Captura de tela da criação de uma API gRPC no portal.

  4. Na janela Criar uma API gRPC, selecione Completo.

  5. Para uma API gRPC, é preciso especificar as seguintes configurações:

    1. Em Carregar esquema, selecione um arquivo .proto local associado à API a ser importada.

    2. Na URL do servidor gRPC, insira o endereço do serviço gRPC. Esse endereço precisa estar acessível via HTTPS.

    3. Em Gateways, selecione o recurso de gateway que deseja usar para expor a API.

      Importante

      Na versão prévia pública, só é possível selecionar um gateway auto-hospedado. Não há suporte para o gateway gerenciado.

  6. Insira as configurações restantes para configurar sua API. Essas configurações são explicadas no tutorial Importar e publicar sua primeira API.

  7. Selecione Criar.

    A API é adicionada à lista de APIs . Visualize e atualize as configurações acessando a guia Configurações da API.

Chamar os serviços gRPC com o .NET

Para obter informações sobre como chamar os serviços gRPC com o .NET, consulte os artigos a seguir:

Acrescentar outras APIs

Você pode compor uma API de APIs expostas por diferentes serviços, incluindo:

  • Uma especificação do OpenAPI
  • Uma API SOAP
  • Uma API da GraphQL
  • Um aplicativo Web hospedado no Serviço de Aplicativo do Azure
  • Aplicativo de Funções do Azure
  • Aplicativos Lógicos do Azure
  • Azure Service Fabric

Acrescente uma API diferente da API existente usando as etapas a seguir.

Observação

Ao importar outra API, as operações são acrescentadas à sua API atual.

  1. Vá para sua instância de Gerenciamento de API do Azure no portal do Azure.

    Captura de tela da navegação até a instância de Gerenciamento de API no portal.

  2. Selecione APIs na página Visão geral ou no menu à esquerda.

    Captura de tela da seleção de APIs na página de Visão Geral no portal.

  3. Clique em ... ao lado da API à qual você deseja acrescentar outra API.

  4. Selecione Importar no menu suspenso.

    Selecionar Importar

  5. Selecione um serviço de onde será importada a API.

    Captura de tela da seleção de um serviço no portal.