Esta página se aplica a Apigee y Apigee Hybrid.
Consulta la documentación de Apigee Edge.
Un flujo compartido es una funcionalidad reutilizable similar a un proxy de API. Para obtener más información, consulta Crea flujos compartidos reutilizables.
Estructura del directorio del paquete de flujo compartido
La estructura del directorio del paquete de flujo compartido, que se muestra a continuación, es similar a la estructura del directorio de configuración del proxy de API.
La configuración de un paquete de flujo compartido consta en los siguientes contenidos:
Configuración básica | Configuración principal. |
Políticas | Archivos de configuración con formato XML que cumplen con los esquemas de políticas de Apigee. |
Recursos | Secuencias de comandos, archivos JAR y archivos XSLT a los que hacen referencia las políticas para ejecutar la lógica personalizada. |
Flujos compartidos | Flujos compartidos incluidos en este paquete. |
Configuración básica
El archivo de configuración básica se encuentra en el directorio raíz del paquete. Su nombre es el nombre del paquete.
/sharedflowbundle/traffic-management-shared.xml
La configuración básica define el contenido del paquete de flujo compartido, junto con la información sobre el seguimiento del historial de revisiones del paquete.
<SharedFlowBundle revision="2" name="traffic-management-shared"> <ConfigurationVersion majorVersion="4" minorVersion="0"/> <CreatedAt>1478637529218</CreatedAt> <CreatedBy>gladys@example.com</CreatedBy> <Description>Shared flow to moderate API traffic</Description> <DisplayName>traffic-management-shared</DisplayName> <LastModifiedAt>1481573374023</LastModifiedAt> <LastModifiedBy>gladys@example.com</LastModifiedBy> <Policies> <Policy>Auth-Flow-Callout</Policy> <Policy>Extract-Token</Policy> <Policy>Spike-Arrest</Policy> </Policies> <Resources> <Resource>jsc://extract-token.js</Resource> </Resources> <SharedFlows> <SharedFlow>default</SharedFlow> </SharedFlows> </SharedFlowBundle>
Atributos de configuración base
Name | Descripción | Predeterminada | ¿Es obligatorio? |
---|---|---|---|
SharedFlowBundle |
|||
name |
Nombre del paquete de flujo compartido, que debe ser único dentro de la organización. En los caracteres válidos, se incluyen los siguientes: A-Za-z0-9_- |
N/A | Sí |
revision |
Es el número de revisión de la configuración del paquete de flujo compartido. No es necesario que configures de forma explícita el número de revisión, ya que Apigee realiza un seguimiento automático de la revisión actual del flujo compartido. | N/A | No |
Elementos de la configuración base
Nombre | Descripción | Predeterminada | ¿Es obligatorio? |
---|---|---|---|
SharedFlowBundle |
|||
ConfigurationVersion |
Es la versión del esquema de configuración del paquete de flujo compartido con el que cumple este flujo compartido. En este momento, el único valor admitido es majorVersion 4 y minorVersion 0 . Esta configuración se puede usar en el futuro para habilitar la evolución del formato del paquete de flujo compartido. |
4.0 | No |
CreatedAt y CreatedBy |
Es la fecha y hora (en época) que se creó el paquete de flujo compartido y el correo electrónico del usuario que lo creó. | ||
Description |
Descripción textual del flujo compartido. Si se proporciona, la descripción se mostrará en la IU de Apigee. | N/A | No |
DisplayName |
Es un nombre fácil de usar que puede ser diferente del atributo name de la configuración de flujo compartido. |
N/A | No |
LastModifiedAt y LastModifiedBy |
Fecha y hora (en época) en que el paquete de flujo compartido se modificó por última vez, junto con el correo electrónico del usuario que lo modificó. | ||
Policies |
Es una lista de políticas en el directorio /policies de este flujo compartido. Por lo general, solo verás este elemento cuando se cree el flujo compartido mediante la IU de administración de Edge. Solo se trata de una configuración de “manifiesto”, diseñada para proporcionar visibilidad del contenido del flujo compartido. |
N/A | No |
Resources |
Es una lista de recursos (JavaScript, Python, Java, XSLT) en el directorio /resources de este flujo compartido. Por lo general, solo verás este elemento cuando se creó el flujo compartido mediante la IU de Apigee. Solo se trata de una configuración de manifiesto, diseñada para proporcionar visibilidad del contenido del flujo compartido. |
N/A | No |
SharedFlows |
Flujo compartido que contiene este paquete. | N/A | Sí |
Políticas
/sharedflowbundle/policies
Al igual que en un proxy de API, en el paquete de flujo compartido, el directorio de /policies
contiene XML de configuración para todas las políticas disponibles que se pueden adjuntar al flujo compartido en el paquete.
Las políticas comparten un subconjunto de elementos, aunque este subconjunto se aumenta con los elementos específicos de la política. Si deseas obtener más información para configurar una política, consulta Descripción general de la referencia de políticas.
Recursos
/sharedflowbundle/resources
Los recursos son secuencias de comandos, códigos y transformaciones XSL que se pueden adjuntar a flujos compartidos con políticas. Estos aparecen en la sección de secuencias de comandos del editor de flujo compartido en la IU de administración.
Consulta Administra recursos para conocer los tipos de recursos compatibles.
Flujos compartidos
/sharedflowbundle/sharedflows/default.xml
La configuración de SharedFlow define la secuencia en la que se deben ejecutar los elementos del flujo.
Los elementos secundarios <Step>
del elemento <SharedFlow>
especifican cada parte de la secuencia, como una llamada a una política.
La siguiente configuración de SharedFlow especifica tres políticas que se ejecutarán en una secuencia de arriba abajo (de izquierda a derecha en la consola de administración), con la Política de SpikeArrest primero y una Política de FlowCallout al final.
<SharedFlow name="default"> <Step> <Name>Spike-Arrest</Name> </Step> <Step> <Name>Extract-Token</Name> </Step> <Step> <Name>Auth-Flow-Callout</Name> </Step> </SharedFlow>
Atributos de configuración de flujo compartido
Name | Descripción | Predeterminada | ¿Es obligatorio? |
---|---|---|---|
SharedFlow |
|||
name |
Es el nombre del flujo compartido, que debe ser único dentro de la organización. Entre los caracteres válidos, se incluyen los siguientes: A-Za-z0-9_- |
N/A | Sí |
revision |
Es el número de revisión de la configuración de flujo compartido. No es necesario que configures de forma explícita el número de revisión, ya que Apigee realiza un seguimiento automático de la revisión actual del flujo compartido. | N/A | No |
Elementos de configuración de flujo compartido
Name | Descripción | Predeterminada | ¿Es obligatorio? |
---|---|---|---|
SharedFlow |
Secuencia de políticas en el flujo compartido. | N/A | Sí |
Step |
Etapa en la secuencia del flujo. | N/A | Sí |
Name |
Nombre del elemento al que se hace referencia en el paso. El valor de este elemento debe ser el mismo que el identificador único del elemento, como el valor del atributo de nombre de la política. | N/A | Sí |