IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.

« Update datafeeds API Update anomaly detection jobs API »

› › ›

Update filters API

edit

IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Update filters API

edit

Updates the description of a filter, adds items, or removes items.

Request

edit

POST _ml/filters/<filter_id>/_update

Prerequisites

edit

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

Path parameters

edit

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

Request body

edit

add_items: (Optional, array of strings) The items to add to the filter.
description: (Optional, string) A description for the filter.
remove_items: (Optional, array of strings) The items to remove from the filter.

Examples

edit

resp = client.ml.update_filter(
    filter_id="safe_domains",
    description="Updated list of domains",
    add_items=[
        "*.myorg.com"
    ],
    remove_items=[
        "wikipedia.org"
    ],
)
print(resp)

response = client.ml.update_filter(
  filter_id: 'safe_domains',
  body: {
    description: 'Updated list of domains',
    add_items: [
      '*.myorg.com'
    ],
    remove_items: [
      'wikipedia.org'
    ]
  }
)
puts response

const response = await client.ml.updateFilter({
  filter_id: "safe_domains",
  description: "Updated list of domains",
  add_items: ["*.myorg.com"],
  remove_items: ["wikipedia.org"],
});
console.log(response);

POST _ml/filters/safe_domains/_update
{
  "description": "Updated list of domains",
  "add_items": ["*.myorg.com"],
  "remove_items": ["wikipedia.org"]
}

The API returns the following results:

{
  "filter_id": "safe_domains",
  "description": "Updated list of domains",
  "items": ["*.google.com", "*.myorg.com"]
}

« Update datafeeds API Update anomaly detection jobs API »