使用政策新增功能

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