共用方式為


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

適用於:所有 APIM 層

除了利用 內建快取之外,Azure API 管理 還允許在外部 Redis 相容快取中快取回應,例如 Azure 受控 Redis。

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

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

如需快取的背景資訊和使用情境,請參閱快取概觀

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

附註

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

您將學到什麼:

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

先決條件

若要完成本教學課程,您需要:

  • 建立 Azure API 管理執行個體

  • 了解在 Azure API 管理中快取

  • 請確保有可用的 Azure 託管 Redis 或其他 Redis 相容快取。

    重要事項

    Azure API 管理會使用 Redis 連接字串來連線到快取。 如果您使用 Azure 受控 Redis,請在快取中啟用存取金鑰驗證,以使用連接字串。 目前,您無法使用 Microsoft Entra 驗證將 Azure API 管理 連線到 Azure 受控 Redis。

用於 Kubernetes 的 Redis 快取

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

新增外部快取

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

螢幕擷取畫面,示範如何在 Azure API 管理 中新增外部 Azure 受控 Redis 快取。

使用來源設定

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

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

  • 自我裝載閘道位置

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

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

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

附註

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

從相同的訂用帳戶新增 Azure 受控 Redis 執行個體

  1. 在 Azure 入口網站中瀏覽至您的 API 管理執行個體。
  2. 在左側功能表中,於 [部署 + 基礎結構] 底下,選取 [外部快取
  3. 選取 [+ 新增]
  4. 在 [快取執行個體] 下拉式清單中,選取您的快取。
  5. 在 [使用來源] 下拉式清單中,選取 [預設] 或指定所需的區域。 連接字串會自動填入。
  6. 選取 [儲存]

附註

預設連接字串的格式 <cache-name>:10000,password=<cache-access-key>,ssl=True,abortConnect=False為 。 API 管理會將字串儲存為名為 value 的機密資訊。 如果您需要檢視或編輯字串來更新存取金鑰或解決連線問題,請移至 [Named values] 頁面。

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

  1. 在 Azure 入口網站中瀏覽至您的 API 管理執行個體。
  2. 在左側功能表中,於 [部署 + 基礎結構] 底下,選取 [外部快取
  3. 選取 [+ 新增]
  4. 在 [快取執行個體] 下拉式清單中,選取 [自訂]
  5. 在 [使用來源] 下拉式清單中,選取 [預設] 或指定所需的區域。
  6. [連接字串] 欄位中輸入您的 Azure 受控 Redis 或 Redis 相容快取連接字串。
  7. 選取 [儲存]

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

  1. 在左側功能表中,於 [部署 + 基礎結構] 底下,選取 [外部快取
  2. 選取 [+ 新增]
  3. 在 [快取執行個體] 下拉式清單中,選取 [自訂]
  4. 在 [使用來源] 下拉式清單中,選取 [預設] 或指定所需的區域。
  5. 在 [連接字串] 欄位中輸入您的 Redis 快取連接字串。
  6. 選取 [儲存]

使用外部快取

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

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