通过

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

在缓存中存储值

  • 项目

适用于：所有 API 管理层级

cache-store-value 按密钥执行缓存存储。 密钥的值可以是任意字符串，通常使用策略表达式来提供密钥。

注意

此策略将值存储到缓存中这项操作是异步执行的。 可以使用从缓存获取值策略检索存储的值。 但是，存储的值可能不会立即就能检索，因为将值存储到缓存中的异步操作可能仍在进行中。

重要

内置缓存是易失性的，由同一 API 管理服务中同一区域的所有单元共享。

注意

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

策略语句

<cache-store-value key="cache key value" value="value to cache" duration="seconds" caching-type="prefer-external | external | internal" />

属性

属性 说明 需要 默认
caching-type 在以下属性值之间进行选择：
- internal，表示可使用内置的 API 管理缓存；
- external 使用外部缓存，如- 中所述；
- prefer-external 如果外部缓存已配置，则使用外部缓存，否则使用内部缓存。

不允许使用策略表达式。		 否 prefer-external
duration 会根据提供的期间值（以秒为单位指定）将值缓存一段时间。 允许使用策略表达式。 是 不适用
key 缓存密钥，会在其下存储值。 允许使用策略表达式。 是 空值
value 要缓存的值。 允许使用策略表达式。 是 空值

使用情况

示例

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

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

相关内容

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