Partilhar via

Importar uma API gRPC

APLICA-SE A: Desenvolvedor | Básico | Padrão | Avançado

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 através 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 para o Gerenciamento de API.
  • Especifique o local do seu serviço gRPC.
  • Configure a API na Gestão de API.

O Gerenciamento de API oferece 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 o gRPC, consulte Introdução ao gRPC.

Nota

  • As APIs gRPC são suportadas no gateway autogerido e no gateway gerido para instâncias do nível clássico criadas a partir de janeiro de 2026 (versão preliminar). Contacte o suporte técnico para ativar o suporte à API gRPC em instâncias da camada clássica criadas anteriores a esta data. As APIs gRPC atualmente não são suportadas nos níveis v2.
  • Atualmente, o teste de APIs gRPC não é suportado no console de teste do portal do Azure ou no portal do desenvolvedor do Gerenciamento de API.
  • A importação é limitada a um único arquivo protobuf (.proto).

Pré-requisitos

  • Uma instância de gerenciamento de API. Se você ainda não tiver uma, conclua o seguinte início rápido: Criar uma instância de Gerenciamento de API do Azure.

  • Um arquivo gRPC protobuf (.proto) disponível localmente e um serviço gRPC acessível por HTTPS.

  • Suporte ao protocolo HTTP/2 ativado para tráfego de clientes. Para mais informações, consulte Gerir protocolos e cifras no Azure API Management.

Adicionar uma API gRPC

  1. No portal do Azure, vá para 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 definições:

    1. Insira um nome para exibição.

    2. Em Esquema de carregamento, selecione um arquivo .proto local associado à API a ser importado.

    3. Para URL do servidor gRPC, insira o endereço do serviço gRPC. O endereço deve ser acessível por HTTPS.

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

  6. Insira as configurações restantes para configurar sua API. O tutorial Importar e publicar a tua primeira API explica estas definições.

  7. Selecione Criar.

    O portal adiciona a API à lista de APIs . Podes ver e atualizar as tuas definições indo ao separador Definições da API.

Chamar serviços gRPC usando .NET

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

Anexar outras APIs

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

  • Uma especificação OpenAPI
  • Uma API SOAP
  • Uma API GraphQL
  • Um Aplicativo Web hospedado no Serviço de Aplicativo do Azure
  • Funções do Azure
  • Azure Logic Apps
  • Azure Service Fabric

Nota

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

Para acrescentar uma API a uma API existente:

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

    Captura de tela que mostra a página de 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 (...) ao lado da API à qual deseja acrescentar outra API.

  4. Selecione Importar no menu contextual:

    Captura de tela que mostra o comando Importar.

  5. Selecione um serviço a partir do qual quer importar uma API.

Conteúdo relacionado

  • Last updated on