Importar uma API gRPC (versão prévia)
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
- A importação de uma API gRPC está em versão prévia. 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.
Pré-requisitos
Uma instância de Gerenciamento de API. Se você ainda não tem uma, conclua o seguinte guia de início rápido: Criar uma instância de Gerenciamento de API do Azure.
Um recurso de gateway provisionado na instância. Caso você ainda não tenha um, confira Provisionar um gateway auto-hospedado no Gerenciamento de API do Azure.
Um arquivo gRPC Protobuf (.proto) disponível localmente e um serviço gRPC acessível por HTTPS.
Adicionar uma API gRPC
No portal do Azure, navegue até a instância do Gerenciamento de API.
No menu à esquerda, selecione APIs>+ Adicionar API.
Em Definir uma nova API, selecione gRPC.
Na janela Criar uma API gRPC, selecione Completo.
Para uma API gRPC, é preciso especificar as seguintes configurações:
Em Carregar esquema, selecione um arquivo .proto local associado à API a ser importada.
Na URL do servidor gRPC, insira o endereço do serviço gRPC. Esse endereço precisa estar acessível via HTTPS.
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.
Insira as configurações restantes para configurar sua API. Essas configurações são explicadas no tutorial Importar e publicar sua primeira API.
Selecione Criar.
A API é adicionada à lista de APIs . Visualize e atualize as configurações acessando a guia Configurações da API.
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.
Vá para sua instância de Gerenciamento de API do Azure no portal do Azure.
Selecione APIs na página Visão geral ou no menu à esquerda.
Clique em ... ao lado da API à qual você deseja acrescentar outra API.
Selecione Importar no menu suspenso.
Selecione um serviço de onde será importada a API.
Tópicos relacionados
- Limitações de importação da API
- Importar uma especificação de OpenAPI
- Importar uma API SOAP
- Importar uma API SOAP e converter em REST
- Importar uma API do Serviço de Aplicativo
- Importar uma API do Aplicativo de Contêiner
- Importar uma API WebSocket
- Importar uma API do GraphQL
- Importar um esquema do GraphQL e configurar resolvedores de campo
- Importar um Aplicativo de Funções do Azure
- Importar um Aplicativo Lógico do Azure
- Importar um serviço do Service Fabric
- Importar uma API de OData
- Importar metadados do SAP OData
- Importar uma API do gRPC
- Editar uma API