Agora que configurou o Google Cloud e a IU do Apigee, e instalou e configurou o tempo de execução, está pronto para ver como tudo funciona em conjunto.
1. Crie um novo proxy de API através da IU do Apigee
Esta secção descreve como criar um novo proxy de API na IU através do assistente de proxy de API.
Apigee na Cloud Console
Para criar um novo proxy de API através do Apigee na Cloud Console:
Selecione a sua organização no menu pendente no canto superior esquerdo.
Selecione Desenvolvimento de proxy > Proxies de API na vista principal.
Clique em Criar.O assistente de proxy de API é iniciado.
Selecione Proxy inverso (mais comum).
É apresentada a vista Detalhes do proxy.
Configure o proxy com as seguintes definições:
Nome do proxy: introduza myproxy. Os passos restantes nesta secção partem do princípio
que este é o ID do seu proxy.
Caminho base: definido automaticamente como / seguido do nome do proxy, que neste exemplo é /myproxy. O caminho
base faz parte do URL usado para fazer pedidos à sua API. O Apigee usa o URL para
fazer corresponder e encaminhar os pedidos recebidos para o proxy de API adequado.
(Opcional) Descrição: introduza uma descrição para o novo proxy de API, como "Testar o Apigee hybrid com um proxy simples".
Destino (API existente): introduza "https://mocktarget.apigee.net". Isto define o URL de destino que o Apigee invoca num pedido ao proxy de API. O serviço mocktarget está alojado no Apigee e devolve dados simples. Não requer uma chave da API nem um token de acesso.
Os detalhes do proxy de API devem ter o seguinte aspeto:
Clicar em Seguinte.
Em Implementar (opcional), tem a opção de selecionar um ou mais
ambientes
nos quais implementar o proxy no campo Ambientes de implementação.
Se preferir não implementar o proxy neste
ponto, deixe o campo Ambientes de implementação vazio. Pode sempre implementar o proxy mais tarde.
Clique em Criar.
O Apigee gera o proxy (por vezes, denominado pacote de proxy).
O Apigee apresenta a vista Resumo do proxy.
Se optou por implementar o proxy, a secção Implementações apresenta o número da Revisão, que é 1 quando implementa pela primeira vez. A coluna Estado apresenta os
ambientes nos quais o proxy está implementado com um indicador de estado verde.
Abaixo, a secção Revisões mostra todas as revisões feitas a este proxy. Clicando num dos itens VER na coluna Resumo do ponto final, a secção Ponto final apresenta:
Pontos finais de proxy: o caminho base que define para o proxy, que neste exemplo é /myproxy.
Pontos finais de destino: o caminho base que define para o destino, que neste exemplo é https://mocktarget.apigee.net.
Apigee clássico
Para criar um novo proxy de API com o Apigee clássico:
Selecione a sua organização no menu pendente no canto superior esquerdo.
Selecione Desenvolver > Proxies de API na vista principal.
Clique em Criar novo.O assistente de proxy de API é iniciado.
Selecione Proxy inverso (mais comum).
É apresentada a vista Detalhes do proxy.
Configure o proxy com as seguintes definições:
Nome do proxy: introduza "myproxy". Os passos restantes nesta secção partem do princípio de que este é o ID do seu proxy.
Caminho base do proxy: definido automaticamente como "/myproxy". O caminho base do proxy faz parte do URL usado para fazer pedidos à sua API. O Apigee usa o URL para
fazer corresponder e encaminhar os pedidos recebidos para o proxy de API adequado.
(Opcional) Descrição: introduza uma descrição para o novo proxy de API, como "Testar o Apigee hybrid com um proxy simples".
Destino (API existente): introduza "https://mocktarget.apigee.net". Isto define o URL de destino que o Apigee invoca num pedido ao proxy de API. O serviço mocktarget está alojado no Apigee e devolve dados simples. Não requer uma chave da API nem um token de acesso.
Os detalhes do proxy de API devem ter o seguinte aspeto:
Clicar em Seguinte.
No ecrã Políticas comuns, selecione Pass through (no authorization) como a opção de segurança.
Clicar em Seguinte.
No ecrã Resumo, selecione um ambiente para implementar o proxy e
clique em Criar e implementar.
O Hybrid gera o proxy (por vezes, denominado o pacote de proxy) e implementa-o no ambiente que selecionou.
Clique em Aceder à lista de proxies.
O Apigee apresenta a vista Proxies, que apresenta uma lista de proxies de API. O
novo proxy deve ser apresentado com um indicador de estado verde, o que significa que foi implementado.
2. Chame o proxy da API
Quando a IU indicar que o proxy está implementado, pode tentar chamá-lo através do cURL ou do cliente REST à sua escolha.
Por exemplo:
Encontre o endereço IP externo e a porta do gateway de entrada do Apigee com o seguinte comando:
kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
O resultado deve ter um aspeto semelhante ao seguinte:
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
apigee-ingressgateway-prod-hybrid-37a39bd LoadBalancer 192.0.2.123 233.252.0.123 15021:32049/TCP,80:31624/TCP,443:30723/TCP 16h
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-21 UTC."],[[["\u003cp\u003eThis content guides you through creating a new API proxy in Apigee using either the Apigee in Cloud console or the classic Apigee UI, with both methods using a step by step approach.\u003c/p\u003e\n"],["\u003cp\u003eWhen setting up the API proxy, you will need to choose a reverse proxy setup, assign a proxy name (like 'myproxy'), a base path, and a target API, such as "https://mocktarget.apigee.net".\u003c/p\u003e\n"],["\u003cp\u003eAfter creating the proxy, you can optionally deploy it to one or more environments and will then see the deployment status and revision number in the UI.\u003c/p\u003e\n"],["\u003cp\u003eOnce the proxy is deployed, you can call it using cURL or a REST client by setting environment variables for the domain, external IP address, and port, followed by executing a cURL command.\u003c/p\u003e\n"],["\u003cp\u003eA successful call to the created API proxy will result in an HTTP 200 response and outputting "Hello, Guest!".\u003c/p\u003e\n"]]],[],null,["# Step 2: Deploy an API proxy\n\n| You are currently viewing version 1.14 of the Apigee hybrid documentation. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\nNow that you've configured and the Apigee UI, and installed and configured the\nruntime, you're ready to see how it all works together.\n\n1. Create a new API proxy using the Apigee UI\n---------------------------------------------\n\nThis section describes how to create a new API proxy in the UI using the API Proxy Wizard.\n**Note:** There is a new version of the Apigee UI, which is integrated with the Google Cloud console. The new UI is called *Apigee in Cloud console*. The instructions in the first two tabs below explain how to use either Apigee in Cloud console or classic Apigee UI. \n\n### Apigee in Cloud console\n\nTo create a new API proxy using Apigee in Cloud console:\n\n1. Open [Apigee UI in Cloud console](https://console.cloud.google.com/apigee) in a browser.\n2. Select your organization from the dropdown menu in the upper left corner.\n3. Select **Proxy development \\\u003e API proxies** in the main view.\n4. Click **Create**.The API Proxy Wizard starts.\n5. Select **Reverse proxy** (most common).\n\n The **Proxy details** view is displayed.\n6. Configure your proxy with the following settings:\n - **Proxy name:** Enter **myproxy**. The remaining steps in this section assume that this is your proxy's ID.\n - **Base path:** Automatically set to **/** followed by the proxy name, which in this example is **/myproxy** . The **Base\n path** is part of the URL used to make requests to your API. Apigee uses the URL to match and route incoming requests to the proper API proxy.\n - (Optional)**Description:** Enter a description for your new API proxy, such as \"Testing Apigee hybrid with a simple proxy\".\n - **Target (Existing API):** Enter \"https://mocktarget.apigee.net\". This defines the target URL that Apigee invokes on a request to the API proxy. The mocktarget service is hosted at Apigee and returns simple data. It requires no API key or access token.\n\n Your API proxy's details should look like the following:\n\n7. Click **Next**.\n8. Under **Deploy (optional)** , you have the option to select one or more environments in which to deploy your proxy, in the **Deployment environments** field. If you prefer not to deploy the proxy at this point, leave the **Deployment environments** field empty. You can always deploy the proxy later.\n9. Click **Create** . Apigee generates the proxy (sometimes referred to as *the proxy bundle* ).\n\n \u003cbr /\u003e\n\nApigee displays the **Proxy summary** view.\nIf you chose to deploy the proxy, the **Deployments** section displays the **Revision**\nnumber, which is 1 when you first deploy. The **Status** column displays the\nenvironments in which the proxy is deployed with a green status indicator.\n\nBelow that, the **Revisions** section shows all revisions made to this proxy. By\nclicking on one of the **VIEW** items in the **Endpoint summary** column, the\n**Endpoint** section displays:\n\n- **Proxy endpoints** : The basepath you set for the proxy, which is this example is `/myproxy`.\n- **Target endpoints** : The basepath you set for the target, which in this example is `https://mocktarget.apigee.net`.\n\n### Classic Apigee\n\nTo create a new API proxy using Classic Apigee:\n\n1. Open [Apigee UI](https://apigee.google.com) in a browser.\n2. Select your organization from the dropdown menu in the upper left corner.\n3. Select **Develop \\\u003e API Proxies** in the main view.\n4. Click **Create New**.The API Proxy Wizard starts.\n5. Select **Reverse proxy** (most common).\n\n The **Proxy details** view is displayed.\n6. Configure your proxy with the following settings:\n - **Proxy Name:** Enter \"myproxy\". The remaining steps in this section assume that this is your proxy's ID.\n - **Proxy Base Path:** Automatically set to \"/myproxy\". The **Proxy Base\n Path** is part of the URL used to make requests to your API. Apigee uses the URL to match and route incoming requests to the proper API proxy.\n - (Optional)**Description:** Enter a description for your new API proxy, such as \"Testing Apigee hybrid with a simple proxy\".\n - **Target (Existing API):** Enter \"https://mocktarget.apigee.net\". This defines the target URL that Apigee invokes on a request to the API proxy. The mocktarget service is hosted at Apigee and returns simple data. It requires no API key or access token.\n\n Your API proxy's details should look like the following:\n\n7. Click **Next**.\n8. On the **Common policies** screen, select **Pass through (no authorization)** as the security option.\n9. Click **Next**.\n10. On the **Summary** screen, select an environment to deploy your proxy to and click **Create and Deploy** .\n\n Hybrid generates the proxy (sometimes referred to as *the proxy bundle*) and deploys it to the environment you selected.\n11. Click **Go to proxy list** .\n\n Apigee displays the **Proxies** view, which displays a list of API proxies. Your\n new proxy should display with a green status indicator, meaning that it has been deployed.\n\n2. Call the API proxy\n---------------------\n\nWhen the UI indicates your proxy is deployed, you can try calling it using cURL or the REST\nclient of your choice.\nFor example:\n\n1. Make sure your `DOMAIN` environment variable is set to the domain name you used for the hostname for your environment group in [Project and org\n setup - Step 3: Create an environment group](/apigee/docs/hybrid/v1.14/precog-add-environment). \n\n ```\n echo $DOMAIN\n ```\n2. Find the external IP address and port of the Apigee ingress gateway with the following command:\n\n ```\n kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway\n ```\n\n\n Your output should look something like: \n\n ```\n NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE\n apigee-ingressgateway-prod-hybrid-37a39bd LoadBalancer 192.0.2.123 233.252.0.123 15021:32049/TCP,80:31624/TCP,443:30723/TCP 16h\n ```\n3. Export your external IP and port to variables: \n\n export INGRESS_IP_ADDRESS=EXTERNAL_IP_ADDRESS\n export INGRESS_PORT=\u003cvar translate=\"no\"\u003ePORT_NUMBER\u003c/var\u003e\n\n4. Call the API proxy: \n\n ```\n curl -H Host:$DOMAIN --resolve \\\n $DOMAIN:$INGRESS_PORT:$INGRESS_IP_ADDRESS \\\n https://$DOMAIN:$INGRESS_PORT/myproxy -k -v\n ```\n\n\n For example: \n\n ```\n curl -v -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k -v\n ```\n5. A successful call to the proxy returns an HTTP 200 response code and the following output.\u003cbr /\u003e\n\n ```\n Hello, Guest!\n ```\n\n\nTo learn more about building and deploying API proxies, see [Build your first proxy overview](/apigee/docs/api-platform/get-started/get-started).\n| **Congratulations!**\n|\n| You've successfully installed Apigee hybrid. To learn more about building and deploying\n| API proxies, see [Introduction to API proxy building](/apigee/docs/api-platform/fundamentals/build-simple-api-proxy).\n\n*[Google Cloud]: Google Cloud"]]
