Começar a usar o gateway de API e o hub de APIs

Neste tutorial, mostramos como conectar o gateway de API ao Hub de API para permitir a publicação perfeita de metadados de API do projeto do gateway de API para o Hub de API.

Neste tutorial, você vai usar o console Google Cloud .

Lista de tarefas

Ao seguir o tutorial, use a lista de tarefas abaixo. Todas as tarefas são necessárias para conectar o gateway de API ao hub de APIs.

1. Siga as etapas de pré-requisito descritas em Antes de começar.

2. Implante uma API no API Gateway.

3. Anexe seu projeto do API Gateway ao hub de APIs.

4. Confira a API do API Gateway no hub de APIs.

5. Evite cobranças na sua conta do Google Cloud. Consulte Limpeza.

Antes de começar

Antes de começar, verifique se você concluiu as etapas de pré-requisito a seguir:

1. Configure o API Gateway no seu projeto.

2. Configure o hub de API no projeto host.

Configurar o API Gateway no projeto

Para configurar o API Gateway no seu projeto, faça o seguinte:

1. No console do Google Cloud , acesse a página Gateway de API.

   Acessar o API Gateway

   Observação: se você não pretende manter os recursos criados neste tutorial, crie um novo projeto em vez de selecionar um existente. Depois de concluir esses passos, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

2. A API Gateway requer a ativação dos seguintes serviços do Google:

   Nome	Nome
   apigateway.googleapis.com	API Gateway
   servicemanagement.googleapis.com	Service Management API
   servicecontrol.googleapis.com	API Service Control

   Se você ainda não tiver ativado esses serviços para o projeto selecionado, será solicitado que faça isso.

3. Confirme se o faturamento está ativado no projeto.

   Saiba como ativar o faturamento

Configurar o hub de API no projeto host

1. Crie ou selecione um projeto do Google Cloud para usar como projeto host.

   Um projeto host é um projeto do Google Cloud na sua organização do Google Cloud que você designa como o projeto do consumidor para todos os recursos do hub de APIs. Só uma instância do hub de APIs pode ser provisionada por projeto host.

   Para oferecer descoberta centralizada de APIs em todos os gateways de API, recomendamos usar um projeto host dedicado para a instância do hub de APIs e anexar vários projetos do gateway de API, chamados de projetos de execução, à instância do hub de APIs.

   Se uma instância do hub de API já estiver provisionada na sua organização ou pasta Google Cloud , recomendamos que você pule esta etapa e anexe seu projeto do API Gateway à instância do hub de API.

2. Conceda os papéis do Identity and Access Management (IAM) necessários para conectar o API Gateway ao API Hub.

3. Provisione o hub de API no projeto host.

Implantar uma API no gateway de API

Conclua o guia de início rápido do gateway de API para implantar um serviço "hello world" do Cloud Run e criar um gateway que aponte para esse serviço.

Por exemplo, a API helloworld é implantada no Gateway de API helloworld-gateway, conforme mostrado na página "Gateways" em Google Cloud console.

Anexe seu projeto do API Gateway ao hub de APIs

Para anexar seu projeto do API Gateway ao hub de API, faça o seguinte:

1. No console do Google Cloud , acesse a página Hub de APIs.

   Acesse o hub de API

2. Selecione o projeto host do hub de API no menu suspenso.
3. Clique em Configurações no menu de navegação à esquerda para abrir a página Configurações.
4. Acesse a guia Associações de projetos.
5. Clique em Anexar projeto de ambiente de execução.
   O painel Selecionar um recurso vai aparecer.
6. Clique no projeto Google Cloud em que o API Gateway está provisionado.
7. No painel Configurações de associação de projeto, selecione API Gateway e outros recursos de API que você quer importar automaticamente.
8. Clique em Salvar.

Seu projeto de ambiente de execução é anexado e exibido na lista de projetos anexados no console do Google Cloud .

Exemplo:

Para ativar a ingestão de dados em tempo real, o hub de APIs cria uma instância de plug-in do API Gateway para o projeto de ambiente de execução anexado quando você seleciona importar recursos do API Gateway. É possível conferir essa instância de plug-in na coluna Plug-ins associados da página Associações de projetos.

Ver a API do API Gateway no hub de API

Para ver sua API do API Gateway no hub de API, faça o seguinte:

1. No console do Google Cloud , acesse a página APIs no Hub de APIs.

   Acesse o hub de API

2. Localize a API "hello world" implantada no gateway de API.

   Se necessário, selecione Gateway: gateway de API no menu suspenso Filtro para mostrar apenas as APIs do gateway de API.

   Exemplo:

   

3. Clique na API para ver mais detalhes, incluindo os metadados da API.

Limpar

Para evitar cobranças na sua conta do Google Cloud pelos recursos usados neste tutorial, faça o seguinte:

• Excluir o gateway
• Excluir sua API

Como alternativa, também é possível excluir os Google Cloud projetos usados neste tutorial.

A seguir

• Saiba mais sobre o gateway de API.
• Saiba como centralizar suas APIs usando o hub de APIs