Sigue los pasos que se indican a continuación para crear y, luego, implementar un proxy de API de prueba. Por último, prueba el proxy de API mediante el envío de una solicitud HTTP.
Crea e implementa un proxy de API
Permisos necesarios para esta tarea
Para implementar y crear proxies se requiere un conjunto mínimo de permisos.
Si tienes el rol Apigee Org Admin, puedes completar esta tarea.
Para obtener información sobre otros roles que puedes emplear, consulta Roles de Apigee.
El proceso de aprovisionamiento de Apigee no crea ni implementa un proxy de API de forma automática. Debes crear y, luego, implementar un proxy de forma manual.
IU de Apigee en la consola de Cloud
Para crear e implementar tu primer proxy, haz lo siguiente:
Asegúrate de que el nombre de tu organización esté seleccionado en el menú desplegable en la esquina superior izquierda de la IU. El nombre de la organización es el mismo que el nombre de tu proyecto de Google Cloud.
En el panel de navegación izquierdo, haz clic en Desarrollo de proxy > Proxies de API.
Haz clic en + Crear.
Se abrirá la página Crear un proxy.
En el cuadro Plantilla de proxy, selecciona Proxy inverso (más común).
En el Paso 1: Detalles del proxy, configura tu proxy con los siguientes valores:
Nombre del parámetro
Valor
Nombre del proxy
hello-world
Ruta base
/hello-world
(API existente) de destino
mocktarget.apigee.net
Haz clic en Siguiente.
En el Paso 2: Implementa (opcional), haz lo siguiente:
Entornos de implementación: Opcional. Usa las casillas de verificación a fin de seleccionar uno o más entornos para implementar tu proxy.
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.
Cuenta de servicio: (opcional) Conecta una cuenta de servicio a tu implementación para permitir que tu proxy acceda a los servicios de Google Cloud, como se especifica en la función y los permisos de la cuenta de servicio.
Haz clic en Crear.
Tu proxy de API nuevo se crea y se implementa en el entorno seleccionado.
Se abrirá la página Resumen de proxy para el proxy que acabas de crear.
Una marca de verificación verde en Estado indica que el proxy se implementó de forma correcta. Si el proxy no está implementado, consulta Implementa un proxy de API y sigue los pasos para implementarlo de forma manual.
En el panel de navegación izquierdo, selecciona Administración > Entornos > Grupos de entornos.
Copia el nombre de host para tu grupo de entornos. Usarás este nombre de host para llamar al proxy de API en los pasos siguientes.
IU de Apigee
Para crear e implementar tu primer proxy, haz lo siguiente:
Asegúrate de que el nombre de tu organización esté seleccionado en el menú desplegable en la esquina superior izquierda de la IU. El nombre de la organización es el mismo que el nombre de tu proyecto de Google Cloud.
Haz clic en Proxies de API en la vista principal.
En la lista desplegable Seleccionar entorno, selecciona un entorno.
Haz clic en Crear nueva.
Haz clic en Proxy inverso (más común).
En la página Detalles del proxy, configura tu proxy con los siguientes valores:
Nombre del parámetro
Valor
Nombre
hello-world
Ruta base
/hello-world
(API existente) de destino
https://mocktarget.apigee.net
Haz clic en Siguiente.
En la página Políticas comunes, en Seguridad: autorización, selecciona Pasar (sin autorización).
Haz clic en Siguiente.
En la página Resumen, en Implementación opcional, selecciona el entorno en el que deseas implementar el proxy.
Haz clic en Crear e implementar (Create and deploy).
Tu proxy de API nuevo se crea y se implementa en el entorno seleccionado.
Haz clic en Ir a la lista de proxy. Una marca de verificación verde en Estado indica que el proxy se implementó de forma correcta. Si el proxy no está implementado, consulta Implementa un proxy de API y sigue los pasos para implementarlo de forma manual.
En el panel de navegación izquierdo, selecciona Administrador > Entornos > Grupos.
Haz clic en Ver en la consola de Google Cloud.
Copia el nombre de host para tu grupo de entornos. Usarás este nombre de host para llamar al proxy de API en los próximos pasos.
Configura una entrada de DNS para el host. Existen dos formas de realizar esta tarea:
En tu registrador, crea un registro A que dirija el nombre de host de tu grupo de entornos a la IP que se muestra en la página del asistente en Configura DNS. Por ejemplo, si el nombre de host es sales.example.com y la IP es 10.23.0.2, dirige el registro de sales.example.com a la dirección 10.23.0.2.
Usa Google Cloud DNS para asignar una URL a una dirección IP.
Para probar el proxy de API, envía la siguiente solicitud en una ventana de la terminal:
[[["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-09-04 (UTC)"],[[["\u003cp\u003eThis page provides instructions for creating and deploying a test API proxy in Apigee or Apigee hybrid environments, which can be done using either the Apigee UI in the Cloud console or the classic Apigee UI.\u003c/p\u003e\n"],["\u003cp\u003eCreating and deploying API proxies requires specific permissions, notably the Apigee Org Admin role, but alternative roles are detailed in the Apigee roles documentation.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves configuring a reverse proxy with a specified name, base path, and target API, then optionally deploying it to selected environments, with the created proxy being displayed in the Proxy Summary page.\u003c/p\u003e\n"],["\u003cp\u003eAfter deployment, you can test the API proxy by sending an HTTP request to it, either with internal or external access, by setting up a DNS entry and using the provided \u003ccode\u003ecurl\u003c/code\u003e command with the correct environment group hostname.\u003c/p\u003e\n"],["\u003cp\u003eThe page also suggests several next steps, such as taking a tour of Apigee tutorials for learning about guarding against traffic spikes and getting a detailed view of the request/response flow.\u003c/p\u003e\n"]]],[],null,["# Recommended next steps\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nWhat you're doing in this step\n------------------------------\n\n\nFollow the steps below to create and deploy a test API proxy. Finally,\ntest the API proxy by sending an HTTP request to it.\n\nCreate and deploy an API proxy\n------------------------------\n\n#### Permissions required for this task\n\n\nCreating and deploying proxies requires a minimum set of permissions.\nIf you have the Apigee Org Admin role, you can complete this task.\nTo learn about other roles you can employ, see\n[Apigee roles](/apigee/docs/api-platform/system-administration/apigee-roles).\n\nThe provisioning process for Apigee does not automatically create\nand deploy an API proxy for you. You must create and deploy a proxy manually. \n\n### Apigee UI in the Cloud console\n\nTo create and deploy your first proxy:\n\n1. In the Google Cloud console, go to the **Proxy development \\\u003e API proxies** page.\n\n [Go to API proxies](https://console.cloud.google.com/apigee/proxies)\n2. Be sure that your organization name is selected from the project picker in the **Google Cloud** pane. The organization name is the same as your Google Cloud project name.\n3. Click **+ Create** .\n\n The **Create a proxy** page opens.\n4. In the **Proxy template** box, select **Reverse proxy (most common)**.\n5. In **Step 1: Proxy details** , configure your proxy with the following values:\n\n6. Click **Next**.\n7. In **Step 2: Deploy (optional)** :\n - **Deployment environments** : Optional. Use the checkboxes to select one or more environments in which to deploy your proxy. If you prefer not to deploy the proxy at this point, leave the **Deployment environments** field empty. You can always deploy the proxy later.\n - **Service Account**: Optional. Attach a service account to your deployment to enable your proxy to access Google Cloud services, as specified in the service account's role and permissions.\n8. Click **Create** .\n\n Your new API proxy is created and deployed in the selected environment.\n | **Note:**The proxy is not fully deployed instantaneously. It can take up to a minute for the proxy to deploy.\n9. The **Proxy summary** page for your newly created proxy opens. A green check mark under **Status** indicates that the proxy was successfully deployed. If the proxy is not deployed, see [Deploying an API proxy](/apigee/docs/api-platform/deploy/ui-deploy-new) and follow the steps to deploy it manually.\n10. In the left navigation pane, select **Management \\\u003e Environments \\\u003e Environment Groups**.\n11. Copy the hostname for your environment group. You'll use this hostname to call the API proxy in the next steps.\n\n### Classic Apigee\n\nTo create and deploy your first proxy:\n\n1. Sign in to the [Apigee UI](https://apigee.google.com).\n2. Be sure that your organization name is selected from the drop-down menu in the upper left corner of the UI. The organization name is the same as your Google Cloud project name.\n3. Click **API Proxies** in the main view.\n4. From the **Select Environment** drop-down list, select an environment.\n5. Click **Create new**.\n6. Click **Reverse proxy (most common)**.\n7. In the **Proxy details** page, configure your proxy with the following values:\n\n8. Click **Next**.\n9. In the **Common policies** page, under **Security:\n Authorization** select **Pass through (no authorization)**.\n10. Click **Next**.\n11. On the **Summary** page, under **Optional Deployment**, select the environment in which to deploy the proxy.\n12. Click **Create and deploy** .\n\n Your new API proxy is created\n and deployed in the selected environment.\n | **Note:**The proxy is not fully deployed instantaneously. It can take up to a minute for the proxy to deploy.\n13. Click **Go to proxy list** . A green check mark under **Status** indicates that the proxy was successfully deployed. If the proxy is not deployed, see [Deploying an API proxy](/apigee/docs/api-platform/deploy/ui-deploy-new) and follow the steps to deploy it manually.\n14. In the left navigation pane, select **Admin \\\u003e Environments \\\u003e Groups**.\n15. Click **View in Google Cloud console**.\n16. Copy the hostname for your environment group. You'll use this hostname to call the API proxy in the next steps.\n17. Close the Google Cloud console.\n\nCall the proxy with internal access\n-----------------------------------\n\nIf you allowed *internal* access in\n[Step 4: Customize access routing](/apigee/docs/api-platform/get-started/configure-routing), follow the instructions in:\n[Calling an API proxy with internal-only access](/apigee/docs/api-platform/get-started/accessing-internal-proxies).\n\nCall the proxy with external access\n-----------------------------------\n\n\nIf you allowed *external* access in\n[Step 4: Customize access routing](/apigee/docs/api-platform/get-started/configure-routing), follow these steps:\n\n1. Set up a DNS entry for your host. Here are two ways to accomplish this task:\n - At your registrar, create an A record pointing your environment group hostname to the IP shown on the wizard page under **Configure DNS** . For example, if your hostname is `sales.example.com` and the IP is 10.23.0.2, then point the record for `sales.example.com` to the address `10.23.0.2`.\n - Use Google [Cloud DNS](/dns/docs) to map a URL to an IP address.\n 2. Test the API proxy by sending the following request in a terminal window: **Note:** DNS changes are published immediately, but may take time to propagate. Because of this delay, you may have to wait up to an hour before you can call the sample proxy. \n\n ```\n curl -v -H \"Host:YOUR_ENV_GROUP_HOSTNAME\" \\\n https://YOUR_INSTANCE_IP_OR_DNS/hello-world\n ```\n\n Where:\n - The value of the `Host` header (\u003cvar translate=\"no\"\u003eYOUR_ENV_GROUP_HOSTNAME\u003c/var\u003e) is the hostname from the **Environments \\\u003e Environment Groups** page.\n\n A successful request returns the string: `Hello, Guest!`.\n If your request is not successful, see [Troubleshooting](/apigee/docs/api-platform/get-started/troubleshooting-install).\n\nNext steps\n----------\n\n- [Take a tour](/apigee/docs/api-platform/get-started/tutorials) of the Apigee tutorials, including:\n - [Guarding against sudden\n traffic spikes](/apigee/docs/api-platform/tutorials/add-spike-arrest).\n - [Getting a detailed view of\n the request/response flow](/apigee/docs/api-platform/tutorials/view-with-trace)."]]
