使用政策新增功能

本頁內容適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

Apigee 可讓您使用政策設定 API 的運作方式，完全不需要編寫程式碼。政策就像一個模組，它實現了特定的、有限的管理功能。政策的設計宗旨是讓您有效率地將常見的管理功能新增至 API。

政策提供安全防護機制、頻率限制、轉換和中介服務等功能，讓您不必自行建構及維護程式碼。您不限於使用 Apigee 提供的政策類型。您也可以編寫自訂指令碼和程式碼 (例如 JavaScript 應用程式)，擴充 API Proxy 功能，並在 Apigee 政策支援的基本管理功能基礎上進行創新。

如以下各節所述，使用 Cloud Code 中的 Apigee 建立政策，並附加至 API Proxy 和共用流程。根據策略類型，您可能需要建立資源，如管理資源所述。另請參閱管理 Apigee 工作區中的資料夾和檔案。

建立政策

如要使用 Cloud Code 中的 Apigee 建立政策，請按照下列步驟操作：

  1. 在 Apigee 工作區中，根據要附加政策的位置，執行下列其中一項動作：

    附加至 動作
    API Proxy 執行下列任一動作：
    • 將遊標停留在下列資料夾之一上，按一下 建立 Apigee 策略圖標，然後選擇 建立策略:
      • apiproxy-name proxy bundle
      • apiproxy-name/apiproxy
    • 將游標移至 API Proxy 的 apiproxy-name/apiproxy/policies 資料夾，然後點選 建立 API Proxy 圖示。
    共用流程 執行下列其中一項：
    • 將游標懸停在下列任一資料夾上，按一下 建立共用流程圖示，然後選取「建立政策」：
      • sharedflow-name 共用流程組合
      • sharedflow-name/sharedflowbundle
    • 將游標放在共用流程的 sharedflow-name/sharedflowbundle/policies 資料夾上，然後按一下 建立共用流程圖示。

系統會開啟「建立政策」精靈。

  1. 從清單中選擇您要建立的策略類別。 有關政策類別的描述，請參閱政策參考概述。

  2. 輸入保單的唯一名稱，然後按下 Enter。 此策略被加入到 Apigee 部分的 API Proxy 或共用流程的 /policies 資料夾中，並在編輯器中開啟。

  3. 視需要編輯檔案，然後選取「檔案」>「儲存」或按下 ⌘S 鍵，即可儲存編輯內容。 如要進一步瞭解如何設定政策，請參閱「政策參考資料總覽」。

  4. 如果策略類型需要，則建立資源，如管理資源所述。

將策略附加到流程

策略只有附加到流程後才能執行。如要將政策附加至流程，請在 ProxyEndpoint 或 TargetEndpoint 設定中，將 <Step> 元素新增至適當的要求或回應流程元素，詳情請參閱下列主題：

舉例來說，下列設定會將 QuotaPolicy 附加至 ProxyEndpoint 的 <PreFlow>，以設定 API Proxy 在一段時間內允許的要求訊息數。

<ProxyEndpoint name="default">
  <PreFlow>
    <Request>
      <Step><Name>QuotaPolicy</Name></Step>
    </Request>
  </PreFlow>
  <HTTPProxyConnection>
    <BasePath>/weather</BasePath>
  </HTTPProxyConnection>
  <RouteRule name="default">
    <TargetEndpoint>default</TargetEndpoint>
  </RouteRule>
</ProxyEndpoint>