流程設定參考資料

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件。 資訊

本節提供 XML 元素的參考資訊， API Proxy 流程

階層與語法

以下範例顯示流程設定的元素階層和語法 元素：

元素階層

以下範例顯示 <ProxyEndpoint> 和 <TargetEndpoint> 元素：

<ProxyEndpoint | TargetEndpoint>
    <PreFlow>
          <Request>
                <Step>
                    <Condition>
                    <Name>
          <Response>
                <Step>
                    <Condition>
                    <Name>
          <Description>
    <Flows>
          <Flow>
                <Description>
                <Condition>
                <Request>
                      <Step>
                          
                <Response>
                      <Step>
                          
          <Description>
    <PostFlow>
          <Request>
                <Step>
                    
          <Response>
                <Step>
                    
          <Description>
    <PostClientFlow> (<ProxyEndpoint> only)
          <Response>
                
          <Description>

      // Additional configuration elements

</ProxyEndpoint | TargetEndpoint>

語法

以下範例顯示流程設定元素的語法。每個 ，會在以下章節中詳細說明：

<!-- ProxyEndpoint flow configuration file -->
<ProxyEndpoint ... >
  ...
  <PreFlow name="flow_name">
    <Description>flow_description</Description>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PreFlow>
  <Flows name="flow_name">
    <Flow name="conditional_flow_name">
      <Description>flow_description</Description>
      <Condition>property operator "value"</Condition>
      <Request>
        <Step>
          <Condition>property operator "value"</Condition>
          <Name>policy_name</Name>
        </Step>
        ...
      </Request>
      <Response>
        <Step>
          <Condition>property operator "value"</Condition>
          <Name>policy_name</Name>
        </Step>
        ...
      </Response>
    </Flow>
  </Flows>
  <PostFlow name="flow_name">
    <Description>flow_description</Description>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PostFlow>
  <PostClientFlow name="flow_name">
    <Description>flow_description</Description>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PostClientFlow>
  ...
</ProxyEndpoint>

<!-- TargetEndpoint flow configuration file -->
<TargetEndpoint ... >
  ...
  <PreFlow name="flow_name">
    <Description>flow_description</Description>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PreFlow>
  <Flows name="flow_name">
    <Flow name="conditional_flow_name">
      <Description>flow_description</Description>
      <Condition>property operator "value"</Condition>
      <Request>
        <Step>
          <Condition>property operator "value"</Condition>
          <Name>policy_name</Name>
        </Step>
        ...
      </Request>
      <Response>
        <Step>
          <Condition>property operator "value"</Condition>
          <Name>policy_name</Name>
        </Step>
        ...
      </Response>
    </Flow>
    ...
  </Flows>
  <PostFlow name="flow_name">
    <Description>flow_description</Description>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </PostFlow>
  ...
</TargetEndpoint>

請使用這些元素定義 PreFlow、條件式流程、PostFlow 與 PostClientFlow

<Condition>

定義在執行階段處理的陳述式。如果此陳述評估為 true，則系統會執行與條件相關聯的步驟或流程。如果 陳述式的評估結果為 false，就會略過步驟或流程。

類型 字串
父項元素 <Flow>
<Step>
子元素 無

視您輸入的內容類型而定，您可以將條件套用至特定步驟或整個流程 <Flow> 或 <Step> 元素中的元素：

// Condition can apply to just one step:        // Or to the flow:
<Flows>                                         <Flows>
  <Flow>                                          <Flow>
    <Step>                                          <Condition>
      <Condition>                                   <Step>
      <Name>                                          <Name>
      ...                                             ...
    ...                                             ...
  ...                                             ...
</Flows>                                        </Flows>

如果 <Step> 中的條件評估為 True，Edge 就會執行該步驟。如果條件 的值為 false，則 Edge 會略過步驟。

如果 <Flow> 中的條件評估為 True，Edge 就會處理資料流中的所有步驟。如果 條件評估為 false，則 Edge 會略過整個流程。

語法

<Condition> 元素使用下列語法：

<Condition>property operator "value"</Condition>

在此情況下：

property
您要使用的流程變數屬性 值。例如，request 流程變數具有名為 path和content。如要在條件中使用這些屬性，您必須指定 flow_variable[點]property_name： 
request.path
request.content

如需流程變數及其屬性的完整清單，請參閱 流程變數參考資料。

operator
定義條件評估方式的結構。一般 運算子包括： 
>     greater than           <=    less than or equal to
<     less than              >=    greater than or equal to
=     equals                 &&    and
!=    not equals             ||    or

~~    JavaRegex
~     Matches
/~    MatchesPath

如需完整清單，請參閱： 運算子 條件參考資料。

「value」
評估流程變數屬性時所用的值。這通常屬於 基本型別，例如整數或字串。例如 200 或「/cat」。此值可以 加入星號等萬用字元來比對模式，例如 描述 使用條件式比對模式。

範例 1

以下範例會檢查 request 資料流變數的 verb 屬性是「GET」：

<!-- api-platform/reference/examples/flow-segments/condition-1.xml -->
<ProxyEndpoint name="default">
  <PreFlow name="my-preFlows">
    <Description>My first PreFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
  </PreFlow>
  ...
</ProxyEndpoint>

如果要求是「GET」，則這個範例會執行「Log-Request-OK」政策。

範例 2

以下範例會檢查回應代碼：

<!-- api-platform/reference/examples/flow-segments/condition-2.xml -->
<ProxyEndpoint name="default">
  <PreFlow name="my-preFlows">
    <Description>My first PreFlow</Description>
    <Response>
      <Step>
        <Condition>response.status.code LesserThanOrEquals 300</Condition>
        <Name>Log-Response-OK</Name>
      </Step>
      <Step>
        <Condition>response.status.code GreaterThan 300</Condition>
        <Name>Log-Response-NOT-OK</Name>
      </Step>
    </Response>
  </PreFlow>
  ...
</ProxyEndpoint>

依據程式碼的值，執行不同的政策。

屬性

<Condition> 元素沒有屬性。

子元素

<Condition> 元素不含任何子元素。

<Description>

以使用者可理解的術語說明資料流。請使用這個元素提供 藉此給自己或其他開發人員說明內容不會對外公開。

類型 字串
父項元素 <Flow>
<PreFlow>
<PostFlow>
子元素 無

語法

<Description> 元素使用下列語法：

<Description>flow_description</Description>

範例

以下範例顯示了 <Description> 元素，該元素的用途是 流程：

<!-- api-platform/reference/examples/flow-segments/description-1.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-conditional-flows">
    <Flow name="reports">
      <Request>
        <Description>Based on the path suffix, determine which flow to use</Description>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/reports"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/forecasts"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

屬性

<Description> 元素沒有屬性。

子元素

<Description> 元素不含任何子元素。

<Flow>

定義一組由 Edge 執行的自訂步驟。

類型 複雜物件
父項元素 <Flows>
子元素 <Condition>
<Description>
<Request>
<Response>

您可以視需要在 <Flow> 上指定 <Condition>。在這種情況下，Edge 只會執行 條件評估為 true 時，流程中的步驟。否則，邊緣會略過整個 流程

<Flows> 元素可包含多個 <Flow> 元素，每個元素有各自的條件 和步驟如果有多個 <Flow> 元素，Edge 只會執行第一個元素 沒有條件或條件評估結果為 true。

您可以定義一律執行的預設流程 (如果其他條件式流程都不適用)。 視 API Proxy 的設定方式而定，這項工具在以下領域相當實用： 防止惡意程式碼 攻擊。

語法

<Flow> 元素使用下列語法：

<Flow name="conditional_flow_name">
  <Description>flow_description</Description>
  <Condition>property operator "value"</Condition>
  <Request>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Request>
  <Response>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Response>
</Flow>

<Flow> 的所有子元素皆為選用。

範例 1

以下範例顯示一律執行「Log-Message-OK」的簡易 <Flow> 政策：

<!-- api-platform/reference/examples/flow-segments/flow-1.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-flow">
    <Flow>
      <Request>
        <Step>
          <Name>Log-Message-OK</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

範例 2

以下範例顯示包含多個步驟的 <Flow>，每個步驟都有各自的步驟 條件：

<!-- api-platform/reference/examples/flow-segments/flow-2.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-conditional-flows">
    <Flow name="reports">
      <Request>
        <Description>Based on the path suffix, determine which flow to use</Description>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/reports"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/forecasts"</Condition>
          <Name>Verify-Auth-1</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

範例 3

以下範例顯示條件式流程中的多個流程：

<!-- api-platform/reference/examples/flow-segments/flows-2.xml -->
<ProxyEndpoint name="default">
  <Flows>
    <Flow name="my-flow-1">
      <Response>
        <Step>
          <Condition>response.status.code = 200</Condition>
          <Name>Assign-Message-1</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-flow-2">
      <Response>
        <Step>
          <Condition>response.status.code >= 400</Condition>
          <Name>Assign-Message-2</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-flow-3">
      <Response>
        <Step>
          <Condition>response.status.code >= 300</Condition>
          <Name>Assign-Message-3</Name>
        </Step>
      </Response>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

邊緣只在一個區隔中執行一個流程；會執行第一個 或條件解析為 true 的條件。

屬性

下表將說明 <Flow> 元素的屬性：

屬性 類型 說明
name 字串 (必要) 流程的專屬 ID。例如： &quot;My-Conditional-Flow-1&quot;.名稱不得包含空格或其他特殊字元。

子元素

下表說明 <Flow> 的子元素：

子元素 類型 說明
<Condition> 字串 定義在執行階段處理的條件陳述式。如果陳述評估成功， 就會執行流程 (及其所有步驟)。如果此陳述評估為 false，則系統會忽略流程 (及其所有步驟)。
<Description> 字串 提供流程的簡短說明。這不是外部的說明 顯示。
<Request> 複雜物件 指定要求區隔的步驟和條件。
<Response> 複雜物件 指定回應區隔的步驟和條件。

<Flows>

包含零或多個 <Flow> 元素。

類型 複雜物件
父項元素 <ProxyEndpoint>
<TargetEndpoint>
子元素 <Flow>

如果 <Flows> 中有多個 <Flow> 元素，則只會執行一個 <Flow>。這個 會是第一個沒有 <Condition> 的資料流，或其條件會解析 設為 true

您可以定義一律執行的預設流程 (如果其他流程都不適用)。 視 API Proxy 的設定方式而定，這項工具在以下領域相當實用： 防止惡意程式碼 攻擊。

語法

<Flows> 元素使用下列語法：

<Flows name="flow_name">
  <Flow name="conditional_flow_name">
    <Description>flow_description</Description>
    <Condition>property operator "value"</Condition>
    <Request>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Request>
    <Response>
      <Step>
        <Condition>property operator "value"</Condition>
        <Name>policy_name</Name>
      </Step>
      ...
    </Response>
  </Flow>
</Flows>

<Flows> 的所有子元素皆為選用。

範例 1

以下範例顯示設有單一 <Flow> 的簡易 <Flows> 元素：

<!-- api-platform/reference/examples/flow-segments/flows-1.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-conditional-flows">
    <Flow name="reports">
      <Request>
        <Description>Based on the path suffix, determine which flow to use</Description>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/reports"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/forecasts"</Condition>
          <Name>Verify-Auth-1</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

邊緣會根據從 proxy 流程變數。如果路徑後置字串與條件皆不相符， 邊緣不會執行此流程。

範例 2

以下範例顯示 <Flows> 中的多個 <Flow> 元素，每個元素都有自己的 <Condition>:

<!-- api-platform/reference/examples/flow-segments/flows-2.xml -->
<ProxyEndpoint name="default">
  <Flows>
    <Flow name="my-flow-1">
      <Response>
        <Step>
          <Condition>response.status.code = 200</Condition>
          <Name>Assign-Message-1</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-flow-2">
      <Response>
        <Step>
          <Condition>response.status.code >= 400</Condition>
          <Name>Assign-Message-2</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-flow-3">
      <Response>
        <Step>
          <Condition>response.status.code >= 300</Condition>
          <Name>Assign-Message-3</Name>
        </Step>
      </Response>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

區隔中只有條件評估為 true 的流程才會執行第一個流程。更新後 邊緣會略過區隔中其餘的流量

範例 3

以下範例顯示「預設」<Flow>:

<!-- api-platform/reference/examples/flow-segments/flows-3.xml -->
<ProxyEndpoint name="default">
  <Flows>
    <Flow name="my-conditional-flow-1">
      <Response>
        <Step>
          <Condition>response.status.code = 200</Condition>
          <Name>Assign-Message-1</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-conditional-flow-2">
      <Response>
        <Step>
          <Condition>response.header.someheader = "42"</Condition>
          <Name>Assign-Message-2</Name>
        </Step>
      </Response>
    </Flow>
    <Flow name="my-default-flow">
      <Response>
        <Step>
          <Name>Assign-Message-3</Name>
        </Step>
      </Response>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

區隔中只有條件評估為 true 的流程才會執行第一個流程。如果 不執行條件式流程，然後此範例中的第三個流程（沒有條件） 執行作業。

預設流程是 防止惡意程式碼 攻擊。

屬性

<Flows> 元素沒有屬性。

子元素

<Flows> 元素包含下列子元素：

子元素 類型 說明
<Flow> 複雜物件 此流程可在條件式流程中定義一組可能的步驟。

<Name>

指定要在 <Flow> 中執行的政策 ID。

類型 字串
父項元素 <Step>
子元素 無

語法

<Name> 元素使用下列語法：

<Name>policy_name</Name>

範例

以下範例顯示透過名稱新增至流程的兩項政策：

<!-- api-platform/reference/examples/flow-segments/name-1.xml -->
<ProxyEndpoint name="default">
  <Flows name="my-conditional-flows">
    <Flow name="reports">
      <Request>
        <Description>Based on the path suffix, determine which flow to use</Description>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/reports"</Condition>
          <Name>XML-to-JSON-1</Name>
        </Step>
        <Step>
          <Condition>proxy.pathsuffix MatchesPath "/forecasts"</Condition>
          <Name>Verify-Auth-1</Name>
        </Step>
      </Request>
    </Flow>
  </Flows>
  ...
</ProxyEndpoint>

屬性

<Name> 元素沒有屬性。

子元素

<Name> 元素不含任何子元素。

<PostFlow>

定義在要求和回應的 PostFlow 中採取的步驟。

類型 複雜物件
父項元素 <ProxyEndpoint>
<TargetEndpoint>
子元素 <Description>
<Request>
<Response>

<PostFlow> 元素使用下列語法：

語法

<PostFlow name="flow_name">
  <Description>flow_description</Description>
  <Request>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Request>
  <Response>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Response>
</PostFlow>

範例

以下範例顯示包含要求和回應步驟的 PostFlow 定義：

<!-- api-platform/reference/examples/flow-segments/postflow-1.xml -->
<ProxyEndpoint name="default">
  <PostFlow name="my-postflows">
    <Description>My first PostFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
    <Response>
      <Step>
        <Name>Set-Response-Headers</Name>
      </Step>
    </Response>
  </PostFlow>
  ...
</ProxyEndpoint>

屬性

下表將說明 <PostFlow> 元素的屬性：

屬性 類型 說明
name 字串 流程的專屬 ID (端點中不會重複)。例如「My-PostFlow-1」。 值不得包含空格或其他特殊字元。

子元素

下表說明 <PostFlow> 的子元素：

子元素 類型 說明
<Description> 字串 提供流程的簡短說明。
<Request> 複雜物件 定義在要求 PostFlow 期間要執行的政策。
<Response> 複雜物件 定義在回應的 PostFlow 期間要執行的政策。

<PostClientFlow>

定義 ProxyEndpoint 中僅在回應傳回後執行的政策 用戶端。這類政策通常會記錄與回應相關的訊息。

類型 複雜物件
父項元素 <ProxyEndpoint>
子元素 <Description>
<Response>

語法

<PostClientFlow> 元素使用下列語法：

<PostClientFlow name="flow_name">
  <Description>flow_description</Description>
  <Response>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Response>
</PostClientFlow>

<PostClientFlow> 的所有子元素皆為選用。

範例

以下範例顯示執行單一政策的簡易 PostClientFlow：

<!-- api-platform/reference/examples/flow-segments/postclientflow-1.xml -->
<ProxyEndpoint name="default">
  <PostClientFlow name="my-postclientflows">
    <Description>My first PostClientFlow. Processed after the response is sent back to the client.</Description>
    <Response>
      <Step>
        <Name>Message-Logging-OK</Name>
      </Step>
    </Response>
  </PostClientFlow>
  ...
</ProxyEndpoint>

屬性

下表將說明 <PostClientFlow> 元素的屬性：

屬性 類型 說明
name 字串 流程的專屬 ID。名稱不得包含空格或其他特殊符號 字元。例如「My-PostClientFlow-1」。

子元素

下表說明 <PostClientFlow> 的子元素：

子元素 類型 說明
<Description> 字串 提供流程的簡短說明。
<Response> 複雜物件 定義在回應的 PostFlow 期間要執行的政策。

<PreFlow>

定義要在要求和回應的 PreFlow 中執行的政策。

類型 複雜物件
父項元素 <ProxyEndpoint>
<TargetEndpoint>
子元素 <Description>
<Request>
<Response>

語法

<PreFlow> 元素使用下列語法：

<PreFlow name="flow_name">
  <Description>flow_description</Description>
  <Request>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Request>
  <Response>
    <Step>
      <Condition>property operator "value"</Condition>
      <Name>policy_name</Name>
    </Step>
    ...
  </Response>
</PreFlow>

<PreFlow> 的所有子元素皆為選用。

範例

以下範例顯示了已定義的要求和回應流程的 PreFlow：

<!-- api-platform/reference/examples/flow-segments/preflow-1.xml -->
<ProxyEndpoint name="default">
  <PreFlow name="my-preFlows">
    <Description>My first PreFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
    <Response>
      <Step>
        <Condition>response.status.code LesserThanOrEquals 300</Condition>
        <Name>Log-Response-OK</Name>
      </Step>
      <Step>
        <Condition>response.status.code GreaterThan 300</Condition>
        <Name>Log-Response-NOT-OK</Name>
      </Step>
    </Response>
  </PreFlow>
  ...
</ProxyEndpoint>

屬性

下表將說明 <PreFlow> 元素的屬性：

屬性 類型 說明
name 字串 流程的專屬 ID。名稱不得包含空格或其他特殊符號 字元。例如「My-PreFlow-1」。

子元素

下表說明 <PreFlow> 的子元素：

子元素 類型 說明
<Description> 字串 提供流程的簡短說明。
<Request> 複雜物件 定義在要求 PreFlow 期間要執行的政策。
<Response> 複雜物件 定義在回應的 PreFlow 期間要執行的政策。

<Request>

定義在流程的要求區段期間要執行的政策。

類型 複雜物件
父項元素 <Flow>
<PreFlow>
<PostFlow>
子元素 <Condition>
<Step>

語法

<Request> 元素使用下列語法：

<Request>
  <Step>
    <Condition>property operator "value"</Condition>
    <Name>policy_name</Name>
  </Step>
  ...
</Request>

<Request> 的所有子元素皆為選用。

範例

以下範例顯示 PreFlow 與 PostFlow：

<!-- api-platform/reference/examples/flow-segments/request-1.xml -->
<ProxyEndpoint name="default">
  <PreFlow name="my-preFlows">
    <Description>My first PreFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
  </PreFlow>
  <PostFlow name="my-postflows">
    <Description>My first PostFlow</Description>
    <Request>
      <Step>
        <Condition>request.verb = "GET"</Condition>
        <Name>Log-Request-OK</Name>
      </Step>
    </Request>
  </PostFlow>
  ...
</ProxyEndpoint>

屬性

<Request> 元素沒有屬性。

子元素

下表說明 <Request> 的子元素：

子元素 類型 說明
<Condition> 複雜物件 決定是否要執行要求區隔中的步驟。
<Step> 字串 指定要在要求區隔中執行的政策。

<Response>

定義在流程回應區段期間執行的政策。

類型 複雜物件
父項元素 <Flow>
<PreFlow>
<PostClientFlow>
<PostFlow>
子元素 <Condition>
<Step>

語法

<Response> 元素使用下列語法：

<Response>
  <Step>
    <Condition>property operator "value"</Condition>
    <Name>policy_name</Name>
  </Step>
  ...
</Response>

<Response> 的所有子元素皆為選用。

範例

以下範例顯示在 PreFlow 與 PostFlow：

<!-- api-platform/reference/examples/flow-segments/response-1.xml -->
<ProxyEndpoint name="default">
    <PreFlow name="my-preFlows">
        <Description>My first PreFlow</Description>
        <Response>
            <Step>
                <Condition>response.status.code LesserThanOrEquals 300</Condition>
                <Name>Log-Response-OK</Name>
            </Step>
            <Step>
                <Condition>response.status.code GreaterThan 300</Condition>
                <Name>Log-Response-NOT-OK</Name>
            </Step>
        </Response>
    </PreFlow>
    <PostFlow name="my-postflows">
        <Description>My first PostFlow</Description>
        <Response>
            <Step>
                <Name>Set-Response-Headers</Name>
            </Step>
        </Response>
    </PostFlow>
  ...
</ProxyEndpoint>

屬性

<Response> 元素沒有屬性。

子元素

下表說明 <Response> 的子元素：

子元素 類型 說明
<Condition> 字串 決定是否要執行回應區段中的步驟。
<Step> 字串 指定要在回應區段中執行的政策。

<Step>

指定要執行的政策，並視需要指定要執行的政策，以及決定是否要執行的條件 政策。

類型 複雜物件
父項元素 <Request>
<Response>
子元素 <Condition>
<Name>

<Flow> 中可以定義多個步驟，而這些步驟會在 這些變數在流程的 XML 中定義的順序。

沒有條件的步驟一律會執行。只有條件時才會執行含有條件的步驟 會傳回 true。如果條件評估為 false，則 Edge 會略過步驟。

語法

<Step> 元素使用下列語法：

<Step>
  <Condition>property operator "value"</Condition>
  <Name>policy_name</Name>
</Step>

每個 <Step> 只能有一個 <Condition> 和一個 <Name>，但可以 在 <Flow> 中執行多個步驟。

<Step> 的所有子元素皆為選用。

範例 1

以下範例說明一個步驟，一個步驟有條件，一個步驟則沒有條件：

<!-- api-platform/reference/examples/flow-segments/step-1.xml -->
<ProxyEndpoint name="default">
  <PostFlow name="my-postflows">
      <Description>My first PostFlow</Description>
      <Request>
          <Step>
              <Condition>request.verb = "GET"</Condition>
              <Name>Log-Request-OK</Name>
          </Step>
      </Request>
      <Response>
          <Step>
              <Name>Set-Response-Headers</Name>
          </Step>
      </Response>
  </PostFlow>
  ...
</ProxyEndpoint>

沒有條件的步驟將會在每次要求區隔期間執行。步驟 設有限制條件，只有在要求為「GET」時才會執行回覆期間 區隔

範例 2

以下範例是在單一區隔中呈現多個步驟：

<!-- api-platform/reference/examples/flow-segments/step-2.xml -->
<ProxyEndpoint name="default">
    <PostFlow name="PostFlow">
        <Response>
            <Step>
                <Name>Assign-Message-1</Name>
            </Step>
            <Step>
                <Name>Assign-Message-2</Name>
            </Step>
        </Response>
    </PostFlow>
  ...
</ProxyEndpoint>

沒有條件的步驟一律會執行。

屬性

<Step> 元素沒有屬性。

子元素

下表說明 <Step> 的子元素：

子元素 類型 說明
<Condition> 字串 針對在執行階段處理的步驟定義條件陳述式。如果 陳述式評估為 True，然後 Edge 就會執行步驟如果此陳述評估為 false，則 Edge 會略過步驟。
<Name> 字串 指定在目前流程中執行的政策 ID。