原文地址: https://www.elastic.co/guide/en/elasticsearch/reference/7.7/ml-put-filter.html, 原文档版权归 www.elastic.co 所有
IMPORTANT: No additional bug fixes or documentation updates
will be released for this version. For the latest information, see the
current release documentation.
Create filter APIedit
Instantiates a filter.
Requestedit
PUT _ml/filters/<filter_id>
Prerequisitesedit
-
If the Elasticsearch security features are enabled, you must have
manage_mlormanagecluster privileges to use this API. See Security privileges.
Descriptionedit
A filter contains a list of strings.
It can be used by one or more jobs. Specifically, filters are referenced in
the custom_rules property of detector configuration objects.
Path parametersedit
-
<filter_id> - (Required, string) A string that uniquely identifies a filter.
Request bodyedit
-
description - (Optional, string) A description of the filter.
-
items -
(Required, array of strings) The items of the filter. A wildcard
*can be used at the beginning or the end of an item. Up to 10000 items are allowed in each filter.
Examplesedit
PUT _ml/filters/safe_domains
{
"description": "A list of safe domains",
"items": ["*.google.com", "wikipedia.org"]
}
When the filter is created, you receive the following response:
{
"filter_id": "safe_domains",
"description": "A list of safe domains",
"items": ["*.google.com", "wikipedia.org"]
}