跳到主要内容

更新连接器错误 API

警告

此功能处于技术预览版,可能会在未来的版本中更改或移除。Elastic 将努力修复任何问题,但技术预览版功能不受正式 GA 功能的支持 SLA 约束。

新版 API 参考

有关最新的 API 详情,请参阅连接器 API

更新连接器的 error 字段。

要开始使用连接器 API,请查看我们的教程

请求

PUT _connector/<connector_id>/_error

前置条件

  • 要使用自托管连接器同步数据,你需要在自己的基础设施上部署 Elastic 连接器服务。对于 Elastic 托管连接器,此服务在 Elastic Cloud 上自动运行。
  • connector_id 参数应引用一个现有的连接器。

描述

设置指定连接器的 error 字段。如果请求体中提供的 error 为非 null 值,连接器的状态将更新为 error。否则,如果 error 重置为 null,连接器状态将更新为 connected

路径参数

  • <connector_id>(必需,字符串)

    连接器的唯一标识符。

请求体

  • error(必需,字符串)

    与连接器遇到的最后一个错误相关的消息。

响应码

  • 200:连接器的 error 字段已成功更新。
  • 400:未提供 connector_id 或请求负载格式不正确。
  • 404(缺少资源):找不到匹配 connector_id 的连接器。

示例

以下示例更新 ID 为 my-connector 的连接器的 error 字段:

PUT _connector/my-connector/_error
{
"error": "Houston, we have a problem!"
}

API 返回以下结果:

{
"result": "updated"
}

原文链接