Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
Puedes usar extensiones para integrar recursos externos en tus proxies de API. Por ejemplo, podrías integrar servicios de Google Cloud Platform, como Google Cloud Storage. Durante el tiempo de ejecución, un proxy de API usa la extensión para intercambiar solicitudes y respuestas con el recurso externo.
Framework de tiempo de ejecución de extensiones
Durante el tiempo de ejecución, una extensión actúa como intermediario y procesa las solicitudes y respuestas entre un proxy de API y un recurso externo.
A continuación, se incluye una descripción general de cómo funciona el procesamiento a través de una extensión en el tiempo de ejecución.
- Una solicitud del cliente llega a un proxy de API y su flujo de solicitud se realiza a través de las políticas del proxy.
- El flujo de solicitud llega a una política de texto destacado de extensión en el proxy que está configurado para pasar datos a una extensión implementada en el entorno. Los datos incluyen valores que se necesitarán para enviar una solicitud al recurso externo que representa la extensión.
- La extensión envía una solicitud al recurso externo y, luego, recibe una respuesta.
- La extensión pasa su respuesta a la política Extension Callout, donde se controla con el código de proxy.
- El flujo de solicitudes continúa a través del proxy hasta que muestra una respuesta al cliente.
Cómo trabajar con extensiones
Cada extensión se desarrolla y configura teniendo en cuenta un recurso externo en particular. Para usar una extensión, un administrador de Apigee Edge y un desarrollador de proxy de API deben seguir estos pasos de alto nivel:
- Un administrador de la organización de Apigee Edge configura y, luego, implementa la extensión. La configuran con valores específicos para las necesidades de la empresa. Esta configuración crea una instancia de extensión enfocada para que la use el desarrollador del proxy de API. Por ejemplo, pueden configurar una extensión para acceder a un bucket en particular en Google Cloud Storage, incluidas las credenciales de autenticación necesarias.
- Un desarrollador de proxy de la API usa una extensión configurada en un proxy de API. Para ello, agrega una política de texto destacado de extensión al proxy. La configuración de la política especifica lo siguiente:
- qué extensión configurada usar.
- las acciones de la extensión (considera estas como llamadas a función a la extensión) que se invocarán.
- los parámetros de acción que se pasarán con la llamada a la acción Durante el tiempo de ejecución, la política usa la extensión para acceder al recurso externo como parte del flujo del proxy.
Documentación sobre las extensiones
En los siguientes temas, se proporciona más información sobre las extensiones:
- Para obtener una introducción práctica a las extensiones, consulta el Instructivo: Cómo agregar y usar una extensión.
- Para obtener referencias sobre las extensiones incluidas con Apigee Edge, consulta la descripción general de la referencia de extensiones.
- Para obtener referencias sobre la API de administración que puedes usar para agregar, quitar e implementar extensiones, consulta API de Extensions.