启动数据馈送 API
编辑启动数据馈送 API编辑
启动一个或多个数据馈送。
请求编辑
POST _ml/datafeeds/<feed_id>/_start
先决条件编辑
- 在启动数据馈送之前，异常检测作业必须处于打开状态。否则，会发生错误。
- 需要
manage_ml集群权限。此权限包含在machine_learning_admin内置角色中。
描述编辑
必须启动数据馈送才能从 Elasticsearch 中检索数据。数据馈送可以在其生命周期中多次启动和停止。
如果重新启动已停止的数据馈送，默认情况下，它将从停止后下一毫秒开始继续处理输入数据。如果在停止和启动之间为该确切毫秒索引了新数据，则该数据将被忽略。
当启用 Elasticsearch 安全功能时，您的数据馈送会记住创建或更新它的最后一个用户在创建/更新时拥有的角色，并使用相同的角色运行查询。如果您在创建或更新数据馈送时提供了 辅助授权标头，则使用这些凭据。
路径参数编辑
-
<feed_id> - (必需，字符串) 唯一标识数据馈送的数字字符字符串。此标识符可以包含小写字母数字字符 (a-z 和 0-9)、连字符和下划线。它必须以字母数字字符开头和结尾。
查询参数编辑
-
end -
(可选，字符串) 数据馈送应结束的时间，可以使用以下格式之一指定
- 带毫秒的 ISO 8601 格式，例如
2017-01-22T06:00:00.000Z - 不带毫秒的 ISO 8601 格式，例如
2017-01-22T06:00:00+00:00 - 自纪元以来的毫秒数，例如
1485061200000
使用 ISO 8601 格式之一的日期时间参数必须具有时区指示符，其中
Z被接受为 UTC 时间的缩写。当需要 URL 时（例如，在浏览器中），时区指示符中使用的
+必须编码为%2B。此值是排他的。如果您没有指定结束时间，则数据馈送将持续运行。
- 带毫秒的 ISO 8601 格式，例如
-
start -
(可选，字符串) 数据馈送应开始的时间，可以使用与
end参数相同的格式指定。此值是包含的。如果您没有指定开始时间并且数据馈送与新的异常检测作业相关联，则分析将从可获得数据的最早时间开始。
如果您重新启动已停止的数据馈送并指定了一个早于最新处理记录的时间戳的
start值，则数据馈送将从最新处理记录的时间戳后的 1 毫秒开始继续。 -
timeout - (可选，时间) 指定等待数据馈送启动的时间量。默认值为 20 秒。
请求正文编辑
您也可以在请求正文中指定查询参数（例如 end 和 start）。
响应正文编辑
-
node - (字符串) 数据馈送启动所在的节点的 ID。如果允许数据馈送延迟打开并且尚未分配给节点，则此值为一个空字符串。
-
started - (布尔值) 对于成功的响应，此值始终为
true。如果失败，则返回异常。
示例编辑
POST _ml/datafeeds/datafeed-low_request_rate/_start
{
"start": "2019-04-07T18:22:16Z"
}
当数据馈送启动时，您将收到以下结果
{
"started" : true,
"node" : "node-1"
}