基础设施相关接口/Agent 管理
POSTAgent起始版本 1.0同步需要认证
获取锁
获取独占操作锁特定代理阻止并发变更。
调试可用性
在线调试
使用当前认证信息和示例参数提交 Mock 请求。
请求参数
请求体字段
lockObject必填锁。
agentIdString代理ID。
示例： agent-abc123-def456
operationTypeString操作类型。
示例： upgrade
holderString持有者。
示例： upgrade-service
ttlSecondsIntegerTTL秒。
示例： 300
响应状态
请求地址
POST/api/v1/agents/locks
/api/v1/agents/locks
请求示例
curl -X POST '{host}/api/v1/agents/locks' -H 'Authorization: Bearer {token}' -H 'Content-Type: application/json' -d '{"lock":{"agentId":"agent-abc123-def456","operationType":"upgrade","holder":"upgrade-service","ttlSeconds":300}}'
响应示例
200{
"acquired": true,
"lockToken": "lock-token-abc123",
"expiresAt": "example",
"message": "Lock acquired successfully"
}变更历史
此 API 暂无变更历史记录。