Compartilhar via

Importar uma API do gRPC

APLICA-SE A: Desenvolvedor | Básico | Padrão | Premium

Este artigo mostra como importar uma definição de serviço gRPC como uma API no Gerenciamento de API. Em seguida, você pode gerenciar a API no Gerenciamento de API, proteger o acesso e aplicar outras políticas e passar 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:

  • Carregue o arquivo de definição protobuf (buffer de protocolo) da API no Gerenciamento de API.
  • Especifique a localização 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 saber mais sobre gRPC, consulte Introdução ao gRPC.

Observação

  • As APIs gRPC têm suporte no gateway auto-hospedado e no gateway gerenciado para instâncias de camada clássica criadas a partir de janeiro de 2026 (versão prévia). Contate o suporte para habilitar o suporte à API gRPC em instâncias de camada clássicas criadas antes dessa data. Atualmente, não há suporte para APIs gRPC nas camadas v2.
  • 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 protobuf (.proto).

Pré-requisitos

Adicionar uma API gRPC

  1. No portal do Azure, acesse sua instância de Gerenciamento de API.

  2. Em APIs no menu da barra lateral, selecione APIs.

  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, especifique as seguintes configurações:

    1. Insira um nome de exibição.

    2. Para carregar o esquema, selecione um arquivo .proto local associado à API a ser importada.

    3. Para a URL do servidor gRPC, insira o endereço do serviço gRPC. Esse endereço precisa estar acessível via HTTPS.

    4. Para Gateways, selecione o recurso de gateway que você deseja usar para expor a API.

  6. Insira as configurações restantes para definir sua API. O tutorial Importar e publicar sua primeira API explica essas configurações.

  7. Selecione Criar.

    O portal adiciona a API à lista de APIs . Você pode exibir e atualizar suas configurações acessando a guia Configurações da API.

Chamar serviços gRPC usando o .NET

Para obter informações sobre como chamar serviços gRPC usando o .NET, consulte os seguintes artigos:

Acrescentar outras APIs

Você pode compor uma API a partir de APIs que são disponibilizadas por diferentes serviços, incluindo:

  • Uma especificação do OpenAPI
  • Uma API SOAP
  • Uma API do GraphQL
  • Um aplicativo Web hospedado no Serviço de Aplicativo do Azure
  • Azure Functions
  • Aplicativo Lógico do Azure
  • Azure Service Fabric

Observação

Quando você importa uma API, as operações são acrescentadas à API atual.

Para acrescentar uma API a uma API existente:

  1. Acesse sua instância de Gerenciamento de API do Azure no portal do Azure:

    Captura de tela que mostra a página Serviços de Gerenciamento de API.

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

    Captura de tela que mostra a seleção de APIs na página Visão geral.

  3. Selecione as reticências (...) próximas à API na qual deseja acrescentar outra API.

  4. Selecione Importar no menu de contexto:

    Captura de tela que mostra o comando Importar.

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

Conteúdo relacionado

  • Last updated on