Konfigurationsreferenz für gemeinsam genutzte Ablauf-Bundles

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation.
Weitere Informationen

Ein freigegebener Ablauf ist eine wiederverwendbare Funktion, die einem API-Proxy ähnelt. Ein Großteil des Inhalts dieser Referenz ist bekannt, wenn Sie bereits mit API-Proxys vertraut sind.

Wenn Sie wissen möchten, wie ein freigegebener Ablauf erstellt wird, beginnen Sie mit dem Thema Neu verwendbare, freigegebene Abläufe.

Struktur des freigegebenen Ablauf-Sets

Ein freigegebenes Ablauf-Set besteht aus der folgenden Konfiguration:

Basiskonfiguration Primäre Konfigurationseinstellungen. Siehe Basiskonfiguration.
Richtlinien XML-formatierte Konfigurationsdateien, die den Apigee Edge-Richtlinienschemas entsprechen. Siehe Richtlinien.
Ressourcen Skripts, JAR-Dateien und XP-Dateien, auf die von Richtlinien verwiesen wird, um benutzerdefinierte Logik auszuführen Ressourcen ansehen.
SharedFlows Gemeinsame Abläufe in diesem Set. Siehe Freigegebene Abläufe.

Die Komponenten in der obigen Tabelle werden durch Konfigurationsdateien in der folgenden Verzeichnisstruktur definiert:

Konfigurationsdateien und Verzeichnisstruktur eines freigegebenen Ablauf-Sets

In diesem Abschnitt werden die Konfigurationsdateien und die Verzeichnisstruktur eines freigegebenen Ablauf-Sets erläutert.

Basiskonfiguration

Die Basiskonfigurationsdatei befindet sich im Stammverzeichnis des Sets. Der Name ist der Name des Sets.

/sharedflowbundle/traffic-management-shared.xml

Die Basiskonfiguration definiert den Inhalt des freigegebenen Ablauf-Sets sowie Informationen zum Verfolgen des Überarbeitungsverlaufs des Sets.

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

Attribute der Basiskonfiguration

Name Beschreibung Standard erforderlich?
SharedFlowBundle
name Der Name des freigegebenen Ablauf-Sets, das innerhalb einer Organisation eindeutig sein muss. Die Zeichen, die Sie im Namen verwenden dürfen, sind auf folgende Zeichen beschränkt: A-Za-z0-9_- Ja
revision Die Versionsnummer der Konfiguration des freigegebenen Ablauf-Bundles. Sie müssen nicht die Überarbeitungsnummer explizit festzulegen, da Apigee Edge Überarbeitung des gemeinsamen Ablaufs. Nein

Basiskonfigurationselemente

Name Beschreibung Standard erforderlich?
SharedFlowBundle
ConfigurationVersion Die Version des Konfigurationsschemas des freigegebenen Ablauf-Set-Schemas, dem dieser freigegebene Ablauf entspricht Der einzige unterstützte Wert ist derzeit "majorVersion 4" und "minorVersion 0". Diese Einstellung kann zukünftig verwendet werden, um die Entwicklung des freigegebenen Ablauf-Set-Formats zu ermöglichen. 4.0 Nein
CreatedAt und CreatedBy Das Datum/die Uhrzeit (in Epochenzeit), in der das freigegebene Ablauf-Set erstellt wurde, sowie die E-Mail des Nutzers, der es erstellt hat.
Description Eine Beschreibung des freigegebenen Ablaufs in Textform. Falls vorhanden, wird die Beschreibung in der Edge-Management-Benutzeroberfläche. Nein
DisplayName Ein benutzerfreundlicher Name, der sich vom Attribut name der freigegebenen Ablaufkonfiguration unterscheiden kann. Nein
LastModifiedAt und LastModifiedBy Datum/Uhrzeit (in Epoche), in dem das freigegebene Ablauf-Set zuletzt geändert wurde, zusammen mit der E-Mail-Adresse des Nutzers, der es geändert hat.
Policies Eine Liste der Richtlinien im Verzeichnis /policies dieses freigegebenen Ablaufs. In der Regel sehen Sie dieses Element nur, wenn der freigegebene Ablauf mit der Edge-Management-UI erstellt wurde. Dies ist einfach eine Manifest-Einstellung, die Einblick in den Inhalt des freigegebenen Ablaufs gibt. Nein
Resources Eine Liste der Ressourcen (JavaScript, Python, Java, XP) im /resources-Verzeichnis dieses freigegebenen Ablaufs. In der Regel sehen Sie dieses Element nur, wenn der freigegebene Ablauf mit der Edge-Management-UI erstellt wurde. Dies ist einfach eine Manifest-Einstellung, die Einblick in den Inhalt des freigegebenen Ablaufs gibt. Nein
SharedFlows Gibt den freigegebenen Ablauf in diesem Set an.

Beachten Sie, dass dieses Element derzeit nur ein untergeordnetes Element <SharedFlow> unterstützt. Einem freigegebenen Ablauf-Set kann nur ein freigegebener Ablauf hinzugefügt werden.

Ja

Freigegebene Abläufe

/sharedflowbundle/sharedflows/default.xml

Die SharedFlow-Konfiguration definiert die Reihenfolge, in der Ablaufelemente ausgeführt werden sollen. Die untergeordneten <Step>-Elemente des <SharedFlow>-Elements geben einen Teil der Reihenfolge an, beispielsweise den Aufruf einer Richtlinie.

Die folgende SharedFlow-Konfiguration gibt drei Richtlinien an, die in einer nach oben und rechts angeordneten Abfolge von links nach rechts in der Verwaltungskonsole ausgeführt werden. Spike Arrest-Richtlinie ersten und ein Richtlinie für Ablauf-Callouts last.

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

Attribute der freigegebenen Ablaufkonfiguration

Name Beschreibung Standard erforderlich?
SharedFlow
name Der Name des freigegebenen Ablaufs, der innerhalb einer Organisation einmalig sein muss. Die Zeichen, die Sie im Namen verwenden dürfen, sind auf folgende Zeichen beschränkt: A-Za-z0-9_- Ja
revision Die Versionsnummer der freigegebenen Ablaufkonfiguration. Sie müssen nicht explizit festlegen, die Überarbeitungsnummer, da Apigee Edge automatisch die aktuelle Überarbeitung der freigegebenen Ablauf. Nein

Elemente der freigegebenen Ablaufkonfiguration

Name Beschreibung Standard erforderlich?
SharedFlow Definiert die Reihenfolge der Richtlinien im freigegebenen Ablauf. Ja
Step Definiert einen Schritt – eine Phase in der Ablaufsequenz. Ja
Name Gibt den Namen des Elements an, auf das sich im Schritt bezogen wird. Der Wert dieses Elements sollte mit der eindeutigen Kennzeichnung des Artikels übereinstimmen, z. B. mit dem Attribut "name" der Richtlinie. Ja

Richtlinien

/sharedflowbundle/policies

Wie in einem API-Proxy enthält das Verzeichnis /policies ein Konfigurations-XML für alle Richtlinien, die dem freigegebenen Ablauf im Set angehängt werden können. Richtlinien nutzen eine Teilmenge von Elementen, auch wenn diese durch Elemente erweitert werden, die die für die Richtlinie spezifisch sind. Weitere Informationen zum Konfigurieren einer Richtlinie finden Sie im Thema zur Richtlinie ganz nach Ihren Vorstellungen. Sie können sie auch über die Richtlinienreferenz Übersicht.

Ressourcen

/sharedflowbundle/resources

Ressourcen sind Skripts, Code und XSL-Transformationen, die über Richtlinien an freigegebene Abläufe angehängt werden können. Sie erscheinen im Abschnitt „Scripts“ des freigegebenen Ablauf-Editors in der Verwaltungsoberfläche.

Die unterstützten Ressourcentypen finden Sie unter Ressourcendateien.

Fragen im Apigee-Entwickler-Forum posten.