延长Lease

延长当前预留任务的租约。

身份验证

需要身份验证。通过 X-API-Key 或 Authorization: Bearer 头部传递 API 密钥。

路径参数

参数	类型	描述
id	string	调度器的唯一标识符
task	string	任务的唯一标识符

请求体

字段	类型	描述
extension	integer	额外的租约时间（秒）

1{
2  "extension": "30s"
3}

请求示例

1curl -X POST "https://api.hola.cloud/schedulers/sched-a1b2c3d4-e5f6-7890-abcd-ef1234567890/tasks/task-x1y2z3/extend" \
2  -H "X-API-Key: YOUR_API_KEY" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "extension": "30s"
6  }'

响应示例

1HTTP/1.1 200 OK
2Content-Type: application/json

1{
2  "id": "task-x1y2z3",
3  "lease_expires_at": "2025-06-21T12:02:31Z"
4}

错误代码

状态	代码	描述
400	validation_error	缺少或无效的 extension 值
401	unauthorized	缺少或无效的 API 密钥
404	not_found	未找到调度器或任务
409	conflict	任务当前未被预留或租约已过期
500	internal_error	服务器内部错误