Skip to main content
POST
心跳续租工作行

请求头

kimi-api-version
enum<string>

本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。 平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。

可用选项:
2026-09-01-beta

路径参数

environment_id
string
必填

工作行所属的环境。

id
string
必填

工作行 ID。

请求体

application/json

POST /v1/environments/{environment_id}/work/{id}/heartbeat 的请求体。

worker_id
string
必填

持有租约的 worker。

Minimum string length: 1
generation
integer<int64>
必填

认领时返回的 fencing token。

必填范围: x >= 1

响应

续租后该工作行的租约状态。

心跳成功后工作行的租约状态。

last_heartbeat
string<date-time>
必填

最近一次续租时刻。

lease_extended
boolean
必填

心跳是否续租成功(成功时恒为 true;失败返回 412)。

state
enum<string>
必填

更新后的生命周期状态。

可用选项:
queued,
starting,
active,
stopping,
completed,
failed,
cancelled
ttl_seconds
integer<int64>
必填

自心跳时刻起生效的租约时长(秒)。

generation
integer<int64>
必填

工作行的当前 fencing token,与心跳后的租约状态一起返回。