共享流软件包配置参考文档

本页面适用于 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 文档。

共享流是可重复使用的功能，其类似于 API 代理。如需了解详情，请参阅创建可重复使用的共享流。

共享流软件包目录结构

下面显示了共享流软件包目录结构，其类似于 API 代理配置目录结构。

共享流软件包目录结构

共享流软件包配置包含以下内容：

基本配置 主要配置设置。
政策 符合 Apigee 政策架构的 XML 格式配置文件。
资源 政策引用以执行自定义逻辑的脚本、JAR 文件和 XSLT 文件。
共享流 此软件包包含的共享流。

基本配置

基本配置文件位于软件包的根目录中。其名称是软件包的名称。

/sharedflowbundle/traffic-management-shared.xml

基本配置定义了共享流软件包的内容，以及用于跟踪软件包的修订历史记录的信息。

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

基本配置属性

名称 说明 默认 是否必需？
SharedFlowBundle
name 共享流软件包的名称，在同一组织中必须是唯一的。有效字符包括：A-Za-z0-9_- 不适用 是
revision 共享流软件包配置的修订版本号。您无需明确设置修订版本号，因为 Apigee 会自动跟踪共享流的当前修订版本。 不适用 否

基本配置元素

名称 说明 默认 是否必需？
SharedFlowBundle
ConfigurationVersion 此共享流所遵守的共享流软件包配置架构的版本。目前唯一支持的值是 majorVersion 4 和 minorVersion 0。此设置将来可能会用于支持共享流软件包格式的演化。 4.0 否
“CreatedAt”和“CreatedBy” 共享流软件包的创建日期/时间（以新纪元时间为单位），以及创建该共享流软件包的用户的电子邮件。
Description 共享流的文本说明。如果提供，说明将显示在 Apigee 界面中。 不适用 否
DisplayName 易记的名称，可能与共享流配置的 name 属性不同。 不适用 否
“LastModifiedAt”和“LastModifiedBy” 共享流软件包的最后一次修改日期/时间（以新纪元时间为单位），以及修改该软件包的用户的电子邮件。
Policies 此共享流的 /policies 目录中的政策列表。通常，只有在使用 Edge 管理界面创建共享流时，才会看到此元素。这只是一个“清单”设置，旨在让您深入了解共享流的内容。 不适用 否
Resources 此共享流的 /resources 目录中的资源（JavaScript、Python、Java、XSLT）的列表。通常，只有在使用 Apigee 界面创建共享流时，才会看到此元素。这只是一个清单设置，旨在让您深入了解共享流的内容。 不适用 否
SharedFlows 此捆绑包包含的共享流程。 不适用 是

政策

/sharedflowbundle/policies

与在 API 代理中一样，在共享流软件包中，/policies 目录包含可用于附加到软件包中共享流的所有政策的配置 XML。政策会共享一部分元素，但这一部分元素补充了政策特有的元素。如需详细了解如何配置政策，请参阅政策参考概览。

资源

/sharedflowbundle/resources

资源是可以使用政策附加到共享流的脚本、代码和 XSL 转换。它们显示在管理界面中共享流编辑器的“脚本”部分中。

如需了解受支持的资源类型，请参阅管理资源。

共享流

/sharedflowbundle/sharedflows/default.xml

SharedFlow 配置定义了流元素的执行顺序。<SharedFlow> 元素的 <Step> 子元素都会指定序列的一部分（例如调用政策）。

以下 SharedFlow 配置指定了要按从上到下顺序执行的三项政策（在管理控制台中则为从左向右执行），其中先执行 SpikeArrest 政策，最后执行 FlowCallout 政策。

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

共享流配置属性

名称 说明 默认 是否必需？
SharedFlow
name 共享流的名称，该名称在组织内必须独一无二。有效字符包括：A-Za-z0-9_- 不适用 是
revision 共享流配置的修订版本号。您无需明确设置修订版本号，因为 Apigee 会自动跟踪共享流的当前修订版本。 不适用 否

共享流配置元素

名称 说明 默认 是否必需？
SharedFlow 共享流中的政策序列。 不适用 是
Step 流序列中的阶段。 不适用 是
Name 相应步骤引用的项的名称。此元素的值应与该项的唯一标识符（例如政策的名称属性值）相同。 不适用 是