使用政策新增功能

本頁內容適用於 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>