APIGEE KeyValueMapOperations中ExpiryTimeInSecs属性作用及过期问询

核心疑问解答 #

• ExpiryTimeInSecs的作用：当设置为x秒时，对应的键值对会在x秒后从KVM中自动删除，并非仅刷新键值。一旦过期时间到，该键值对就会被移除，后续无法再通过该键获取到对应的值。
• 键的状态：键会随着值一起被移除，过期后KVM中不再存在这个键。

KeyValueMapOperation策略全面说明 #

基本功能 #

该策略是APIGEE中操作KVM（键值映射）的核心工具，支持以下操作类型：

• Retrieve：从KVM读取指定键的值
• Store：向KVM写入或更新键值对
• Delete：从KVM删除指定键值对
• Increment：对数值类型的键值执行自增操作

ExpiryTimeInSecs属性细节 #

• 仅在Store操作时生效，用于设置当前写入/更新的键值对的过期时间
• 若不设置该属性，键值对会永久保存在KVM中（除非手动删除或KVM被清理）
• 过期时间从键值对写入/更新的时刻开始计算，到期后由APIGEE后台自动触发删除，无需额外手动逻辑

使用示例（带过期时间的Store操作） #

<KeyValueMapOperation mapIdentifier="my-kvm" operation="Store">
  <ExpiryTimeInSecs>3600</ExpiryTimeInSecs>
  <Key>
    <Parameter>temp-token</Parameter>
  </Key>
  <Value>
    <Parameter>abc123xyz</Parameter>
  </Value>
</KeyValueMapOperation>

上述示例中，temp-token键值对会在写入后1小时（3600秒）自动从my-kvm中删除。

注意事项 #

• 该属性仅对单个键值对生效，不同键可设置不同过期时间
• 对已存在的键执行Store操作并设置新的ExpiryTimeInSecs，会覆盖原有过期时间，重新计算过期时长

内容的提问来源于stack exchange，提问作者Pranav