Esta página se aplica a Apigee y Apigee Hybrid.
Consulta la documentación de
Apigee Edge.
Qué vas a hacer en este paso
Sigue los pasos que se indican a continuación para crear e implementar un proxy de API de prueba. Por último, prueba el proxy de API enviándole una solicitud HTTP.
Crear y desplegar un proxy de APIs
El proceso de aprovisionamiento de Apigee no crea ni despliega automáticamente un proxy de API. Debes crear e implementar un proxy manualmente.
Interfaz de Apigee en la consola de Cloud
Para crear y desplegar tu primer proxy, sigue estos pasos:
En la Google Cloud consola, ve a la página Desarrollo de proxy > Proxies de API.
- Asegúrate de que el nombre de tu organización esté seleccionado en el selector de proyectos del panel Google Cloud. El nombre de la organización es el mismo que el nombre de tu proyecto. Google Cloud
- Haz clic en + Crear.
Se abrirá la página Crear un proxy.
- En el cuadro Plantilla de proxy, selecciona Proxy inverso (el más habitual).
- En Paso 1: Detalles del proxy, configura el proxy con los siguientes valores:
Nombre del parámetro Valor Nombre del proxy hello-world
Ruta base /hello-world
Destino (API actual) mocktarget.apigee.net
- Haz clic en Siguiente.
- En el paso 2: Implementar (opcional):
- Entornos de implementación: opcional. Utilice las casillas de verificación para seleccionar uno o varios entornos en los que implementar su proxy. 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.
- Cuenta de servicio: opcional. Asocia una cuenta de servicio a tu implementación para que tu proxy pueda acceder a los servicios, tal como se especifica en el rol y los permisos de la cuenta de servicio. Google Cloud
- Haz clic en Crear.
El nuevo proxy de API se crea y se implementa en el entorno seleccionado.
- Se abrirá la página Resumen del proxy del proxy que acabas de crear. Una marca de verificación verde en Estado indica que el proxy se ha implementado correctamente. Si el proxy no se ha implementado, consulta el artículo Implementar un proxy de API y sigue los pasos para implementarlo manualmente.
- En el panel de navegación de la izquierda, selecciona Gestión > Entornos > Grupos de entornos.
- Copia el nombre de host de tu grupo de entornos. Usarás este nombre de host para llamar al proxy de la API en los pasos siguientes.
Apigee Classic
Para crear y desplegar tu primer proxy, sigue estos pasos:
- Inicia sesión en la interfaz de usuario de Apigee.
- Asegúrate de que el nombre de tu organización esté seleccionado en el menú desplegable de la esquina superior izquierda de la interfaz de usuario. El nombre de la organización es el mismo que el nombre de tu proyecto de Google Cloud.
- En la vista principal, haz clic en Proxies de API.
- En la lista desplegable Select Environment (Seleccionar entorno), selecciona un entorno.
- Haz clic en Crear.
- Haz clic en Proxy inverso (la opción más habitual).
- En la página Detalles del proxy, configura el proxy con los siguientes valores:
Nombre del parámetro Valor Nombre hello-world
Ruta base /hello-world
Destino (API actual) https://mocktarget.apigee.net
- Haz clic en Siguiente.
- En la página Common policies (Políticas comunes), en Security: Authorization (Seguridad: autorización), selecciona Pass through (no authorization) (Transferencia directa [sin autorización]).
- Haz clic en Siguiente.
- En la página Resumen, en Implementación opcional, selecciona el entorno en el que quieras implementar el proxy.
- Haz clic en Crear y desplegar.
El nuevo proxy de API se crea y se despliega en el entorno seleccionado.
- Haz clic en Ir a la lista de proxies. Una marca de verificación verde en Estado indica que el proxy se ha implementado correctamente. Si el proxy no se ha implementado, consulta Implementar un proxy de API y sigue los pasos para implementarlo manualmente.
- En el panel de navegación de la izquierda, selecciona Administrar > Entornos > Grupos.
- Haz clic en Ver en la Google Cloud consola.
- Copia el nombre de host de tu grupo de entornos. Usarás este nombre de host para llamar al proxy de la API en los pasos siguientes.
- Cierra la Google Cloud consola
Llamar al proxy con acceso interno
Si has permitido el acceso interno en Paso 4: Personaliza el enrutamiento del acceso, sigue las instrucciones de: Llamar a un proxy de API con acceso solo para uso interno.
Llamar al proxy con acceso externo
Si has permitido el acceso externo en el paso 4: Personaliza el enrutamiento del acceso, sigue estos pasos:
- Configura una entrada DNS para tu host. Aquí tienes dos formas de hacerlo:
- En tu registrador, crea un registro A que dirija el nombre de host de tu grupo de entornos a la dirección IP que se muestra en la página del asistente, en Configurar DNS. Por ejemplo, si tu nombre de host es
sales.example.com
y la IP es 10.23.0.2, apunta el registro desales.example.com
a la dirección10.23.0.2
. - Usa Cloud DNS de Google para asignar una URL a una dirección IP.
- En tu registrador, crea un registro A que dirija el nombre de host de tu grupo de entornos a la dirección IP que se muestra en la página del asistente, en Configurar DNS. Por ejemplo, si tu nombre de host es
- Prueba el proxy de API enviando la siguiente solicitud en una ventana de terminal:
curl -v -H "Host:YOUR_ENV_GROUP_HOSTNAME" \ https://YOUR_INSTANCE_IP_OR_DNS/hello-world
Donde:
- El valor del encabezado
Host
(YOUR_ENV_GROUP_HOSTNAME) es el nombre de host de la página Entornos > Grupos de entornos.
Una solicitud correcta devuelve la cadena
Hello, Guest!
. Si tu solicitud no se ha completado correctamente, consulta la sección Solución de problemas. - El valor del encabezado
Pasos siguientes
- Haz un recorrido por los tutoriales de Apigee, incluidos los siguientes: