认领连接器同步作业 API
警告
此功能处于技术预览版,可能会在未来的版本中更改或移除。Elastic 将努力修复任何问题,但技术预览版功能不受正式 GA 功能的支持 SLA 约束。
新版 API 参考
有关最新的 API 详情,请参阅连接器 API。
认领连接器同步作业。此操作将作业的状态更新为 in_progress,并将 last_seen 和 started_at 时间戳设置为当前时间。此外,它还可以设置同步作业的 sync_cursor 属性。
_claim 端点不用于用户直接管理连接器。它的存在是为了支持利用连接器协议与 Elasticsearch 通信的服务实现。
请求
PUT _connector/_sync_job/<connector_sync_job_id>/_claim
前置条件
- 要使用自托管连接器同步数据,你需要在自己的基础设施上部署 Elastic 连接器服务。对于 Elastic 托管连接器,此服务在 Elastic Cloud 上自动运行。
connector_sync_job_id参数应引用一个现有的连接器同步作业。
路径参数
<connector_sync_job_id>(必需,字符串)要认领的连接器同步作业的 ID。
请求体
worker_hostname(必需,字符串)将执行该作业的当前系统的主机名。
sync_cursor(可选,对象)上次增量同步作业的游标对象。此对象应引用执行该作业的连接器状态中的
sync_cursor字段。
响应码
200:连接器同步作业认领成功。404:找不到匹配connector_sync_job_id的连接器同步作业。
示例
以下示例认领 ID 为 my-connector-sync-job-id 的连接器同步作业:
PUT _connector/_sync_job/my-connector-sync-job-id/_claim
{
"worker_hostname": "some-machine"
}