Riferimento per la configurazione del bundle di flussi condivisi

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Un flusso condiviso è una funzionalità riutilizzabile simile a un proxy API. Se hai già familiarità con i proxy API, gran parte dei contenuti di questo riferimento ti risulterà familiare.

Se stai imparando a creare flussi condivisi, inizia con l'argomento Flussi condivisi riutilizzabili.

Struttura del bundle di flussi condivisi

Un bundle di flussi condivisi è costituito dalla seguente configurazione:

I componenti nella tabella sopra sono definiti dai file di configurazione nella seguente struttura di directory:

File di configurazione e struttura di directory di un bundle di flussi condivisi

Questa sezione spiega i file di configurazione e la struttura di directory di un bundle di flussi condivisi.

• Configurazione di base
• Norme
• Flussi condivisi
• Risorse

Configurazione di base

Il file di configurazione di base si trova nella directory principale del bundle. Il nome è il nome del bundle.

/sharedflowbundle/traffic-management-shared.xml

La configurazione di base definisce i contenuti del bundle di flussi condivisi, insieme alle informazioni per il monitoraggio della cronologia delle revisioni del bundle.

<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>

Attributi della configurazione di base

Elementi della configurazione di base

Flussi condivisi

/sharedflowbundle/sharedflows/default.xml

La configurazione SharedFlow definisce la sequenza in cui devono essere eseguiti gli elementi del flusso. Gli elementi secondari <Step> dell'elemento <SharedFlow> specificano ciascuno una parte della sequenza, ad esempio una chiamata a una norma.

La seguente configurazione SharedFlow specifica tre norme da eseguire in una sequenza dall'alto verso il basso (da sinistra a destra nella console di gestione), con la norma Spike Arrest per prima e una norma Flow Callout per ultima.

<SharedFlow name="default">
    <Step>
        <Name>Spike-Arrest</Name>
    </Step>
    <Step>
        <Name>Extract-Token</Name>
    </Step>
    <Step>
        <Name>Auth-Flow-Callout</Name>
    </Step>
</SharedFlow>

Attributi di configurazione del flusso condiviso

Elementi di configurazione del flusso condiviso

Norme

/sharedflowbundle/policies

Come in un proxy API, in un bundle di flussi condivisi la directory /policies contiene la configurazione XML di tutte le norme che possono essere collegate al flusso condiviso nel bundle. Le norme condividono un sottoinsieme di elementi, anche se questo sottoinsieme viene aumentato con elementi che sono specifici della norma. Per saperne di più su come configurare una norma, consulta l'argomento relativo alla norma che ti interessa. Puoi anche raggiungerli dalla panoramica dei riferimenti alle norme.

Risorse

/sharedflowbundle/resources

Le risorse sono script, codice e trasformazioni XSL che possono essere collegate ai flussi condivisi utilizzando le norme. Questi vengono visualizzati nella sezione Script dell'editor di flussi condivisi nella UI di gestione.

Consulta File di risorse per i tipi di risorse supportati.

Pubblica le tue domande nel forum degli sviluppatori di Apigee.