OpenSearch/docs/en/rest-api/ml/get-datafeed.asciidoc

[role="xpack"]
[[ml-get-datafeed]]
=== Get {dfeeds-cap}

The get {dfeeds} API enables you to retrieve configuration information for
{dfeeds}.

==== Request

`GET _xpack/ml/datafeeds/` +

`GET _xpack/ml/datafeeds/<feed_id>`

//===== Description

==== Path Parameters

`feed_id`::
  (string) Identifier for the {dfeed}.
  This parameter does not support wildcards, but you can specify `_all` or
  omit the `feed_id` to get information about all {dfeeds}.


==== Results

The API returns the following information:

`datafeeds`::
  (array) An array of {dfeed} objects.
  For more information, see <<ml-datafeed-resource>>.


==== Authorization

You must have `monitor_ml`, `monitor`, `manage_ml`, or `manage` cluster
privileges to use this API. For more information, see
{xpack-ref}/security-privileges.html[Security Privileges].
//<<privileges-list-cluster>>.


==== Examples

The following example gets configuration information for the
`datafeed-it-ops-kpi` {dfeed}:

[source,js]
--------------------------------------------------
GET _xpack/ml/datafeeds/datafeed-it-ops-kpi
--------------------------------------------------
// CONSOLE
// TEST[skip:todo]

The API returns the following results:
[source,js]
----
{
  "count": 1,
  "datafeeds": [
    {
      "datafeed_id": "datafeed-it-ops-kpi",
      "job_id": "it-ops-kpi",
      "query_delay": "60s",
      "frequency": "150s",
      "indexes": [
        "it_ops_metrics"
      ],
      "types": [
        "kpi",
        "network",
        "sql"
      ],
      "query": {
        "match_all": {
          "boost": 1
        }
      },
      "aggregations": {
        "buckets": {
          "date_histogram": {
            "field": "@timestamp",
            "interval": 30000,
            "offset": 0,
            "order": {
              "_key": "asc"
            },
            "keyed": false,
            "min_doc_count": 0
          },
          "aggregations": {
            "events_per_min": {
              "sum": {
                "field": "events_per_min"
              }
            },
            "@timestamp": {
              "max": {
                "field": "@timestamp"
              }
            }
          }
        }
      },
      "scroll_size": 1000,
      "chunking_config": {
        "mode": "manual",
        "time_span": "30000000ms"
      }
    }
  ]
}
----