Ahora que has configurado Google Cloud y la interfaz de usuario híbrida, y has instalado y configurado el tiempo de ejecución, puedes ver cómo funciona todo junto.
En esta sección se explica lo siguiente:
Crea un proxy de APIs en la interfaz de usuario de Apigee con el
Asistente para proxies de APIs.
Selecciona Desarrollar > Proxies de API en la vista principal.
En la lista desplegable Entorno, selecciona el entorno en el que quieras crear un proxy de API. En esta sección se da por supuesto que el nombre del entorno es "test". Has creado al menos un entorno en el paso 5: Añade un entorno.
La interfaz de usuario híbrida muestra una lista de proxies de API de ese entorno. Si aún no has creado ningún proxy, la lista estará vacía.
En la parte superior derecha, haz clic en +Proxy. Se inicia el asistente de proxy de API.
Seleccione Proxy inverso (la opción más habitual) y haga clic en Siguiente.
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. Edge 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, selecciona Transferencia (sin autorización) como opción de seguridad.
Haz clic en Siguiente.
En la pantalla Resumen, haz clic en Crear.
Hybrid genera el proxy (a veces denominado paquete de proxy):
Haz clic en Ir a la lista de proxies.
Híbrido muestra la vista Proxies (Proxies), que muestra una lista de proxies de API. El
nuevo proxy debería estar en la parte superior de la lista, con un indicador de estado gris, lo que significa que aún no se ha implementado.
2. Desplegar el proxy en el clúster mediante la interfaz de usuario híbrida
Después de crear un proxy, debes implementarlo para poder probarlo. En esta sección se describe cómo implementar el nuevo proxy mediante la interfaz de usuario híbrida.
Para desplegar un proxy de API en la interfaz de usuario híbrida, sigue estos pasos:
En la interfaz de usuario híbrida, selecciona Desarrollar > Proxies de API.
Asegúrate de que esté seleccionado el entorno de prueba.
La interfaz de usuario muestra el nuevo proxy en la lista de proxies:
Haz clic en el proxy "myproxy".
En la interfaz de usuario se muestra la pestaña Información general de los proxies de API de ese proxy.
En Implementaciones, la columna Revisión muestra el valor "No implementado".
En la columna Revisión, despliega el selector para elegir la revisión que quieras implementar.
En la lista desplegable solo se muestran las opciones "1" y "Undeploy".
En la lista desplegable, selecciona "1", la revisión que quieras implementar.
La interfaz de usuario te pedirá que confirmes la implementación:
Haz clic en Desplegar.
La interfaz de usuario inicia el proceso de implementación de la revisión 1 de tu nuevo proxy en el clúster.
Ten en cuenta que la implementación no es un proceso instantáneo. El modelo de implementación "eventualmente coherente" de Hybrid significa que una nueva implementación se lanzará en el clúster durante un breve periodo y no inmediatamente.
Aunque hay varias formas de comprobar el estado de implementación de un proxy en la interfaz de usuario, en los dos pasos siguientes se explica cómo llamar al proxy de API que acabas de implementar y cómo comprobar el estado de implementación con una llamada a las APIs de Apigee.
3. Llamar al proxy de API
Sigue los pasos que se indican a continuación, en función de si puedes o no actualizar el registro DNS del nombre de host que has usado para crear el grupo de entornos.
Si no puedes actualizar el DNS de tu nombre de host
Sigue estos pasos si el nombre de host de tu grupo de entornos no está registrado o no puedes actualizar su registro DNS. En estos pasos, obtienes la IP de entrada y la usas directamente en una llamada cURL
con la marca --resolve:
Exporta la IP de entrada:
export INGRESS_IP=$(kubectl -n istio-system get service \
istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
Exporta el número de puerto de entrada seguro:
export SECURE_INGRESS_PORT=$(kubectl -n istio-system get \
service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name=="https")].port}')
Sigue estos pasos si el nombre de host que has usado al crear el grupo de entornos está registrado y puedes actualizar su registro DNS para que apunte a la IP de entrada externa:
Exporta la IP externa del recurso Ingress a una variable:
export INGRESS_IP=$(kubectl -n istio-system get service \
istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
Comprueba que la variable contenga la dirección IP. Por ejemplo:
echo $INGRESS_IP
34.118.196.202
Usa esta dirección IP para actualizar tu registro DNS (normalmente, un registro A o CNAME) en tu registrador o proveedor de DNS. Es posible que tengas que esperar hasta una hora para que se propague el cambio en el registro DNS.
[[["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-09-04 (UTC)."],[[["\u003cp\u003eThis guide explains how to create a new API proxy in the Apigee hybrid UI using the API Proxy Wizard, including setting the proxy name, base path, and target.\u003c/p\u003e\n"],["\u003cp\u003eAfter creating the proxy, it details the steps to deploy the newly created proxy to the cluster via the hybrid UI, noting that deployment is not instantaneous.\u003c/p\u003e\n"],["\u003cp\u003eThe document provides instructions on how to call the API proxy after deployment, with separate methods for those who can and cannot update their DNS records.\u003c/p\u003e\n"],["\u003cp\u003eThe guide assumes the use of version 1.7 of the documentation, which is end-of-life and recommends upgrading to a newer supported version.\u003c/p\u003e\n"]]],[],null,["# Create and deploy a new API proxy\n\n| You are currently viewing version 1.7 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 hybrid UI, and installed and configured the\nruntime, you're ready to see how it all works together.\n\nThis section walks you through the following:\n\n1. **[Create a new API proxy](#create-proxy)** in the Apigee UI using the API Proxy Wizard\n2. **[Deploy your new proxy](#deploy)** to your cluster with the UI\n\n1. Create a new API proxy using the hybrid UI\n---------------------------------------------\n\nThis section describes how to create a new API proxy in the UI by using the API Proxy Wizard.\n\n**To create a simple API proxy using the API Proxy Wizard:**\n\n1. Open [Apigee UI](https://apigee.google.com) in a browser.\n2. Select **Develop \\\u003e API Proxies** in the main view.\n3. From the **Environment** drop-down list, select the environment in which you want to create a new API proxy. This section assumes the name of the environment is \"test\". You created at least one environment in [Step 5: Add an environment](/apigee/docs/hybrid/v1.7/precog-add-environment).\n\n The hybrid UI displays a list of API proxies for that environment. If you haven't created any\n proxies yet, the list is empty.\n4. Click **+Proxy** in the upper right. The API Proxy Wizard starts.\n5. Select **Reverse proxy** (most common), and click **Next** .\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, click **Create** .\n\n Hybrid generates the proxy (sometimes referred to as *the proxy bundle*):\n\n | **NOTE:** In this case, the hybrid UI does *not* deploy the proxy to your cluster. You will do this in [the next step](#deploy).\n11. Click **Go to proxy list** .\n\n Hybrid displays the **Proxies** view, which displays a list of API proxies. The\n new proxy should be at the top of the list, with a gray status indicator, meaning that it has\n not yet been deployed.\n\n2. Deploy your proxy to the cluster using the hybrid UI\n-------------------------------------------------------\n\nAfter creating a new proxy, you must deploy it so that you can try it out. This section\ndescribes how to deploy your new proxy using the hybrid UI.\n\n**To deploy an API proxy in the hybrid UI:**\n\n1. In the hybrid UI, select **Develop \\\u003e API Proxies** .\n\n Be sure the \"test\" environment is selected.\n\n The UI displays your new proxy in the proxies list:\n\n2. Click on the \"myproxy\" proxy.\n\n The UI displays the **API Proxies Overview** tab for that proxy.\n\n Notice that under **Deployments** , the **Revision** column shows\n \"Not deployed\".\n3. In the **Revision** column, expand the drop-down selector to choose the revision to deploy.\n\n The drop down list displays only \"1\" and \"Undeploy\".\n4. Select \"1\"---the revision that you want to deploy---from the drop down list.\n\n The UI prompts you to confirm the deployment:\n\n5. Click **Deploy** .\n\n The UI begins the process of deploying revision 1 of your new proxy to the cluster.\n\n Note that deployment is not an instantaneous process. Hybrid's \"eventually consistent\"\n deployment model means that a new deployment will be rolled out to the cluster over a short\n period of time and not immediately.\n\nWhile there are [several ways](/apigee/docs/api-platform/deploy/ui-deploy-overview#viewing-deployment-status) to check the\ndeployment status of a proxy in the UI, the next two steps explain how to call the API proxy\nyou just deployed and how\nto check the deployment status with a call to the [Apigee APIs](/apigee/docs/reference/apis/apigee/rest).\n\n3. Call the API proxy\n---------------------\n\n\nFollow the steps below, depending on whether or not you can update the DNS record of the hostname you\nused to create the [environment group](/apigee/docs/hybrid/v1.7/precog-add-environment).\n\n### If you are unable to update your hostname's DNS\n\n\nFollow these steps if your [environment group](/apigee/docs/hybrid/v1.7/precog-add-environment) hostname is not registered, or you are not able\nto update its DNS record. In these steps, you get the ingress IP and use it directly in a cURL call\nwith the `--resolve` flag:\n\n1. Export the ingress IP: \n\n ```\n export INGRESS_IP=$(kubectl -n istio-system get service \\\n istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')\n ```\n2. Export the secure ingress port number: \n\n ```\n export SECURE_INGRESS_PORT=$(kubectl -n istio-system get \\\n service istio-ingressgateway -o jsonpath='{.spec.ports[?(@.name==\"https\")].port}')\n ```\n3. Export your [environment group](/apigee/docs/hybrid/v1.7/precog-add-environment)'s host alias to a variable: \n\n ```\n export HOSTALIAS=your_host_alias\n ```\n4. Call the API proxy. The `--resolve` flag on cURL allows you to directly specify the ingress IP: \n\n ```\n curl -H Host:$HOSTALIAS --resolve \\\n $HOSTALIAS:$SECURE_INGRESS_PORT:$INGRESS_IP \\\n https://$HOSTALIAS:$SECURE_INGRESS_PORT/myproxy -k\n ```\n\n### If you are able to update your hostname's DNS\n\n\nFollow these steps if the hostname you used when you created the [environment group](/apigee/docs/hybrid/v1.7/precog-add-environment) is registered\nand you can update its DNS record to point to the external ingress IP:\n\n1. Export the external IP of the ingress to a variable: \n\n ```\n export INGRESS_IP=$(kubectl -n istio-system get service \\\n istio-ingressgateway -o jsonpath='{.status.loadBalancer.ingress[0].ip}')\n ```\n2. Check that the variable holds the IP address. For example: \n\n ```\n echo $INGRESS_IP\n 34.118.196.202\n ```\n3. Use this IP address to update your DNS record (usually an A or CNAME record) at your registrar or DNS provider. You may have to wait up to an hour for the DNS record change to propagate.\n4. Export your [environment group](/apigee/docs/hybrid/v1.7/precog-add-environment)'s host alias to a variable: \n\n ```\n export HOSTALIAS=your_host_alias\n ```\n5. Call the API proxy: \n\n ```\n curl -k https://$HOSTALIAS/myproxy\n ```\n\n\n For example: \n\n ```\n curl -v -k https://apitest.acme.com/myproxy\n ```\n\n If the call succeeds, you will see the following output: \n\n ```text\n Hello, Guest!\n ```\n\n*[Google Cloud]: Google Cloud"]]
