Update filters APIedit
Updates the description of a filter, adds items, or removes items.
Requestedit
POST _ml/filters/<filter_id>/_update
Prerequisitesedit
Requires the manage_ml
cluster privilege. This privilege is included in the
machine_learning_admin
built-in role.
Path parametersedit
-
<filter_id>
- (Required, string) A string that uniquely identifies a filter.
Request bodyedit
-
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.
Examplesedit
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
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"] }