Ahora que has configurado Google Cloud y la interfaz de usuario de Apigee, y has instalado y configurado el tiempo de ejecución, puedes ver cómo funciona todo en conjunto.
1. Crear un proxy de API con la interfaz de usuario de Apigee
En esta sección se describe cómo crear un proxy de API en la interfaz de usuario con el asistente de proxy de API.
Apigee en la consola de Cloud
Para crear un proxy de API con Apigee en la consola de Cloud, sigue estos pasos:
Selecciona tu organización en el menú desplegable de la esquina superior izquierda.
En la vista principal, selecciona Desarrollo de proxies > Proxies de API.
Haz clic en Crear.Se iniciará el asistente para proxies de API.
Selecciona Proxy inverso (la opción más habitual).
Se muestra la vista Detalles del proxy.
Configura tu proxy con los siguientes ajustes:
Nombre del proxy: introduce myproxy. En los pasos restantes de esta sección se da por hecho que este es el ID de tu proxy.
Ruta base: se define automáticamente como / seguido del nombre del proxy, que en este ejemplo es /myproxy. La ruta base forma parte de la URL que se usa para enviar solicitudes a tu API. Apigee usa la URL para hacer coincidir y enrutar las solicitudes entrantes al proxy de API adecuado.
(Opcional) Descripción: escribe una descripción para tu nuevo proxy de API, como "Prueba de Apigee hybrid con un proxy sencillo".
Destino (API actual): introduce "https://mocktarget.apigee.net". Define la URL de destino que invoca Apigee en una solicitud al proxy de API. El servicio mocktarget está alojado en Apigee y devuelve datos sencillos. No requiere ninguna clave de API ni token de acceso.
Los detalles de tu proxy de API deberían ser similares a los siguientes:
Haz clic en Siguiente.
En Desplegar (opcional), puede seleccionar uno o varios
entornos
en los que desplegar su proxy en el campo Entornos de despliegue.
Si prefieres no implementar el proxy en este momento, deja el campo Entornos de implementación vacío. Puedes implementar el proxy más adelante.
Haz clic en Crear.
Apigee genera el proxy (a veces denominado paquete de proxy).
Apigee muestra la vista Resumen del proxy.
Si has elegido implementar el proxy, en la sección Implementaciones se muestra el número de Revisión, que es 1 cuando lo implementas por primera vez. En la columna Estado se muestran los entornos en los que se ha implementado el proxy con un indicador de estado verde.
Debajo, en la sección Revisiones, se muestran todas las revisiones que se han hecho en este proxy. Si haces clic en uno de los elementos de VER de la columna Resumen de endpoint, se mostrará la sección Endpoint, que incluye lo siguiente:
Puntos finales de proxy: la ruta base que has definido para el proxy, que en este ejemplo es /myproxy.
Endpoints de destino: la ruta base que has definido para el destino, que en este ejemplo es https://mocktarget.apigee.net.
Apigee Classic
Para crear un proxy de APIs con Apigee Classic, 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 para proxies de API.
Selecciona Proxy inverso (la opción más habitual).
Se muestra la vista Detalles del proxy.
Configura tu proxy con los siguientes ajustes:
Nombre del proxy: escriba "myproxy". En los pasos restantes de esta sección se da por supuesto que este es el ID de tu proxy.
Ruta base del proxy: se define automáticamente como "/myproxy". La ruta base del proxy forma parte de la URL que se usa para enviar solicitudes a tu API. Apigee usa la URL para hacer coincidir y enrutar las solicitudes entrantes al proxy de API adecuado.
(Opcional) Descripción: escribe una descripción para tu nuevo proxy de API, como "Prueba de Apigee hybrid con un proxy sencillo".
Destino (API actual): introduce "https://mocktarget.apigee.net". Define la URL de destino que invoca Apigee en una solicitud al proxy de API. El servicio mocktarget está alojado en Apigee y devuelve datos sencillos. No requiere ninguna clave de API ni token de acceso.
Los detalles de tu proxy de API deberían ser similares a los siguientes:
Haz clic en Siguiente.
En la pantalla Políticas comunes, selecciona Transferencia (sin autorización) como opción de seguridad.
Haz clic en Siguiente.
En la pantalla Resumen, selecciona un entorno en el que implementar tu proxy y haz clic en Crear e implementar.
Hybrid genera el proxy (a veces denominado paquete de proxy) y lo implementa en el entorno que hayas seleccionado.
Haz clic en Ir a la lista de proxies.
Apigee muestra la vista Proxies, que contiene una lista de proxies de APIs. El nuevo proxy debería mostrarse con un indicador de estado verde, lo que significa que se ha implementado.
2. Llamar al proxy de API
Cuando la interfaz de usuario indique que tu proxy se ha desplegado, puedes probar a llamarlo con cURL o con el cliente REST que elijas.
Por ejemplo:
Busca la dirección IP externa y el puerto de la pasarela de entrada de Apigee con el siguiente comando:
kubectl get svc -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
La salida debería tener un aspecto similar a este:
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
[[["Es fácil de entender","easyToUnderstand","thumb-up"],["Me ofreció una solución al problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Es difícil de entender","hardToUnderstand","thumb-down"],["La información o el código de muestra no son correctos","incorrectInformationOrSampleCode","thumb-down"],["Me faltan las muestras o la información que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-21 (UTC)."],[[["\u003cp\u003eThis content guides users through creating a new API proxy in either the Apigee in Cloud console or the classic Apigee UI, utilizing the API Proxy Wizard.\u003c/p\u003e\n"],["\u003cp\u003eThe created API proxy, named "myproxy," is configured with a base path and a target URL (https://mocktarget.apigee.net), and can be optionally deployed to specific environments.\u003c/p\u003e\n"],["\u003cp\u003eOnce deployed, the API proxy can be called using tools like cURL, and successful calls will return an HTTP 200 response code along with a "Hello, Guest!" message.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves setting up environment variables, finding the external IP and port of the Apigee ingress gateway, and then using those values to formulate a cURL command to test the proxy.\u003c/p\u003e\n"],["\u003cp\u003eThe document indicates that this is the successful completion of the Apigee Hybrid set up, and then provides links to learn more about API Proxies.\u003c/p\u003e\n"]]],[],null,["# Step 2: Deploy an API proxy\n\n| You are currently viewing version 1.13 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 the Cloud console\n\nTo create a new API proxy using Apigee in the 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.13/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"]]
