elasticsearch-api 7.17.11 → 9.0.2

data/lib/elasticsearch/api/actions/machine_learning/put_trained_model_alias.rb

@@ -0,0 +1,83 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
+module Elasticsearch
+  module API
+    module MachineLearning
+      module Actions
+        # Create or update a trained model alias.
+        # A trained model alias is a logical name used to reference a single trained
+        # model.
+        # You can use aliases instead of trained model identifiers to make it easier to
+        # reference your models. For example, you can use aliases in inference
+        # aggregations and processors.
+        # An alias must be unique and refer to only a single trained model. However,
+        # you can have multiple aliases for each trained model.
+        # If you use this API to update an alias such that it references a different
+        # trained model ID and the model uses a different type of data frame analytics,
+        # an error occurs. For example, this situation occurs if you have a trained
+        # model for regression analysis and a trained model for classification
+        # analysis; you cannot reassign an alias from one type of trained model to
+        # another.
+        # If you use this API to update an alias and there are very few input fields in
+        # common between the old and new trained models for the model alias, the API
+        # returns a warning.
+        #
+        # @option arguments [String] :model_alias The alias to create or update. This value cannot end in numbers. (*Required*)
+        # @option arguments [String] :model_id The identifier for the trained model that the alias refers to. (*Required*)
+        # @option arguments [Boolean] :reassign Specifies whether the alias gets reassigned to the specified trained
+        #  model if it is already assigned to a different model. If the alias is
+        #  already assigned and this parameter is false, the API returns an error.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-trained-model-alias
+        #
+        def put_trained_model_alias(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'ml.put_trained_model_alias' }
+
+          defined_params = [:model_id, :model_alias].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'model_id' missing" unless arguments[:model_id]
+          raise ArgumentError, "Required argument 'model_alias' missing" unless arguments[:model_alias]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = nil
+
+          _model_alias = arguments.delete(:model_alias)
+
+          _model_id = arguments.delete(:model_id)
+
+          method = Elasticsearch::API::HTTP_PUT
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/model_aliases/#{Utils.listify(_model_alias)}"
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/machine_learning/put_trained_model_definition_part.rb

@@ -0,0 +1,67 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
+module Elasticsearch
+  module API
+    module MachineLearning
+      module Actions
+        # Create part of a trained model definition.
+        #
+        # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
+        # @option arguments [Integer] :part The definition part number. When the definition is loaded for inference the definition parts are streamed in the
+        #  order of their part number. The first part must be +0+ and the final part must be +total_parts - 1+. (*Required*)
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body request body
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-trained-model-definition-part
+        #
+        def put_trained_model_definition_part(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'ml.put_trained_model_definition_part' }
+
+          defined_params = [:model_id, :part].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+          raise ArgumentError, "Required argument 'model_id' missing" unless arguments[:model_id]
+          raise ArgumentError, "Required argument 'part' missing" unless arguments[:part]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
+          _model_id = arguments.delete(:model_id)
+
+          _part = arguments.delete(:part)
+
+          method = Elasticsearch::API::HTTP_PUT
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/definition/#{Utils.listify(_part)}"
+          params = {}
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/machine_learning/put_trained_model_vocabulary.rb

@@ -0,0 +1,64 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
+module Elasticsearch
+  module API
+    module MachineLearning
+      module Actions
+        # Create a trained model vocabulary.
+        # This API is supported only for natural language processing (NLP) models.
+        # The vocabulary is stored in the index as described in +inference_config.*.vocabulary+ of the trained model definition.
+        #
+        # @option arguments [String] :model_id The unique identifier of the trained model. (*Required*)
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body request body
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-put-trained-model-vocabulary
+        #
+        def put_trained_model_vocabulary(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'ml.put_trained_model_vocabulary' }
+
+          defined_params = [:model_id].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+          raise ArgumentError, "Required argument 'model_id' missing" unless arguments[:model_id]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
+          _model_id = arguments.delete(:model_id)
+
+          method = Elasticsearch::API::HTTP_PUT
+          path   = "_ml/trained_models/#{Utils.listify(_model_id)}/vocabulary"
+          params = {}
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/machine_learning/reset_job.rb

@@ -0,0 +1,69 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
+module Elasticsearch
+  module API
+    module MachineLearning
+      module Actions
+        # Reset an anomaly detection job.
+        # All model state and results are deleted. The job is ready to start over as if
+        # it had just been created.
+        # It is not currently possible to reset multiple jobs using wildcards or a
+        # comma separated list.
+        #
+        # @option arguments [String] :job_id The ID of the job to reset. (*Required*)
+        # @option arguments [Boolean] :wait_for_completion Should this request wait until the operation has completed before
+        #  returning. Server default: true.
+        # @option arguments [Boolean] :delete_user_annotations Specifies whether annotations that have been added by the
+        #  user should be deleted along with any auto-generated annotations when the job is
+        #  reset.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-reset-job
+        #
+        def reset_job(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'ml.reset_job' }
+
+          defined_params = [:job_id].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'job_id' missing" unless arguments[:job_id]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = nil
+
+          _job_id = arguments.delete(:job_id)
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/_reset"
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/machine_learning/revert_model_snapshot.rb

@@ -0,0 +1,80 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
+module Elasticsearch
+  module API
+    module MachineLearning
+      module Actions
+        # Revert to a snapshot.
+        # The machine learning features react quickly to anomalous input, learning new
+        # behaviors in data. Highly anomalous input increases the variance in the
+        # models whilst the system learns whether this is a new step-change in behavior
+        # or a one-off event. In the case where this anomalous input is known to be a
+        # one-off, then it might be appropriate to reset the model state to a time
+        # before this event. For example, you might consider reverting to a saved
+        # snapshot after Black Friday or a critical system failure.
+        #
+        # @option arguments [String] :job_id Identifier for the anomaly detection job. (*Required*)
+        # @option arguments [String] :snapshot_id You can specify +empty+ as the <snapshot_id>. Reverting to the empty
+        #  snapshot means the anomaly detection job starts learning a new model from
+        #  scratch when it is started. (*Required*)
+        # @option arguments [Boolean] :delete_intervening_results If true, deletes the results in the time period between the latest
+        #  results and the time of the reverted snapshot. It also resets the model
+        #  to accept records for this time period. If you choose not to delete
+        #  intervening results when reverting a snapshot, the job will not accept
+        #  input data that is older than the current time. If you want to resend
+        #  data, then delete the intervening results.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body request body
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-revert-model-snapshot
+        #
+        def revert_model_snapshot(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'ml.revert_model_snapshot' }
+
+          defined_params = [:job_id, :snapshot_id].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'job_id' missing" unless arguments[:job_id]
+          raise ArgumentError, "Required argument 'snapshot_id' missing" unless arguments[:snapshot_id]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
+          _job_id = arguments.delete(:job_id)
+
+          _snapshot_id = arguments.delete(:snapshot_id)
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = "_ml/anomaly_detectors/#{Utils.listify(_job_id)}/model_snapshots/#{Utils.listify(_snapshot_id)}/_revert"
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/machine_learning/set_upgrade_mode.rb

@@ -0,0 +1,66 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
+module Elasticsearch
+  module API
+    module MachineLearning
+      module Actions
+        # Set upgrade_mode for ML indices.
+        # Sets a cluster wide upgrade_mode setting that prepares machine learning
+        # indices for an upgrade.
+        # When upgrading your cluster, in some circumstances you must restart your
+        # nodes and reindex your machine learning indices. In those circumstances,
+        # there must be no machine learning jobs running. You can close the machine
+        # learning jobs, do the upgrade, then open all the jobs again. Alternatively,
+        # you can use this API to temporarily halt tasks associated with the jobs and
+        # datafeeds and prevent new jobs from opening. You can also use this API
+        # during upgrades that do not require you to reindex your machine learning
+        # indices, though stopping jobs is not a requirement in that case.
+        # You can see the current value for the upgrade_mode setting by using the get
+        # machine learning info API.
+        #
+        # @option arguments [Boolean] :enabled When +true+, it enables +upgrade_mode+ which temporarily halts all job
+        #  and datafeed tasks and prohibits new job and datafeed tasks from
+        #  starting.
+        # @option arguments [Time] :timeout The time to wait for the request to be completed. Server default: 30s.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-set-upgrade-mode
+        #
+        def set_upgrade_mode(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'ml.set_upgrade_mode' }
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = nil
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = '_ml/set_upgrade_mode'
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/machine_learning/start_data_frame_analytics.rb

@@ -0,0 +1,75 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
+module Elasticsearch
+  module API
+    module MachineLearning
+      module Actions
+        # Start a data frame analytics job.
+        # A data frame analytics job can be started and stopped multiple times
+        # throughout its lifecycle.
+        # If the destination index does not exist, it is created automatically the
+        # first time you start the data frame analytics job. The
+        # +index.number_of_shards+ and +index.number_of_replicas+ settings for the
+        # destination index are copied from the source index. If there are multiple
+        # source indices, the destination index copies the highest setting values. The
+        # mappings for the destination index are also copied from the source indices.
+        # If there are any mapping conflicts, the job fails to start.
+        # If the destination index exists, it is used as is. You can therefore set up
+        # the destination index in advance with custom settings and mappings.
+        #
+        # @option arguments [String] :id Identifier for the data frame analytics job. This identifier can contain
+        #  lowercase alphanumeric characters (a-z and 0-9), hyphens, and
+        #  underscores. It must start and end with alphanumeric characters. (*Required*)
+        # @option arguments [Time] :timeout Controls the amount of time to wait until the data frame analytics job
+        #  starts. Server default: 20s.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-start-data-frame-analytics
+        #
+        def start_data_frame_analytics(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'ml.start_data_frame_analytics' }
+
+          defined_params = [:id].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = nil
+
+          _id = arguments.delete(:id)
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = "_ml/data_frame/analytics/#{Utils.listify(_id)}/_start"
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/api/actions/machine_learning/start_datafeed.rb

@@ -0,0 +1,87 @@
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+#
+# This code was automatically generated from the Elasticsearch Specification
+# See https://github.com/elastic/elasticsearch-specification
+# See Elasticsearch::ES_SPECIFICATION_COMMIT for commit hash.
+module Elasticsearch
+  module API
+    module MachineLearning
+      module Actions
+        # Start datafeeds.
+        # A datafeed must be started in order to retrieve data from Elasticsearch. A datafeed can be started and stopped
+        # multiple times throughout its lifecycle.
+        # Before you can start a datafeed, the anomaly detection job must be open. Otherwise, an error occurs.
+        # If you restart a stopped datafeed, it continues processing input data from the next millisecond after it was stopped.
+        # If new data was indexed for that exact millisecond between stopping and starting, it will be ignored.
+        # When Elasticsearch security features are enabled, your datafeed remembers which roles the last user to create or
+        # update it had at the time of creation or update and runs the query using those same roles. If you provided secondary
+        # authorization headers when you created or updated the datafeed, those credentials are used instead.
+        #
+        # @option arguments [String] :datafeed_id A numerical character string that uniquely identifies the datafeed. This identifier can contain lowercase
+        #  alphanumeric characters (a-z and 0-9), hyphens, and underscores. It must start and end with alphanumeric
+        #  characters. (*Required*)
+        # @option arguments [String, Time] :end The time that the datafeed should end, which can be specified by using one of the following formats:
+        #  - ISO 8601 format with milliseconds, for example +2017-01-22T06:00:00.000Z+
+        #  - ISO 8601 format without milliseconds, for example +2017-01-22T06:00:00+00:00+
+        #  - Milliseconds since the epoch, for example +1485061200000+
+        #  Date-time arguments using either of the ISO 8601 formats must have a time zone designator, where +Z+ is accepted
+        #  as an abbreviation for UTC time. When a URL is expected (for example, in browsers), the +++ used in time zone
+        #  designators must be encoded as +%2B+.
+        #  The end time value is exclusive. If you do not specify an end time, the datafeed
+        #  runs continuously.
+        # @option arguments [String, Time] :start The time that the datafeed should begin, which can be specified by using the same formats as the +end+ parameter.
+        #  This value is inclusive.
+        #  If you do not specify a start time and the datafeed is associated with a new anomaly detection job, the analysis
+        #  starts from the earliest time for which data is available.
+        #  If you restart a stopped datafeed and specify a start value that is earlier than the timestamp of the latest
+        #  processed record, the datafeed continues from 1 millisecond after the timestamp of the latest processed record.
+        # @option arguments [Time] :timeout Specifies the amount of time to wait until a datafeed starts. Server default: 20s.
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body request body
+        #
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/v9/operation/operation-ml-start-datafeed
+        #
+        def start_datafeed(arguments = {})
+          request_opts = { endpoint: arguments[:endpoint] || 'ml.start_datafeed' }
+
+          defined_params = [:datafeed_id].each_with_object({}) do |variable, set_variables|
+            set_variables[variable] = arguments[variable] if arguments.key?(variable)
+          end
+          request_opts[:defined_params] = defined_params unless defined_params.empty?
+
+          raise ArgumentError, "Required argument 'datafeed_id' missing" unless arguments[:datafeed_id]
+
+          arguments = arguments.clone
+          headers = arguments.delete(:headers) || {}
+
+          body = arguments.delete(:body)
+
+          _datafeed_id = arguments.delete(:datafeed_id)
+
+          method = Elasticsearch::API::HTTP_POST
+          path   = "_ml/datafeeds/#{Utils.listify(_datafeed_id)}/_start"
+          params = Utils.process_params(arguments)
+
+          Elasticsearch::API::Response.new(
+            perform_request(method, path, params, body, headers, request_opts)
+          )
+        end
+      end
+    end
+  end
+end