Passos seguintes recomendados

Esta página aplica-se ao Apigee e ao Apigee Hybrid.

Veja a documentação do Apigee Edge.

O que está a fazer neste passo

Siga os passos abaixo para criar e implementar um proxy de API de teste. Por último, teste o proxy de API enviando-lhe um pedido HTTP.

Crie e implemente um proxy de API

O processo de aprovisionamento do Apigee não cria nem implementa automaticamente um proxy de API para si. Tem de criar e implementar um proxy manualmente.

IU do Apigee na Cloud Console

Para criar e implementar o seu primeiro proxy:

  1. Na Google Cloud consola, aceda à página Desenvolvimento de proxy > Proxies de API.

    Aceda aos proxies de API

  2. Certifique-se de que o nome da sua organização está selecionado no seletor de projetos no painel do Google Cloud. O nome da organização é igual ao nome do projeto. Google Cloud
  3. Clique em + Criar.

    É apresentada a página Criar um proxy.

  4. Na caixa Modelo de proxy, selecione Proxy inverso (mais comum).
  5. No Passo 1: detalhes do proxy, configure o proxy com os seguintes valores:
    Nome do parâmetro Valor
    Nome do proxy hello-world
    Caminho base /hello-world
    Destino (API existente) mocktarget.apigee.net
  6. Clicar em Seguinte.
  7. No Passo 2: implemente (opcional):
    • Ambientes de implementação: opcional. Use as caixas de verificação para selecionar um ou mais ambientes nos quais implementar o proxy. Se preferir não implementar o proxy neste momento, deixe o campo Ambientes de implementação vazio. Pode sempre implementar o proxy mais tarde.
    • Conta de serviço: opcional. Anexe uma conta de serviço à sua implementação para permitir que o proxy aceda aos serviços, conforme especificado na função e nas autorizações da conta de serviço. Google Cloud
  8. Clique em Criar.

    O novo proxy de API é criado e implementado no ambiente selecionado.

  9. É apresentada a página Resumo do proxy do proxy recém-criado. Uma marca de verificação verde em Estado indica que o proxy foi implementado com êxito. Se o proxy não estiver implementado, consulte o artigo Implementar um proxy de API e siga os passos para o implementar manualmente.
  10. No painel de navegação do lado esquerdo, selecione Gestão > Ambientes > Grupos de ambientes.
  11. Copie o nome do anfitrião do grupo de ambientes. Vai usar este nome de anfitrião para chamar o proxy da API nos passos seguintes.

Apigee clássico

Para criar e implementar o seu primeiro proxy:

  1. Inicie sessão na IU do Apigee.
  2. Certifique-se de que o nome da sua organização está selecionado no menu pendente no canto superior esquerdo da IU. O nome da organização é igual ao nome do seu projeto do Google Cloud.
  3. Clique em Proxies de API na vista principal.
  4. Na lista pendente Selecionar ambiente, selecione um ambiente.
  5. Clique em Criar novo.
  6. Clique em Proxy inverso (mais comum).
  7. Na página Detalhes do proxy, configure o proxy com os seguintes valores:
    Nome do parâmetro Valor
    Nome hello-world
    Caminho base /hello-world
    Destino (API existente) https://mocktarget.apigee.net
  8. Clicar em Seguinte.
  9. Na página Políticas comuns, em Segurança: Autorização, selecione Passar (sem autorização).
  10. Clicar em Seguinte.
  11. Na página Resumo, em Implementação opcional, selecione o ambiente no qual implementar o proxy.
  12. Clique em Criar e implementar.

    O novo proxy de API é criado e implementado no ambiente selecionado.

  13. Clique em Aceder à lista de proxies. Uma marca de verificação verde em Estado indica que o proxy foi implementado com êxito. Se o proxy não estiver implementado, consulte Implementar um proxy de API e siga os passos para o implementar manualmente.
  14. No painel de navegação do lado esquerdo, selecione Administração > Ambientes > Grupos.
  15. Clique em Ver na Google Cloud consola.
  16. Copie o nome do anfitrião do grupo de ambientes. Vai usar este nome de anfitrião para chamar o proxy da API nos passos seguintes.
  17. Feche a Google Cloud consola.

Ligue para o proxy com acesso interno

Se permitiu o acesso interno no Passo 4: Personalize o encaminhamento de acesso, siga as instruções em: Chamar um proxy de API com acesso apenas interno.

Chame o proxy com acesso externo

Se permitiu o acesso externo no Passo 4: Personalize o encaminhamento de acesso, siga estes passos:

  1. Configure uma entrada DNS para o seu anfitrião. Seguem-se duas formas de realizar esta tarefa:
    • Na entidade de registo, crie um registo A que direcione o nome de anfitrião do grupo de ambientes para o IP apresentado na página do assistente em Configurar DNS. Por exemplo, se o nome do anfitrião for sales.example.com e o IP for 10.23.0.2, direcione o registo de sales.example.com para o endereço 10.23.0.2.
    • Use o Cloud DNS da Google para mapear um URL para um endereço IP.
  2. Teste o proxy da API enviando o seguinte pedido numa janela de terminal: 
    curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \
  https://YOUR_INSTANCE_IP_OR_DNS/hello-world

    Onde:

    • O valor do cabeçalho Host (YOUR_ENV_GROUP_HOSTNAME) é o nome do anfitrião da página Ambientes > Grupos de ambientes.

    Um pedido bem-sucedido devolve a string: Hello, Guest!. Se o seu pedido não for bem-sucedido, consulte a secção Resolução de problemas.

Passos seguintes