› › ›

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_datafeeds

(Необязательно, логическое значение) [7.10] Устарело в версии 7.10. Используйте allow_no_match вместо этого.

allow_no_match

(Необязательно, логическое значение) Указывает, что делать при запросе:

Содержит выражения с подстановкой, и нет каналов данных, которые соответствуют им.
Содержит строку _all или нет идентификаторов, и нет совпадений.
Содержит выражения с подстановкой, и есть только частичные совпадения.

Значение по умолчанию — true, которое возвращает пустой массив datafeeds, когда нет совпадений, и подмножество результатов, когда есть частичные совпадения. Если этот параметр равен false, запрос возвращает код состояния 404, если нет совпадений или только частичные совпадения.

exclude_generated

(Необязательно, логическое значение) Указывает, нужно ли удалять определённые поля из конфигурации при получении. Это позволяет получить конфигурацию в формате, подходящем для получения и добавления в другой кластер. По умолчанию значение false.

Тело ответа

API возвращает массив ресурсов канала данных. Полный список свойств см. в API создания каналов данных.

Коды ответов

404 (Отсутствующие ресурсы): Если allow_no_match равно false, этот код указывает, что нет ресурсов, соответствующих запросу, или есть только частичные совпадения с запросом.

Примеры

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",
      "query_delay": "93169ms",
      "indices": [
        "kibana_sample_data_ecommerce"
      ],
      "query" : {
        "bool" : {
          "filter" : [
            {
              "term" : {
                "_index" : "kibana_sample_data_ecommerce"
              }
            }
          ]
        }
      },
      "scroll_size": 1000,
      "chunking_config": {
        "mode": "auto"
      },
      "delayed_data_check_config" : {
        "enabled" : true
      }
    }
  ]
}

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/7.17/ml-get-datafeed.html