更新缓存有效期

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。若更新结果不明确,请先查询缓存元数据,再决定是否需要再次更新。

请求

Shell
1CACHE_NAME='cachedContents/0123456789abcdef0123456789abcdef'
2curl --fail-with-body -X PATCH "https://api.token360.ai/v1/$CACHE_NAME?updateMask=ttl" \
3  -H "x-goog-api-key: $TOKEN360_API_KEY" \
4  -H 'Content-Type: application/json' \
5  -d '{"ttl":"7200s"}'

响应

JSON
1{
2  "name": "cachedContents/0123456789abcdef0123456789abcdef",
3  "model": "models/gemini-2.5-flash",
4  "displayName": "Reference document",
5  "createTime": "2026-11-06T10:00:00Z",
6  "updateTime": "2026-11-06T10:30:00Z",
7  "expireTime": "2026-11-06T12:30:00Z",
8  "usageMetadata": {
9    "totalTokenCount": 4096
10  }
11}
此页面对您有帮助吗?
更新缓存有效期 · Token360