elasticsearch/docs/reference/ml/anomaly-detection/apis/validate-detector.asciidoc
James Rodewig 07ac8818b6
[DOCS] Remove testenv annotations from doc snippet tests (#80023) (#80458)
Removes `testenv` annotations and related code. These annotations originally let you skip x-pack snippet tests in the docs. However, that's no longer possible.

Relates to #79309, #31619
# Conflicts:
#	docs/reference/ml/df-analytics/apis/get-trained-model-deployment-stats.asciidoc
#	docs/reference/ml/df-analytics/apis/infer-trained-model-deployment.asciidoc
#	docs/reference/ml/df-analytics/apis/put-trained-model-definition-part.asciidoc
#	docs/reference/ml/df-analytics/apis/put-trained-model-vocabulary.asciidoc
#	docs/reference/ml/df-analytics/apis/start-trained-model-deployment.asciidoc
#	docs/reference/ml/df-analytics/apis/stop-trained-model-deployment.asciidoc
#	docs/reference/slm/apis/slm-delete.asciidoc
#	docs/reference/slm/apis/slm-execute-retention.asciidoc
#	docs/reference/slm/apis/slm-execute.asciidoc
#	docs/reference/slm/apis/slm-get-status.asciidoc
#	docs/reference/slm/apis/slm-get.asciidoc
#	docs/reference/slm/apis/slm-start.asciidoc
#	docs/reference/slm/apis/slm-stats.asciidoc
#	docs/reference/slm/apis/slm-stop.asciidoc
#	docs/reference/sql/endpoints/client-apps/tableau-desktop.asciidoc
#	docs/reference/sql/endpoints/client-apps/tableau-server.asciidoc
2021-11-05 19:41:54 -04:00

56 lines
1.3 KiB
Text

[role="xpack"]
[[ml-valid-detector]]
= Validate detectors API
++++
<titleabbrev>Validate detectors</titleabbrev>
++++
Validates detector configuration information.
[[ml-valid-detector-request]]
== {api-request-title}
`POST _ml/anomaly_detectors/_validate/detector`
[[ml-valid-detector-prereqs]]
== {api-prereq-title}
Requires the `manage_ml` cluster privilege. This privilege is included in the
`machine_learning_admin` built-in role.
[[ml-valid-detector-desc]]
== {api-description-title}
This API enables you to validate the detector configuration
before you create an {anomaly-job}.
[[ml-valid-detector-request-body]]
== {api-request-body-title}
For a list of the properties that you can specify in the body of this API,
see detector configuration objects.
[[ml-valid-detector-example]]
== {api-examples-title}
The following example validates detector configuration information:
[source,console]
--------------------------------------------------
POST _ml/anomaly_detectors/_validate/detector
{
"function": "metric",
"field_name": "responsetime",
"by_field_name": "airline"
}
--------------------------------------------------
// TEST[skip:needs-licence]
When the validation completes, you receive the following results:
[source,console-result]
----
{
"acknowledged": true
}
----