移除快取中的值

適用於：所有 APIM 層

cache-remove-value 會刪除依其索引鍵所識別的快取項目。 金鑰可以具有任意字串值，而且通常會使用原則運算式來提供。

注意

請依照原則陳述式中提供的順序，來設定原則的元素和子元素。 深入了解如何設定或編輯 APIM 原則。

原則陳述式

<cache-remove-value key="cache key value" caching-type="prefer-external | external | internal"  />

屬性

屬性	描述	是必要欄位	預設
caching-type	選擇下列屬性值： - internal，使用內建的 APIM 快取， - external，使用外部快取，如在 Azure API 管理中使用外部 Azure Redis 快取中所述， - prefer-external。如有設定，則使用外部快取；否則使用內部快取。 不允許使用原則運算式。	No	prefer-external
索引鍵	要從快取中移除之先前快取值的索引鍵。 允許使用原則運算式。	Yes	N/A

使用方式

• 原則區段：inbound、outbound、backend、on-error
• 原則範圍︰全域、工作區、產品、API、作業
• 閘道： 傳統、v2、使用量、自我裝載、工作區

範例

<cache-store-value
    key="@("userprofile-" + context.Variables["enduserid"])"
    value="@((string)context.Variables["userprofile"])" duration="100000" />

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

相關原則

• 快取

相關內容

如需使用原則的詳細資訊，請參閱：

• 教學課程：轉換及保護 API
• 原則參考，取得原則陳述式及其設定的完整清單
• 原則運算式
• 設定或編輯原則
• 重複使用原則設定
• 原則程式碼片段存放庫 (英文)
• 使用 Microsoft Azure Copilot 撰寫原則