获取数据馈送 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_matchfalse,则此代码表示没有与请求匹配的资源,或者只有部分匹配请求的资源。

示例编辑

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
      }
    }
  ]
}