更新缓存有效期
PATCH
/v1/cachedContents/{id}更新缓存的有效期。其他字段不可修改。
/v1 为默认版本,兼容对应的 /v1beta 路径。
身份验证
在 x-goog-api-key 中发送 Token360 API Key。
路径参数
idstringrequired创建时返回的 name 中的 ID 部分,请原样使用。
查询参数
updateMaskstring可选有效期字段掩码:ttl、expireTime 或 expire_time。请使用与请求中有效期字段对应的掩码。
请求体
ttlstring新的有效时长(秒),大于零且不超过 86400s。与 expireTime 互斥。
expireTimestring新的未来到期时间(RFC3339),不超过当前时间之后 24 小时。与 ttl 互斥。
必须且只能提供一个有效期字段。ttl 从本次更新请求开始计算,不会叠加到原有有效期上。请在缓存到期前续期;更新无法重新创建已过期的内容。
响应
namestring缓存资源名称,格式为 cachedContents/{id}。请保存用于后续操作。
modelstring模型名称,格式为 models/{model}。
displayNamestring显示名称(若返回)。
createTimestring创建时间(RFC3339,若返回)。
updateTimestring最后更新时间(RFC3339,若返回)。
expireTimestring到期时间(RFC3339,若返回)。
usageMetadataobject缓存用量信息(若返回)。
usageMetadata.totalTokenCountinteger缓存 Token 数量(若返回)。
需要内容保留权限。发生并发更新或缓存无法执行此操作时返回 409。若更新结果不明确,请先查询缓存元数据,再决定是否需要再次更新。
此页面对您有帮助吗?