適用於：所有 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。如有設定，則使用外部快取；否則使用內部快取。 不允許使用原則運算式。 |
否 | prefer-external |
| Key | 要從快取中移除之先前快取值的索引鍵。 允許使用原則運算式。 | 是的 | N/A |
使用方式
範例
下列範例示範如何使用 cache-remove-value 原則從快取中移除使用者設定檔。 快取 REMOVAL 的索引鍵是使用原則表示式來建構，該原則表示式會結合字串與環境定義變數的 enduserid 值。
<cache-remove-value
key="@("userprofile-" + context.Variables["enduserid"])" />
如需此原則的詳細資訊和範例，請參閱在 Azure API 管理中自訂快取。
相關原則
相關內容
如需使用原則的詳細資訊，請參閱：
- 教學課程：轉換及保護 API
- 原則參考，取得原則陳述式及其設定的完整清單
- 原則運算式
- 設定或編輯原則
- 重複使用原則設定
- 原則程式碼片段存放庫 (英文)
- 原則遊樂場存放庫
- Azure API 管理 原則工具組
- 取得 Copilot 協助以建立、說明及疑難排解原則