获取数据馈送 API
编辑获取数据馈送 API编辑
检索数据馈送的配置信息。
请求编辑
GET _ml/datafeeds/<feed_id>
GET _ml/datafeeds/<feed_id>,<feed_id>
GET _ml/datafeeds/
GET _ml/datafeeds/_all
先决条件编辑
需要 monitor_ml
集群权限。此权限包含在 machine_learning_user
内置角色中。
描述编辑
此 API 最多返回 10,000 个数据馈送。
路径参数编辑
-
<feed_id>
-
(可选,字符串)数据馈送的标识符。它可以是数据馈送标识符或通配符表达式。
您可以通过使用逗号分隔的数据馈送列表或通配符表达式,在单个 API 请求中获取多个数据馈送的信息。您可以通过使用
_all
、指定*
作为数据馈送标识符或省略标识符来获取所有数据馈送的信息。
查询参数编辑
-
allow_no_match
-
(可选,布尔值)指定当请求
- 包含通配符表达式并且没有匹配的数据馈送时该怎么做。
- 包含
_all
字符串或没有标识符并且没有匹配项时该怎么做。 - 包含通配符表达式并且只有部分匹配项时该怎么做。
默认值为
true
,当没有匹配项时返回空的datafeeds
数组,当有部分匹配项时返回结果的子集。如果此参数为false
,则当没有匹配项或只有部分匹配项时,请求将返回404
状态代码。 -
exclude_generated
- (可选,布尔值)指示在检索时是否应从配置中删除某些字段。这允许配置采用可接受的格式进行检索,然后添加到另一个集群。默认值为 false。
响应正文编辑
API 返回一个数据馈送资源数组。有关属性的完整列表,请参阅 创建数据馈送 API。
响应代码编辑
-
404
(缺少资源) - 如果
allow_no_match
为false
,则此代码表示没有与请求匹配的资源,或者只有部分匹配请求的资源。
示例编辑
response = client.ml.get_datafeeds( datafeed_id: 'datafeed-high_sum_total_sales' ) puts response
GET _ml/datafeeds/datafeed-high_sum_total_sales
API 返回以下结果
{ "count" : 1, "datafeeds" : [ { "datafeed_id" : "datafeed-high_sum_total_sales", "job_id" : "high_sum_total_sales", "authorization" : { "roles" : [ "superuser" ] }, "query_delay" : "93169ms", "chunking_config" : { "mode" : "auto" }, "indices_options" : { "expand_wildcards" : [ "open" ], "ignore_unavailable" : false, "allow_no_indices" : true, "ignore_throttled" : true }, "query" : { "bool" : { "filter" : [ { "term" : { "event.dataset" : "sample_ecommerce" } } ] } }, "indices" : [ "kibana_sample_data_ecommerce" ], "scroll_size" : 1000, "delayed_data_check_config" : { "enabled" : true } } ] }