更新连接器管道 API
编辑更新连接器管道 API编辑
此功能处于测试阶段,可能会发生变化。设计和代码比正式 GA 功能还不成熟,按原样提供,不提供任何担保。测试版功能不受正式 GA 功能支持 SLA 的约束。
更新连接器的 pipeline
配置。
创建新连接器时,摄取管道 的配置将填充默认设置。
要开始使用连接器 API,请查看 教程。
请求编辑
PUT _connector/<connector_id>/_pipeline
先决条件编辑
- 要使用自管理连接器同步数据,您需要在自己的基础设施上部署 Elastic 连接器服务。此服务在 Elastic Cloud 上自动运行以用于本机连接器。
connector_id
参数应引用现有连接器。
路径参数编辑
-
<connector_id>
- (必需,字符串)
请求正文编辑
-
pipeline
- (必需,对象) 连接器的管道配置。管道决定数据在摄取到 Elasticsearch 期间如何处理。
管道配置必须包含以下属性
-
extract_binary_content
(必需,布尔值) 指示在摄取期间是否提取二进制内容的标志。 -
name
(必需,字符串) 摄取管道的名称。 -
reduce_whitespace
(必需,布尔值) 指示是否减少摄取内容中的额外空格的标志。 -
run_ml_inference
(必需,布尔值) 指示是否对摄取内容运行机器学习推断的标志。
响应代码编辑
-
200
- 连接器
pipeline
字段已成功更新。 -
400
- 未提供
connector_id
或请求有效负载格式错误。 -
404
(缺少资源) - 找不到与
connector_id
匹配的连接器。
示例编辑
以下示例更新了 ID 为 my-connector
的连接器的 pipeline
属性
response = client.connector.update_pipeline( connector_id: 'my-connector', body: { pipeline: { extract_binary_content: true, name: 'my-connector-pipeline', reduce_whitespace: true, run_ml_inference: true } } ) puts response
PUT _connector/my-connector/_pipeline { "pipeline": { "extract_binary_content": true, "name": "my-connector-pipeline", "reduce_whitespace": true, "run_ml_inference": true } }
{ "result": "updated" }