在 Azure API 管理中使用與 Redis 相容的外部快取

適用於：所有 APIM 層

除了利用內建快取以外，Azure API 管理也可讓您在與 Redis 相容的外部快取 (例如 Azure Cache for Redis) 中快取回應。

使用外部快取可協助您克服內建快取的一些限制：

• 避免在 API 管理更新期間定期清除快取
• 更充分地掌控您的快取組態
• 快取超出您的 API 管理層所允許的資料
• 使用快取搭配 API 管理的耗用量層
• 在 API 管理自我裝載閘道中啟用快取

如需快取的詳細資訊，請參閱 API 管理快取原則和在 Azure API 管理中自訂快取。

注意

目前，此功能無法在工作區中使用。

您將學到什麼：

• 在 API 管理中新增外部快取

必要條件

若要完成本教學課程，您需要：

• 建立 Azure API 管理執行個體
• 了解在 Azure API 管理中快取

建立 Azure Cache for Redis

本節說明如何在 Azure 中建立「Azure Redis 快取」。 如果您在 Azure 內部或外部已經有 Azure Cache for Redis 或與 Redis 相容的其他快取，則可以跳到下一節。

1. 若要建立快取，請登入 Azure 入口網站。 在入口網站功能表中，選取 [建立資源]。

   

2. 在 [開始使用] 窗格中，於搜尋列中輸入「Azure Cache for Redis」。 在搜尋結果中，尋找「Azure Cache for Redis」，然後選取 [建立]。

   

3. 在 [新增 Azure Cache for Redis] 窗格的 [基本] 索引標籤上，為您的快取設定下列設定：

   設定	動作	描述
   訂用帳戶	選取 Azure 訂閱。	用於建立新 Azure Cache for Redis 執行個體的訂用帳戶。
   資源群組	選取資源群組，或選取 [新建] 並輸入新的資源群組名稱。	用來建立快取和其他資源的資源群組名稱。 將所有的應用程式資源放在一個資源群組中，您將可輕鬆地一併管理或刪除這些資源。
   DNS 名稱	輸入唯一名稱。	快取名稱必須是 1 到 63 個字元的字串，且只能包含數字、字母和連字號。 名稱的開頭和結尾必須是數字或字母，且不可包含連續的連字號。 快取執行個體的主機名稱為 \<DNS name>.redis.cache.windows.net。
   地點	選取位置。	靠近使用您快取其他服務的 Azure 區域。
   快取 SKU	選取 [SKU]。	快取的可用大小、效能和功能參數取決於 SKU。 如需詳細資訊，請參閱 Azure Cache for Redis 概觀。
   快取大小	選取快取大小。	如需詳細資訊，請參閱 Azure Cache for Redis 概觀。

4. 選取 [網路] 索引標籤，或選取 [下一步: 網路]。

5. 在 [網路] 索引標籤上，選取要用於快取的連線方法。

6. 選取 [進階] 索引標籤，或選取 [下一步: 進階]。

7. 在 [進階] 窗格中，根據下列資訊驗證或選取驗證方法：

   

   • 根據預設，對於新的基本、標準或進階快取，會啟用 Microsoft Entra 驗證並停用存取金鑰驗證。
   • 對於基本或標準快取，您可以選擇非 TLS 連接埠的選取項目。
   • 對於標準和進階快取，您可以選擇啟用可用性區域。 您無法在建立快取後停用可用性區域。
   • 針對進階快取，設定適用於非 TLS 連接埠、叢集、受控識別和資料持續性的設定。

   重要

   為了獲得最佳安全性，建議您盡可能使用 Microsoft Entra ID 搭配受控識別來授權對快取的要求。 使用 Microsoft Entra ID 和受控識別進行授權，提供比共用存取金鑰授權更優異的安全性和易用性。 如需搭配快取使用受控識別的詳細資訊，請參閱使用 Microsoft Entra ID 進行快取驗證 (部分機器翻譯)。

8. (選用) 選取 [標籤] 索引標籤，或選取 [下一步: 標籤]。

9. (選用) 如果您想要分類快取資源，請在 [標籤] 索引標籤上輸入標籤名稱和值。

10. 選取 [檢閱 + 建立] 按鈕。

    在 [檢閱 + 建立] 索引標籤上，Azure 會自動驗證您的設定。

11. 出現綠色的 [通過驗證] 訊息之後，請選取 [建立]。

新的快取部署會在幾分鐘內進行。 您可以在 Azure Cache for Redis 概觀窗格上監視部署進度。 當 [狀態] 顯示 [執行中] 時，表示快取已可供使用。

將 Redis 快取部署至 Kubernetes

針對自我裝載閘道，快取需要外部快取。 為了實現更有效率的快取，自我裝載閘道與其仰賴的快取必須位於鄰近的位置，以有效降低查詢和儲存延遲。 將 Redis 快取部署至相同的 Kubernetes 叢集或附近的其他叢集是最佳的選擇。 了解如何將 Redis 快取部署至 Kubernetes 叢集。

新增外部快取

遵循下列步驟，在 Azure API 管理中新增與 Redis 相容的外部快取。 您可以將快取限制為 API 管理執行個體中的特定閘道。

使用來源設定

設定中的 [使用來源] 設定會指定將使用快取的 API 管理執行個體位置。 選取下列其中一項：

• 裝載 API 管理執行個體的 Azure 區域 (或如果您有多區域部署，則為其中一個設定位置)

• 自我裝載閘道位置

• 預設，將快取設定為 API 管理執行個體中所有閘道位置的預設值

  用於預設的快取將會由用於特定對應區域或位置的快取覆寫。

  例如，請考慮裝載於美國東部、東南亞和西歐區域的 API 管理執行個體。 已設定兩個快取，一個用於預設，另一個用於東南亞。 在此範例中，東南亞中的 API 管理會使用自己的快取，而其他兩個區域將使用預設快取項目。

注意

您可以為多個 API 管理執行個體設定相同的外部快取。 API 管理執行個體可以位於相同或不同的區域。 共用多個執行個體的快取時，您必須在 [使用來源] 設定中選取 [預設]。

從相同的訂用帳戶新增 Azure Redis 快取

1. 在 Azure 入口網站中瀏覽至您的 API 管理執行個體。
2. 從左側功能表中選取 [外部快取] 索引標籤。
3. 選取 [+ 新增] 按鈕。
4. 在 [快取執行個體] 下拉式欄位中選取您的快取。
5. 選取 [預設]，或在使用來源下拉式欄位中，指定所需的區域。
6. 選取 [儲存]。

新增與 Redis 相容的快取，通常裝載於目前 Azure 訂閱或 Azure 外部

1. 在 Azure 入口網站中瀏覽至您的 API 管理執行個體。
2. 從左側功能表中選取 [外部快取] 索引標籤。
3. 選取 [+ 新增] 按鈕。
4. 在 [快取執行個體] 下拉式欄位中選取 [自訂]。
5. 選取 [預設]，或在使用來源下拉式欄位中，指定所需的區域。
6. 在 [連接字串] 欄位中提供您的 Azure Cache for Redis (或與 Redis 相容的快取) 連接字串。
7. 選取 [儲存]。

將 Redis 快取新增至自我裝載閘道

1. 在 Azure 入口網站中瀏覽至您的 API 管理執行個體。
2. 從左側功能表中選取 [外部快取] 索引標籤。
3. 選取 [+ 新增] 按鈕。
4. 在 [快取執行個體] 下拉式欄位中選取 [自訂]。
5. 在使用來源下拉式欄位中，指定所需的自我裝載閘道位置，或指定 [預設]。
6. 在 [連接字串] 欄位中提供您的 Redis 快取連接字串。
7. 選取 [儲存]。

使用外部快取

新增與 Redis 相容的快取之後，請在外部快取中設定快取原則，以啟用回應快取或依索引鍵快取值。

如需詳細範例，請參閱新增快取以改善 Azure API 管理的效能。

後續步驟

• 如需快取原則的詳細資訊，請參閱 API 管理原則參考文件中的快取原則。
• 如需使用原則運算式依索引鍵快取項目，請參閱在 Azure API 管理中自訂快取。