Agora que você configurou o Google Cloud e a IU híbrida e instalou e configurou o
ambiente de execução, está pronto para ver como tudo funciona em conjunto.
1. Criar um novo proxy de API usando a IU híbrida
Nesta seção, descrevemos como criar um novo proxy de API na interface do usuário usando o Assistente de proxy de API.
Apigee no console do Cloud
Para criar um novo proxy de API usando a Apigee no Console do Cloud:
Selecione a organização no menu suspenso no canto superior esquerdo.
Selecione Desenvolvimento de proxy > Proxies de API na visualização principal.
Clique em Create.O assistente de proxy da API será iniciado.
Selecione Inverter proxy (mais comum).
A visualização Detalhes do proxy é exibida.
Defina seu proxy com as seguintes configurações:
Nome do proxy: digite myproxy. As demais etapas desta seção presumem
que este é o ID do seu proxy.
Caminho base: definido automaticamente como / seguido pelo nome do proxy, que neste exemplo é /myproxy. O Caminho
base faz parte do URL usado para fazer solicitações à API. O Edge usa o URL para
corresponder e rotear solicitações de entrada para o proxy da API apropriado.
(Opcional) Descrição: insira uma descrição para o novo proxy de API, por exemplo,
"Como testar a Apigee híbrida com um proxy simples".
Destino (API atual): insira "https://mocktarget.apigee.net". Isso define o
URL de destino que a Apigee invoca em uma solicitação para o proxy de API. O serviço simulado está
hospedado na Apigee e retorna dados simples. Ele não requer nenhuma chave de API nem um token de acesso.
Os detalhes do proxy da API precisam ser semelhantes a este:
Clique em Próxima.
Na tela Políticas, selecione Passar (sem autorização) como a
opção de segurança.
Clique em Próxima.
Em Implantar (opcional), você tem a opção de selecionar um ou mais ambientes em que implantará seu proxy no campo Ambientes de implantação.
Se preferir não implantar o proxy neste ponto, deixe o campo Ambientes de implantação em branco. O proxy poderá ser implantado posteriormente.
Clique em Criar.
A Apigee gera o proxy (às vezes chamado de pacote de proxy):
A Apigee exibe a visualização Resumo do proxy.
Se você optar por implantar o proxy, a seção Implantações exibe o número de revisão, que é 1 na primeira implantação. A coluna Status exibe os ambientes em que o proxy está implantado com um indicador de status verde.
Abaixo disso, a seção Endpoints exibe:
Endpoints do proxy: o caminho base definido para o proxy, que é o de exemplo, /myproxy.
Endpoints de destino: o caminho base definido para o destino, que neste exemplo é https://mocktarget.apigee.net.
Apigee clássica
Para criar um novo proxy de API usando a Apigee clássica:
Selecione a organização no menu suspenso no canto superior esquerdo.
Selecione Desenvolver > Proxies de API na visualização principal.
Clique em Create New.O assistente de proxy da API será iniciado.
Selecione Inverter proxy (mais comum).
A visualização Detalhes do proxy é exibida.
Defina seu proxy com as seguintes configurações:
Nome do proxy: digite "myproxy". As demais etapas desta seção presumem
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 solicitações à API. O Edge usa o URL para
corresponder e rotear solicitações de entrada para o proxy da API apropriado.
(Opcional) Descrição: insira uma descrição para o novo proxy de API, por exemplo,
"Como testar a Apigee híbrida com um proxy simples".
Destino (API atual): insira "https://mocktarget.apigee.net". Isso define o
URL de destino que a Apigee invoca em uma solicitação para o proxy da API. O serviço simulado está
hospedado na Apigee e retorna dados simples. Ele não requer nenhuma chave de API nem um token de acesso.
Os detalhes do proxy da API precisam ser semelhantes a este:
Clique em Próxima.
Na tela Políticas, selecione Passar (sem autorização) como a
opção de segurança.
Clique em Próxima.
Na tela Resumo, selecione um ambiente para implantar o proxy e
clique em Criar e implantar.
O híbrido gera o proxy (às vezes chamado de pacote de proxy):
Clique em Ir para a lista de proxy.
A Apigee exibe a visualização Proxies, que exibe uma lista de proxies de API. O
novo proxy será exibido com um indicador de status verde, o que significa que ele foi implantado.
2. Chamar o proxy da API
Quando a IU indicar
que o proxy está implantado, tente chamá-lo usando cURL ou o cliente REST de sua escolha:
Por exemplo:
Encontre o endereço IP externo e a porta do gateway de entrada da Apigee com o seguinte comando:
kubectl get svc -n apigee -l app=apigee-ingressgateway
A saída será semelhante a esta:
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-28 UTC."],[[["\u003cp\u003eThis document outlines how to create a new API proxy in Apigee using either the Apigee in Cloud console or the classic Apigee UI, starting with the API Proxy Wizard and selecting the "Reverse proxy" option.\u003c/p\u003e\n"],["\u003cp\u003eWhen configuring the API proxy, the "Proxy name" should be set to "myproxy", and the "Target (Existing API)" should be "https://mocktarget.apigee.net" to leverage the mocktarget service.\u003c/p\u003e\n"],["\u003cp\u003eDuring the API proxy creation, users can choose to deploy the proxy to selected environments or leave the deployment for later, but deployment status will be shown in a green status indicator.\u003c/p\u003e\n"],["\u003cp\u003eAfter the API proxy is created and deployed, the proxy can be tested by calling it using cURL, with the guide detailing how to find the necessary external IP address and port of the Apigee ingress gateway.\u003c/p\u003e\n"],["\u003cp\u003eThis document is for version 1.9 of the Apigee hybrid documentation, and readers are given the option to navigate to the supported versions page for more information.\u003c/p\u003e\n"]]],[],null,["# Step 10: Deploy an API proxy\n\n| You are currently viewing version 1.9 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. 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 by 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. Edge 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 **Policies** screen, select **Pass through (no authorization)** as the security option.\n9. Click **Next**.\n10. 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.\n11. 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 **Endpoints** 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. Edge 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 **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*):\n\n\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.9/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 -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\n ```\n\n\n For example: \n\n ```\n curl -H Host:example.com --resolve example.com:443:233.252.0.123 https://example.com:443/myproxy -k\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"]]