你当前正在访问 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 管理中的自定义缓存

有关使用策略的详细信息,请参阅: