NAME
Search::Elasticsearch::Client::7_0::Direct::ML - Plugin providing ML API for Search::Elasticsearch 7.x
VERSION
version 8.12
SYNOPSIS
my $response = $es->ml->start_datafeed(...)
DESCRIPTION
This class extends the Search::Elasticsearch client with an ml
namespace, to support the Machine Learning APIs.
The full documentation for the ML feature is available here: https://www.elastic.co/guide/en/x-pack/7.0/xpack-ml.html
DATAFEED METHODS
put_datafeed()
$response = $es->ml->put_datafeed(
datafeed_id => $id # required
body => {...} # required
)
The put_datafeed()
method enables you to instantiate a datafeed.
See the put_datafeed docs for more information.
Query string parameters: error_trace
, human
delete_datafeed()
$response = $es->xpack->ml->delete_datafeed(
datafeed_id => $id # required
)
The delete_datafeed()
method enables you to delete a datafeed.
See the delete_datafeed docs for more information.
Query string parameters: error_trace
, force
, human
start_datafeed()
$response = $es->ml->start_datafeed(
datafeed_id => $id # required
)
The start_datafeed()
method enables you to start a datafeed.
See the start_datafeed docs for more information.
Query string parameters: end
, error_trace
, human
, start
, timeout
stop_datafeed()
$response = $es->ml->stop_datafeed(
datafeed_id => $id # required
)
The stop_datafeed()
method enables you to stop a datafeed.
See the stop_datafeed docs for more information.
Query string parameters: allow_no_datafeeds
, error_trace
, force
, human
, timeout
get_datafeeds()
$response = $es->ml->get_datafeeds(
datafeed_id => $id # optional
)
The get_datafeeds()
method enables you to retrieve configuration information for datafeeds.
See the get_datafeeds docs for more information.
Query string parameters: allow_no_datafeeds
, error_trace
, human
get_datafeed_stats()
$response = $es->ml->get_datafeed_stats(
datafeed_id => $id # optional
)
The get_datafeed_stats()
method enables you to retrieve configuration information for datafeeds.
See the get_datafeed_stats docs for more information.
Query string parameters: allow_no_datafeeds
, error_trace
, human
preview_datafeed()
$response = $es->ml->preview_datafeed(
datafeed_id => $id # required
)
The preview_datafeed()
method enables you to preview a datafeed.
See the preview_datafeed docs for more information.
Query string parameters: error_trace
, human
update_datafeed()
$response = $es->ml->update_datafeed(
datafeed_id => $id # required
body => {...} # required
)
The update_datafeed()
method enables you to update certain properties of a datafeed.
See the update_datafeed docs for more information.
Query string parameters: error_trace
, human
JOB METHODS
put_job()
$response = $es->ml->put_job(
job_id => $id # required
body => {...} # required
)
The put_job()
method enables you to instantiate a job.
See the put_job docs for more information.
Query string parameters: error_trace
, human
delete_job()
$response = $es->ml->delete_job(
job_id => $id # required
)
The delete_job()
method enables you to delete a job.
See the delete_job docs for more information.
Query string parameters: error_trace
, force
, human
, wait_for_completion
open_job()
$response = $es->ml->open_job(
job_id => $id # required
)
The open_job()
method enables you to open a closed job.
See the open_job docs for more information.
Query string parameters: error_trace
, human
close_job()
$response = $es->ml->close_job(
job_id => $id # required
)
The close_job()
method enables you to close an open job.
See the close_job docs for more information.
Query string parameters: allow_no_jobs
, error_trace
, force
, human
, timeout
get_jobs()
$response = $es->ml->get_jobs(
job_id => $id # optional
)
The get_jobs()
method enables you to retrieve configuration information for jobs.
See the get_jobs docs for more information.
Query string parameters: allow_no_jobs
, error_trace
, human
get_job_stats()
$response = $es->ml->get_jobs_stats(
job_id => $id # optional
)
The get_jobs_stats()
method enables you to retrieve usage information for jobs.
See the get_job_statss docs for more information.
Query string parameters: allow_no_jobs
, error_trace
, human
flush_job()
$response = $es->ml->flush_job(
job_id => $id # required
)
The flush_job()
method forces any buffered data to be processed by the job.
See the flush_job docs for more information.
Query string parameters: advance_time
, calc_interm
, end
, error_trace
, human
, skip_time
, start
post_data()
$response = $es->ml->post_data(
job_id => $id # required
body => [data] # required
)
The post_data()
method enables you to send data to an anomaly detection job for analysis.
See the post_data docs for more information.
Query string parameters: error_trace
, human
, reset_end
, reset_start
update_job()
$response = $es->ml->update_job(
job_id => $id # required
body => {...} # required
)
The update_job()
method enables you to update certain properties of a job.
See the update_job docs for more information.
Query string parameters: error_trace
, human
delete_expired_data
$response = $es->ml->delete_expired_data(
)
The delete_expired_data()
method deletes expired machine learning data.
See the delete_expired_data docs for more information.
Query string parameters: error_trace
, human
CALENDAR METHODS
put_calendar()
$response = $es->ml->put_calendar(
calendar_id => $id # required
body => {...} # optional
)
The put_calendar()
method creates a new calendar.
Query string parameters: error_trace
, human
See the put calendar docs for more information.
delete_calendar()
$response = $es->ml->delete_calendar(
calendar_id => $id # required
)
The delete_calendar()
method deletes the specified calendar
Query string parameters: error_trace
, human
See the delete_calendar docs for more information.
put_calendar_job()
$response = $es->ml->put_calendar_job(
calendar_id => $id, # required
job_id => $id # required
)
The put_calendar_job()
method adds a job to a calendar.
Query string parameters: error_trace
, human
See the put_calendar_job docs for more information.
delete_calendar_job()
$response = $es->ml->delete_calendar_job(
calendar_id => $id, # required
job_id => $id # required
)
The delete_calendar_job()
method deletes a job from a calendar.
Query string parameters: error_trace
, human
See the delete_calendar_job docs for more information.
put_calendar_event()
$response = $es->ml->post_calendar_events(
calendar_id => $id, # required
body => {...} # required
)
The post_calendar_events()
method adds scheduled events to a calendar.
Query string parameters: error_trace
, human
See the post_calendar_events docs for more information.
delete_calendar_event()
$response = $es->ml->delete_calendar_event(
calendar_id => $id, # required
event_id => $id # required
)
The delete_calendar_event()
method deletes an event from a calendar.
Query string parameters: error_trace
, human
See the delete_calendar_event docs for more information.
get_calendars()
$response = $es->ml->get_calendars(
calendar_id => $id, # optional
)
The get_calendars()
method returns the specified calendar or all calendars.
Query string parameters: error_trace
, from
, human
, size
See the get_calendars docs for more information.
get_calendar_events()
$response = $es->ml->get_calendar_events(
calendar_id => $id, # required
)
The get_calendar_events()
method retrieves events from a calendar.
Query string parameters: end
, error_trace
, from
, human
, job_id
, size
, start
See the get_calendar_events docs for more information.
FILTER METHODS
put_filter()
$response = $es->ml->put_filter(
filter_id => $id, # required
body => {...} # required
)
The put_filter()
method creates a named filter.
Query string parameters: error_trace
, human
See the put_filter docs for more information.
update_filter()
$response = $es->ml->update_filter(
filter_id => $id, # required
body => {...} # required
)
The update_filter()
method updates the description of a filter, adds items, or removes items.
Query string parameters: error_trace
, human
See the update_filter docs for more information.
get_filters()
$response = $es->ml->get_filters(
filter_id => $id, # optional
)
The get_filters()
method retrieves a named filter or all filters.
Query string parameters: error_trace
, from
, human
, size
See the get_filters docs for more information.
delete_filter()
$response = $es->ml->delete_filter(
filter_id => $id, # required
)
The delete_filter()
method deletes a named filter.
Query string parameters: error_trace
, human
See the delete_filters docs for more information.
FORECAST METHODS
forecast()
$response = $es->ml->forecast(
job_id => $id # required
)
The forecast()
method enables you to create a new forecast
See the forecast docs for more information.
Query string parameters: duration
, error_trace
, expires_in
, human
delete_forecast()
$response = $es->ml->delete_forecast(
forecast_id => $id, # required
job_id => $id # required
)
The delete_forecast()
method enables you to delete an existing forecast.
See the delete_forecast docs for more information.
Query string parameters: allow_no_forecasts
, error_trace
, human
, timeout
MODEL SNAPSHOT METHODS
delete_model_snapshot()
$response = $es->ml->delete_model_snapshot(
snapshot_id => $id # required
)
The delete_model_snapshot()
method enables you to delete an existing model snapshot.
See the delete_model_snapshot docs for more information.
Query string parameters: error_trace
, human
get_model_snapshots()
$response = $es->ml->get_model_snapshots(
job_id => $job_id, # required
snapshot_id => $snapshot_id # optional
)
The get_model_snapshots()
method enables you to retrieve information about model snapshots.
See the get_model_snapshots docs for more information.
Query string parameters: desc
, end
, error_trace
, from
, human
, size
, sort
, start
revert_model_snapshot()
$response = $es->ml->revert_model_snapshot(
job_id => $job_id, # required
snapshot_id => $snapshot_id # required
)
The revert_model_snapshots()
method enables you to revert to a specific snapshot.
See the revert_model_snapshot docs for more information.
Query string parameters: delete_intervening_results
, error_trace
, human
update_model_snapshot()
$response = $es->ml->update_model_snapshot(
job_id => $job_id, # required
snapshot_id => $snapshot_id # required
)
The update_model_snapshots()
method enables you to update certain properties of a snapshot.
See the update_model_snapshot docs for more information.
Query string parameters: error_trace
, human
RESULT METHODS
get_buckets()
$response = $es->ml->get_buckets(
job_id => $job_id, # required
timestamp => $timestamp # optional
)
The get_buckets()
method enables you to retrieve job results for one or more buckets.
See the get_buckets docs for more information.
Query string parameters: anomaly_score
, desc
, end
, error_trace
, exclude_interim
, expand
, from
, human
, size
, sort
, start
get_overall_buckets()
$response = $es->ml->get_overall_buckets(
job_id => $job_id, # required
)
The get_overall_buckets()
method retrieves overall bucket results that summarize the bucket results of multiple jobs.
See the get_overall_buckets docs for more information.
Query string parameters: allow_no_jobs
, bucket_span
, end
, error_trace
, exclude_interim
, human
, overall_score
, start
, top_n
get_categories()
$response = $es->ml->get_categories(
job_id => $job_id, # required
category_id => $category_id # optional
)
The get_categories()
method enables you to retrieve job results for one or more categories.
See the get_categories docs for more information.
Query string parameters: error_trace
, from
, human
, size
get_influencers()
$response = $es->ml->get_influencers(
job_id => $job_id, # required
)
The get_influencers()
method enables you to retrieve job results for one or more influencers.
See the get_influencers docs for more information.
Query string parameters: desc
, end
, error_trace
, exclude_interim
, expand
, from
, human
, influencer_score
, size
, sort
, start
get_records()
$response = $es->ml->get_records(
job_id => $job_id, # required
)
The get_records()
method enables you to retrieve anomaly records for a job.
See the get_records docs for more information.
Query string parameters: desc
, end
, error_trace
, exclude_interim
, expand
, from
, human
, record_score
, size
, sort
, start
FILE STRUCTURE METHODS
find_file_structure
$response = $es->ml->find_file_structure(
body => { ... }, # required
)
The find_file_structure()
method finds the structure of a text file which contains data that is suitable to be ingested into Elasticsearch.
See the find_file_structure docs for more information.
Query string parameters: charset
, column_names
, delimiter
, error_trace
, explain
, format
, grok_pattern
, has_header_row
, human
, lines_to_sample
, quote
, should_trim_fields
, timeout
, timestamp_field
, timestamp_format
INFO METHODS
info
$response = $es->ml->info();
The info()
method returns defaults and limits used by machine learning.
See the find_file_structure docs for more information.
Query string parameters: error_trace
, human
UPGRADE METHODS
set_upgrade_mode
$response = $es->ml->set_upgrade_mode();
The set_upgrade_mode()
method sets a cluster wide upgrade_mode
setting that prepares machine learning indices for an upgrade.
See the set_upgrade_mode docs for more information.
Query string parameters: enabled
, error_trace
, human
, timeout
AUTHOR
Enrico Zimuel <enrico.zimuel@elastic.co>
COPYRIGHT AND LICENSE
This software is Copyright (c) 2024 by Elasticsearch BV.
This is free software, licensed under:
The Apache License, Version 2.0, January 2004