Path parameters
- job_id
string Required Identifier for the anomaly detection job. It can be a job identifier, a group name, a comma-separated list of jobs or groups, or a wildcard expression.
You can summarize the bucket results for all anomaly detection jobs by using
_all
or by specifying*
as the<job_id>
.
Query parameters
- allow_no_match
boolean Specifies what to do when the request:
- Contains wildcard expressions and there are no jobs that match.
- Contains the
_all
string or no identifiers and there are no matches. - Contains wildcard expressions and there are only partial matches.
If
true
, the request returns an emptyjobs
array when there are no matches and the subset of results when there are partial matches. If this parameter isfalse
, the request returns a404
status code when there are no matches or only partial matches. - bucket_span
string The span of the overall buckets. Must be greater or equal to the largest bucket span of the specified anomaly detection jobs, which is the default value.
By default, an overall bucket has a span equal to the largest bucket span of the specified anomaly detection jobs. To override that behavior, use the optional
bucket_span
parameter.Values are
-1
or0
. - end
string | number Returns overall buckets with timestamps earlier than this time.
- exclude_interim
boolean If
true
, the output excludes interim results. - overall_score
number | string Returns overall buckets with overall scores greater than or equal to this value.
- start
string | number Returns overall buckets with timestamps after this time.
- top_n
number The number of top anomaly detection job bucket scores to be used in the
overall_score
calculation.
Body
- allow_no_match
boolean Refer to the description for the
allow_no_match
query parameter. - bucket_span
string A duration. Units can be
nanos
,micros
,ms
(milliseconds),s
(seconds),m
(minutes),h
(hours) andd
(days). Also accepts "0" without a unit and "-1" to indicate an unspecified value. - exclude_interim
boolean Refer to the description for the
exclude_interim
query parameter. overall_score
number | string Refer to the description for the
overall_score
query parameter.- top_n
number Refer to the description for the
top_n
query parameter.
curl \
--request POST 'http://api.example.com/_ml/anomaly_detectors/{job_id}/results/overall_buckets' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--data '{"allow_no_match":true,"bucket_span":"string","":"string","exclude_interim":true,"overall_score":42.0,"top_n":42.0}'