Estás viendo la documentación de Apigee Edge.
Ve a la
documentación de Apigee X. info
Apigee Edge incluye varios paquetes de extensión instalados. Antes de poder usar una extensión en un proxy de API con una política de texto destacado de extensión, deberás agregarla y configurarla. Cuando agregas una extensión, buscas el paquete de extensión que representa el recurso externo que deseas integrar con tu proxy de API, agregas y configuras una extensión desde ese paquete, y la implementas en un entorno de Edge.
Cuando configuras una extensión desde un paquete de extensión, especificas valores que enfocan la interacción de la extensión con su recurso externo. Por ejemplo, cuando configuras una extensión de Google Cloud Firestore, especificas qué base de datos debe usar la extensión cuando crea, obtiene y borra documentos. Cada extensión tiene su propio conjunto de propiedades de configuración que corresponden a aspectos del recurso con el que interactúa. Para obtener una lista de las extensiones incluidas, consulta la descripción general de la referencia de extensiones.
Por lo general, la configuración de cada extensión incluye las credenciales que debe usar para autenticarse con el recurso en tu nombre.
El entorno de implementación de extensiones es elástico para admitir el ajuste de escala automático según la carga. Como resultado, de forma predeterminada, es posible que una implementación de extensión que no tenga tráfico no tenga una instancia disponible para responder las solicitudes. Por lo tanto, la primera solicitud a una extensión puede tardar más mientras el entorno crea una instancia de la extensión para usarla.
Para obtener un instructivo para comenzar, consulta Instructivo: Cómo agregar y usar una extensión.
Cómo agregar y configurar una extensión
Accede a Edge, haz clic en el menú Administrador y, luego, en Extensiones.
En la página Extensiones que aparece, se enumeran todas las extensiones que se configuraron a partir de los paquetes de extensiones disponibles en el sistema. Si quieres ver una extensión configurada existente, puedes filtrar la lista escribiendo términos de filtro en la parte superior de la página.
En los próximos pasos, agregarás tu propia extensión.
En la página Extension, haz clic en Agregar extensión.
En la página Selecciona una extensión que aparece, se dividen las extensiones entre las que desarrolló Google y las que desarrollaron otras empresas.
En Seleccionar una extensión, haz clic en la pestaña que quieras y, luego, busca la extensión correspondiente al recurso externo al que accedes.
En el cuadro del paquete de la extensión, puedes hacer clic en Ver detalles para ver información sobre la versión, el autor, etcétera.
Haz clic en la casilla del paquete de extensión para comenzar a configurar una extensión desde el paquete.
En el cuadro de diálogo Extension Properties, ingresa un nombre y una descripción para la extensión y, luego, haz clic en Create.
En la página Extension > My-Extension-Name de la extensión que estás creando, busca un entorno de Apigee Edge para el que deseas configurar la extensión.
Una extensión se debe implementar en el mismo entorno que el proxy de API que la usará.
Haz clic en la fila del entorno en la lista.
En el diálogo Configuración, selecciona o ingresa valores para configurar esta extensión.
Cada extensión tiene sus propias propiedades de configuración. Para obtener descripciones de las propiedades, usa la referencia de la extensión. Las referencias de extensiones se enumeran en la descripción general de las referencias de extensiones.
Haz clic en Guardar.
Implementa una extensión
- En la página Extension > My-Extension-Name de la extensión, haz clic en Implementar para implementar la extensión y usarla desde un proxy de API.
Después de implementar una extensión, haz lo siguiente:
Agrega la extensión a un proxy de API con la política Extension Callout.
Puedes ver los datos de registro que genera la extensión. Para obtener más información, consulta Cómo ver los registros de extensiones.