使用政策新增功能

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