Ahora que instalaste y configuraste el entorno de ejecución y la puerta de enlace de entrada de Apigee Hybrid, estás listo para ver cómo funciona todo en conjunto.
1. Crea un proxy de API nuevo con la IU de Apigee
En esta sección, se describe cómo crear un proxy de API nuevo en la IU con el asistente de proxy de API.
Apigee en la consola de Cloud
Para crear un proxy de API nuevo con Apigee en la consola de Cloud, haz lo siguiente:
Selecciona tu organización en el menú desplegable de la esquina superior izquierda.
Selecciona Desarrollo de proxy > Proxies de API en la vista principal.
Haz clic en Crear. Se iniciará el asistente de proxy de API.
Selecciona Proxy inverso (más común).
Se muestra la vista Detalles del proxy.
Configura tu proxy con los siguientes ajustes:
Nombre del proxy: Ingresa miproxy. En los pasos restantes de esta sección, se supone que este es el ID de tu proxy.
Ruta base: Se configura de forma automática en / seguida del nombre del proxy, que en este ejemplo es /myproxy. La ruta base es parte de la URL que se usa para realizar solicitudes a la API. Apigee usa la URL para hacer coincidir solicitudes entrantes y enrutarlas al proxy de API adecuado.
(Opcional) Descripción: Ingresa una descripción para tu nuevo proxy de API, como “Prueba de Apigee Hybrid con un proxy simple”.
Destino (API existente): Ingresa "https://mocktarget.apigee.net". Esto define la URL de destino que Apigee invoca en una solicitud al proxy de API. El servicio de destino ficticio se aloja en Apigee y muestra datos simples. No requiere una clave de API ni un token de acceso.
Los detalles de tu proxy de API deben tener el siguiente aspecto:
Haz clic en Siguiente.
En Implementar (opcional), tienes la opción de seleccionar uno o más entornos en los que implementar tu proxy en el campo Entornos de implementación.
Si prefieres no implementar el proxy en este punto, deja vacío el campo Entornos de implementación. Siempre puedes implementar el proxy más adelante.
Haz clic en Crear.
Apigee genera el proxy (a veces denominado el paquete del proxy):
Apigee muestra la vista Resumen del proxy.
Si eliges implementar el proxy, la sección Implementaciones muestra el número de Revisión, que es 1 cuando se implementa por primera vez. En la columna Estado, se muestran los entornos en los que se implementa el proxy con un indicador de estado verde.
Debajo, en la sección Revisiones, se muestran todas las revisiones realizadas en este proxy. Cuando haces clic en uno de los elementos VIEW en la columna Endpoint summary, se muestra la sección Endpoint:
Extremos de proxy: La ruta base que configuraste para el proxy, que es este ejemplo, es /myproxy.
Extremos de destino: La ruta base que estableces para el destino, que en este ejemplo es https://mocktarget.apigee.net.
Apigee clásico
Para crear un proxy de API nuevo con la versión clásica de Apigee, sigue estos pasos:
Selecciona tu organización en el menú desplegable de la esquina superior izquierda.
Selecciona Desarrollar > Proxies de API en la vista principal.
Haz clic en Crear nuevo. Se iniciará el asistente de proxy de API.
Selecciona Proxy inverso (más común).
Se muestra la vista Detalles del proxy.
Configura tu proxy con los siguientes ajustes:
Nombre del proxy: Ingresa “myproxy”. En los pasos restantes de esta sección, se supone que este es el ID de tu proxy.
Ruta base del proxy: Se configurará de forma automática como "/myproxy". La ruta base del proxy es parte de la URL que se usa para realizar solicitudes a la API. Edge usa la URL para hacer coincidir solicitudes entrantes y enrutarlas al proxy de API adecuado.
(Opcional) Descripción: Ingresa una descripción para tu nuevo proxy de API, como "Prueba de Apigee Hybrid con un proxy simple".
Destino (API existente): Ingresa "https://mocktarget.apigee.net". Esto define la URL de destino que Apigee invoca en una solicitud al proxy de API. El servicio de destino ficticio se aloja en Apigee y muestra datos simples. No requiere una clave de API ni un token de acceso.
Los detalles de tu proxy de API deben tener el siguiente aspecto:
Haz clic en Siguiente.
En la pantalla Políticas comunes, selecciona Transferencia (sin autorización) como la opción de seguridad.
Haz clic en Siguiente.
En la pantalla Resumen, selecciona un entorno para implementar tu proxy y haz clic en Crear e implementar.
Hybrid genera el proxy (a veces denominado el paquete del proxy) y lo implementa en el entorno que seleccionaste.
Haz clic en Ir a la lista de proxy.
Apigee muestra la vista Proxies, en la que se muestra una lista de los proxies de API. El proxy nuevo debe aparecer con un indicador de estado verde, lo que significa que se implementó.
2. Llama al proxy de API
Cuando la IU indica que el proxy está implementado, puedes intentar llamarlo con cURL o el cliente REST que elijas.
Por ejemplo:
Busca la dirección IP externa y el puerto de la puerta de enlace de entrada de Apigee con el siguiente comando:
kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
Deberías obtener un resultado similar al siguiente:
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
Exporta tu IP externa y el puerto a las variables:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-18 (UTC)"],[],[],null,["# Step 2: Deploy an API proxy\n\nNow that you've installed and configured the Apigee hybrid\nruntime and ingress gateway, 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.15/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)."]]
