Get filters API

edit

Get filters API

edit

Retrieves filters.

Request

edit

GET _ml/filters/<filter_id>

GET _ml/filters/

Prerequisites

edit

Requires the manage_ml cluster privilege. This privilege is included in the machine_learning_admin built-in role.

Description

edit

You can get a single filter or all filters. For more information, see Machine learning custom rules.

Path parameters

edit

<filter_id>: (Optional, string) A string that uniquely identifies a filter.

Query parameters

edit

from: (Optional, integer) Skips the specified number of filters. Defaults to 0.
size: (Optional, integer) Specifies the maximum number of filters to obtain. Defaults to 100.

Response body

edit

The API returns an array of filter resources, which have the following properties:

description: (string) A description of the filter.
filter_id: (string) A string that uniquely identifies a filter.
items: (array of strings) An array of strings which is the filter item list.

Examples

edit

GET _ml/filters/safe_domains

The API returns the following results:

{
  "count": 1,
  "filters": [
    {
      "filter_id": "safe_domains",
      "description": "A list of safe domains",
      "items": [
        "*.google.com",
        "wikipedia.org"
      ]
    }
  ]
}

« Get scheduled events API Get records API »