本頁適用於 Apigee 和 Apigee Hybrid。
查看
Apigee Edge 說明文件。
Apigee 持久性功能包括快取、鍵值對應和屬性集。如果您使用的是 Apigee hybrid，可以使用 Kubernetes 密鑰來保留機密資料。
| 功能 | 使用 |
|---|---|
| 快取 | 您可以使用政策進行通用快取，在多個要求/回應工作階段中保留 Proxy 需要的任何物件。您也可以使用
ResponseCache 政策，將後端資源的回應快取。當後端資料只定期更新時，回應快取就特別實用。ResponseCache 政策可減少對後端資料來源的呼叫。 |
| 鍵/值對應 | 鍵值對應 (KVM) 可為可能會定期變更的資料提供一般執行階段儲存庫。例如：使用者工作階段資料、購物車等。KVM 項目可加密。 |
| 資源集 | 屬性集合非常適合用來儲存不常變動的設定資料。 |
| Kubernetes 密鑰 | (僅限 Apigee Hybrid) 使用 Secret 儲存機密資料，例如使用者憑證。 |
快取
當 API Proxy 流程中執行快取政策時，系統會動態建立環境範圍的快取資源。快取政策包括 PopulateCache 政策、LookupCache 政策、InvalidateCache 政策和 ResponseCache 政策。
快取項目會在記憶體 (L1) 中停留一秒鐘。您無法變更這項設定。一秒後，快取的物件會放入資料庫 (L2)，並在快取過期前供您使用。詳情請參閱「記憶體內永久快取層級」。您可以透過快取政策的設定來管理快取詳細資料，例如到期時間。我們提供 Apigee API，可讓您列出及刪除快取資源。
使用快取政策時，您可以設定快取鍵，確保快取值鍵的唯一性。快取索引鍵和其他可設定的值，可讓您以可靠的方式取得您放入的相同資料。快取大小和可用性受特定限制。
您可能會想使用快取來執行下列操作：
- 減少延遲時間和流量。要求會在較短的時間內以重複使用的表示法達成。
- 在多筆交易中儲存資料。您可以儲存工作階段資料，以便在 HTTP 交易中重複使用。
- 支援安全性。將快取項目的存取範圍限制為特定環境，或是特定 API 代理程式。
後端回應快取
您可以使用 ResponseCache 政策快取後端資源的回應。
這項功能特別適合用於只定期更新後端資料的情況。ResponseCache 政策可減少對後端資料來源的呼叫。
您也可以透過 ResponseCache 政策，讓 Apigee 查看特定 HTTP 回應快取標頭，並根據標頭指令採取行動。舉例來說，針對來自後端目標的回應，Apigee 支援 Cache-Control 標頭。這個標頭可用於控制快取回應的最大存留期限，以及其他用途。詳情請參閱「支援 HTTP 回應標頭」。
短期一般用途快取
您可以使用政策進行通用快取，在多個要求/回應工作階段中保留 Proxy 需要的任何物件。
您可以使用 PopulateCache 政策、LookupCache 政策和 InvalidateCache 政策，在執行階段填入、擷取及清除快取資料。
舉例來說，您可能會暫時儲存以下項目：
- 工作階段 ID (用於工作階段管理)。
- 外出呼叫的憑證 (例如 API 金鑰或 OAuth 存取權權杖)。
- 應用程式必須分頁的回應內容。
在執行階段，快取政策會在代理程變數和您指定的設定快取之間複製值。當值放入快取時，系統會從您指定的變數複製至快取。從快取中擷取後，系統會將該值複製到變數中，供 Proxy 使用。
如需程式碼範例，請參閱「範例：通用快取」。
使用 Apigee API 管理快取
您可以使用 caches API 列出及刪除快取。
使用鍵/值對應 (KVM) 進行長期儲存
如要無限期儲存加密或未加密的結構化資料，您可以建立並填入包含任意鍵/值組合的鍵/值對應 (KVM)。舉例來說，您可能會儲存：
- 將 IP 位址與國家/地區代碼對應的對照表。
- 允許/拒絕存取的 IP 位址清單。
- 將長網址與縮短網址對應的對應表。
- 環境專屬資料，例如配額計數和 OAuth 權杖到期時間。
KVM 可使用下列三種範圍之一：機構、環境、API proxy。舉例來說，如果要為機構中的所有 API 使用鍵/值組合，請在機構範圍內建立 KVM；如果只有特定 API 代理程式應能存取鍵/值，請在 apiproxy 範圍內建立 KVM。詳情請參閱「使用鍵值對應」。
資源集
屬性集是一組用於儲存資料的鍵/值組合自訂集合。API Proxy 可在執行時擷取這項資料。
通常，您會使用資源集來儲存不會過期的資料，這些資料不應在 API 代理程式邏輯中硬式編碼，例如設定資料。您可以在任何可存取流程變數的 Proxy 中存取資源集資料。
屬性集合的常見用途是提供與某個環境相關聯的值。舉例來說，您可以建立環境範圍的資源集合，其中包含在測試環境中執行的 Proxy 專屬設定值，以及另一個實際工作環境的集合。
詳情請參閱「使用資源集」。
Kubernetes 密鑰
(僅限 Apigee hybrid) 如果您已在自訂金庫中使用 Kubernetes 管理機密資料的機密金鑰，建議您考慮使用 Kubernetes 機密金鑰。就像 KVM 資料一樣，您可以在 API 代理程式流程變數中存取 Kubernetes 機密資料。詳情請參閱「將資料儲存在 Kubernetes Secret 中」。