[XPACK] Add update_data_frame_transform

Author: estolfo

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/data_frame/update_data_frame_transform.rb

@@ -0,0 +1,45 @@
+# Licensed to Elasticsearch B.V under one or more agreements.
+# Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+# See the LICENSE file in the project root for more information
+
+module Elasticsearch
+  module XPack
+    module API
+      module DataFrame
+        module Actions
+
+          # Updates an existing data frame transform.
+          #
+          # @option arguments [Hash] :transform_id The id of the new transform. *Required*
+          # @option arguments [Hash] :body The update data frame transform definition. *Required*
+          # @option arguments [Boolean] :defer_validation If validations should be deferred until data frame
+          #   transform starts, defaults to false.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/update-data-frame-transform.html
+          #
+          # @since 7.4.0
+          def update_data_frame_transform(arguments={})
+            raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+            raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]
+            arguments = arguments.clone
+
+            transform_id = URI.escape(arguments.delete(:transform_id))
+            body = arguments.delete(:body)
+
+            method = Elasticsearch::API::HTTP_POST
+            path   = "_data_frame/transforms/#{transform_id}/_update"
+            params = Elasticsearch::API::Utils.__validate_and_extract_params(arguments, ParamsRegistry.get(__method__))
+
+            perform_request(method, path, params, body).body
+          end
+
+
+          # Register this action with its valid params when the module is loaded.
+          #
+          # @since 7.4.0
+          ParamsRegistry.register(:update_data_frame_transform, [ :defer_validation ].freeze)
+        end
+      end
+    end
+  end
+end

elasticsearch-xpack/spec/xpack/data_frame/update_data_frame_transform_spec.rb

@@ -0,0 +1,65 @@
+# Licensed to Elasticsearch B.V under one or more agreements.
+# Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+# See the LICENSE file in the project root for more information
+
+require 'spec_helper'
+
+describe 'client#update_data_frame_transform' do
+
+  let(:expected_args) do
+    [
+        'POST',
+        '_data_frame/transforms/foo/_update',
+        params,
+        {},
+        nil
+    ]
+  end
+
+  let(:params) do
+    {}
+  end
+
+  it 'performs the request' do
+    expect(client_double.data_frame.
+        update_data_frame_transform(transform_id: 'foo', body: {})).to eq({})
+  end
+
+  context 'when body is not provided' do
+
+    let(:client) do
+      Class.new { include Elasticsearch::XPack::API }.new
+    end
+
+    it 'raises an exception' do
+      expect {
+        client.data_frame.update_data_frame_transform(transform_id: 'foo')
+      }.to raise_exception(ArgumentError)
+    end
+  end
+
+  context 'when a transform_id is not provided' do
+
+    let(:client) do
+      Class.new { include Elasticsearch::XPack::API }.new
+    end
+
+    it 'raises an exception' do
+      expect {
+        client.data_frame.update_data_frame_transform(body: {})
+      }.to raise_exception(ArgumentError)
+    end
+  end
+
+  context 'when params are specified' do
+
+    let(:params) do
+      { defer_validation: true }
+    end
+
+    it 'performs the request' do
+      expect(client_double.data_frame.
+          update_data_frame_transform(transform_id: 'foo', body: {}, defer_validation: true)).to eq({})
+    end
+  end
+end