你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

从缓存中删除值

适用于：所有 API 管理层级

cache-remove-value 删除通过密钥标识的缓存项。 密钥的值可以是任意字符串，通常使用策略表达式来提供密钥。

注意

按照策略声明中提供的顺序设置策略的元素和子元素。 详细了解如何设置或编辑 API 管理策略。

策略语句

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

属性

属性	说明	需要	默认
caching-type	在以下属性值之间进行选择： - internal，表示可使用内置的 API 管理缓存； - external 使用外部缓存，如- 中所述； - prefer-external 如果外部缓存已配置，则使用外部缓存，否则使用内部缓存。 不允许使用策略表达式。	否	prefer-external
key	以前所缓存的值（将从缓存中删除）的密钥。 允许使用策略表达式。	是	空值

使用情况

• 策略节：入站、出站、后端、错误时
• 策略范围：全局、工作区、产品、API、操作
• 网关：经典、v2、消耗、自承载、工作区

示例

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

有关此策略的详细信息和示例，请参阅 Azure API 管理中的自定义缓存。

相关策略

• 缓存

相关内容

有关使用策略的详细信息，请参阅：

• 教程：转换和保护 API
• 策略参考，其中提供了策略语句及其设置的完整列表
• 策略表达式
• 设置或编辑策略
• 重复使用策略配置
• 策略片段存储库
• Azure API 管理策略工具包
• 使用 Azure 中的 Microsoft Copilot 创作策略