使用政策新增功能

本頁適用於 Apigee 和 Apigee Hybrid。

查看 Apigee Edge 說明文件。

Apigee 可讓您使用政策設定 API 的運作方式，完全不需要編寫程式碼。政策就像是模組，可實作特定的有限管理功能。政策可讓您在 API 中新增常見類型的管理功能，並確保這項功能可靠且有效率。

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

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

建立政策

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

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

    附加至 動作
    API Proxy 執行下列任一動作：
    • 將滑鼠游標懸停在下列任一資料夾上，按一下 建立 Apigee 政策圖示，然後選取「建立政策」：
      • apiproxy-name 代理程式套件
      • 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. 視需要編輯檔案，然後選取「File」>「Save」或按下 ⌘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>