elasticsearch-xpack 7.13.3 → 7.14.1

data/lib/elasticsearch/xpack/api/actions/terms_enum.rb

@@ -0,0 +1,58 @@
+# 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.
+
+module Elasticsearch
+  module XPack
+    module API
+      module Actions
+        # The terms enum API  can be used to discover terms in the index that begin with the provided string. It is designed for low-latency look-ups used in auto-complete scenarios.
+        # This functionality is in Beta and is subject to change. The design and
+        # code is less mature than official GA features and is being provided
+        # as-is with no warranties. Beta features are not subject to the support
+        # SLA of official GA features.
+        #
+        # @option arguments [List] :index A comma-separated list of index names to search; use `_all` or empty string to perform the operation on all indices
+        # @option arguments [Hash] :headers Custom HTTP headers
+        # @option arguments [Hash] :body field name, string which is the prefix expected in matching terms, timeout and size for max number of results
+        #
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/search-terms-enum.html
+        #
+        def terms_enum(arguments = {})
+          raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
+
+          headers = arguments.delete(:headers) || {}
+
+          arguments = arguments.clone
+
+          _index = arguments.delete(:index)
+
+          method = if arguments[:body]
+                     Elasticsearch::API::HTTP_POST
+                   else
+                     Elasticsearch::API::HTTP_GET
+                   end
+
+          path = "#{Elasticsearch::API::Utils.__listify(_index)}/_terms_enum"
+          params = {}
+
+          body = arguments[:body]
+          perform_request(method, path, params, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/xpack/api/actions/text_structure/find_structure.rb

@@ -39,7 +39,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body The contents of the file to be analyzed (*Required*)
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/find-structure.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/find-structure.html
           #
           def find_structure(arguments = {})
             raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]

data/lib/elasticsearch/xpack/api/actions/transform/delete_transform.rb

@@ -26,7 +26,7 @@ module Elasticsearch
           # @option arguments [Boolean] :force When `true`, the transform is deleted regardless of its current state. The default value is `false`, meaning that the transform must be `stopped` before it can be deleted.
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/delete-transform.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/delete-transform.html
           #
           def delete_transform(arguments = {})
             raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]

data/lib/elasticsearch/xpack/api/actions/transform/get_transform.rb

@@ -29,7 +29,7 @@ module Elasticsearch
           # @option arguments [Boolean] :exclude_generated Omits fields that are illegal to set on transform PUT
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/get-transform.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/get-transform.html
           #
           def get_transform(arguments = {})
             headers = arguments.delete(:headers) || {}

data/lib/elasticsearch/xpack/api/actions/transform/get_transform_stats.rb

@@ -28,7 +28,7 @@ module Elasticsearch
           # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no transforms. (This includes `_all` string or when no transforms have been specified)
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/get-transform-stats.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/get-transform-stats.html
           #
           def get_transform_stats(arguments = {})
             raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]

data/lib/elasticsearch/xpack/api/actions/transform/preview_transform.rb

@@ -25,7 +25,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body The definition for the transform to preview (*Required*)
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/preview-transform.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/preview-transform.html
           #
           def preview_transform(arguments = {})
             raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]

data/lib/elasticsearch/xpack/api/actions/transform/put_transform.rb

@@ -27,7 +27,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body The transform definition (*Required*)
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/put-transform.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/put-transform.html
           #
           def put_transform(arguments = {})
             raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]

data/lib/elasticsearch/xpack/api/actions/transform/start_transform.rb

@@ -26,7 +26,7 @@ module Elasticsearch
           # @option arguments [Time] :timeout Controls the time to wait for the transform to start
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/start-transform.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/start-transform.html
           #
           def start_transform(arguments = {})
             raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]

data/lib/elasticsearch/xpack/api/actions/transform/stop_transform.rb

@@ -30,7 +30,7 @@ module Elasticsearch
           # @option arguments [Boolean] :wait_for_checkpoint Whether to wait for the transform to reach a checkpoint before stopping. Default to false
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/stop-transform.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/stop-transform.html
           #
           def stop_transform(arguments = {})
             raise ArgumentError, "Required argument 'transform_id' missing" unless arguments[:transform_id]

data/lib/elasticsearch/xpack/api/actions/transform/update_transform.rb

@@ -27,7 +27,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body The update transform definition (*Required*)
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/update-transform.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/update-transform.html
           #
           def update_transform(arguments = {})
             raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]

data/lib/elasticsearch/xpack/api/actions/usage.rb

@@ -24,7 +24,7 @@ module Elasticsearch
         # @option arguments [Time] :master_timeout Specify timeout for watch write operation
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/usage-api.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/usage-api.html
         #
         def usage(arguments = {})
           headers = arguments.delete(:headers) || {}

data/lib/elasticsearch/xpack/api/actions/watcher/ack_watch.rb

@@ -26,7 +26,7 @@ module Elasticsearch
           # @option arguments [List] :action_id A comma-separated list of the action ids to be acked
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-ack-watch.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-ack-watch.html
           #
           def ack_watch(arguments = {})
             raise ArgumentError, "Required argument 'watch_id' missing" unless arguments[:watch_id]

data/lib/elasticsearch/xpack/api/actions/watcher/activate_watch.rb

@@ -25,7 +25,7 @@ module Elasticsearch
           # @option arguments [String] :watch_id Watch ID
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-activate-watch.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-activate-watch.html
           #
           def activate_watch(arguments = {})
             raise ArgumentError, "Required argument 'watch_id' missing" unless arguments[:watch_id]

data/lib/elasticsearch/xpack/api/actions/watcher/deactivate_watch.rb

@@ -25,7 +25,7 @@ module Elasticsearch
           # @option arguments [String] :watch_id Watch ID
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-deactivate-watch.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-deactivate-watch.html
           #
           def deactivate_watch(arguments = {})
             raise ArgumentError, "Required argument 'watch_id' missing" unless arguments[:watch_id]

data/lib/elasticsearch/xpack/api/actions/watcher/delete_watch.rb

@@ -25,7 +25,7 @@ module Elasticsearch
           # @option arguments [String] :id Watch ID
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-delete-watch.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-delete-watch.html
           #
           def delete_watch(arguments = {})
             raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
@@ -42,7 +42,9 @@ module Elasticsearch
 
             body = nil
             if Array(arguments[:ignore]).include?(404)
-              Elasticsearch::API::Utils.__rescue_from_not_found { perform_request(method, path, params, body, headers).body }
+              Elasticsearch::API::Utils.__rescue_from_not_found {
+                perform_request(method, path, params, body, headers).body
+              }
             else
               perform_request(method, path, params, body, headers).body
             end

data/lib/elasticsearch/xpack/api/actions/watcher/execute_watch.rb

@@ -27,7 +27,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body Execution control
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-execute-watch.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-execute-watch.html
           #
           def execute_watch(arguments = {})
             headers = arguments.delete(:headers) || {}

data/lib/elasticsearch/xpack/api/actions/watcher/get_watch.rb

@@ -25,7 +25,7 @@ module Elasticsearch
           # @option arguments [String] :id Watch ID
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-get-watch.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-get-watch.html
           #
           def get_watch(arguments = {})
             raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]

data/lib/elasticsearch/xpack/api/actions/watcher/put_watch.rb

@@ -30,7 +30,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body The watch
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-put-watch.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-put-watch.html
           #
           def put_watch(arguments = {})
             raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]

data/lib/elasticsearch/xpack/api/actions/watcher/query_watches.rb

@@ -25,7 +25,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body From, size, query, sort and search_after
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-query-watches.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-query-watches.html
           #
           def query_watches(arguments = {})
             headers = arguments.delete(:headers) || {}

data/lib/elasticsearch/xpack/api/actions/watcher/start.rb

@@ -24,7 +24,7 @@ module Elasticsearch
           #
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-start.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-start.html
           #
           def start(arguments = {})
             headers = arguments.delete(:headers) || {}

data/lib/elasticsearch/xpack/api/actions/watcher/stats.rb

@@ -26,7 +26,7 @@ module Elasticsearch
           # @option arguments [Boolean] :emit_stacktraces Emits stack traces of currently running watches
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-stats.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-stats.html
           #
           def stats(arguments = {})
             headers = arguments.delete(:headers) || {}

data/lib/elasticsearch/xpack/api/actions/watcher/stop.rb

@@ -24,7 +24,7 @@ module Elasticsearch
           #
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.13/watcher-api-stop.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.14/watcher-api-stop.html
           #
           def stop(arguments = {})
             headers = arguments.delete(:headers) || {}

data/lib/elasticsearch/xpack/api/namespace/index_lifecycle_management.rb

@@ -28,7 +28,6 @@ module Elasticsearch
         def ilm
           @ilm ||= IndexLifecycleManagementClient.new(self)
         end
-
       end
     end
   end

data/lib/elasticsearch/xpack/version.rb

@@ -17,6 +17,6 @@
 
 module Elasticsearch
   module XPack
-    VERSION = '7.13.3'.freeze
+    VERSION = '7.14.1'.freeze
   end
 end

data/lib/elasticsearch/xpack.rb

@@ -43,125 +43,127 @@ end
 Elasticsearch::API::COMMON_PARAMS.push :job_id, :datafeed_id, :filter_id, :snapshot_id, :category_id, :policy_id
 
 module Elasticsearch
-  module Transport
-    class Client
-      # When a method is called on the client, if it's one of the xpack root
-      # namespace methods, send them to the xpack client.
-      # E.g.: client.xpack.usage => client.usage
-      # Excluding `info` since OSS and XPACK both have info endpoints.
-      TOP_LEVEL_METHODS = [
-        :usage
-      ].freeze
-
-      def method_missing(method, *args, &block)
-        return xpack.send(method, *args, &block) if TOP_LEVEL_METHODS.include?(method)
-
-        super
-      end
-
-      def respond_to_missing?(method_name, *args)
-        TOP_LEVEL_METHODS.include?(method_name) || super
+  class Client
+    # When a method is called on the client, if it's one of the xpack root
+    # namespace methods, send them to the xpack client.
+    # E.g.: client.xpack.usage => client.usage
+    # Excluding `info` since OSS and XPACK both have info endpoints.
+    TOP_LEVEL_METHODS = [
+      :usage,
+      :terms_enum
+    ].freeze
+
+    TOP_LEVEL_METHODS.each do |method_name|
+      define_method method_name do |attr|
+        xpack.send(method_name, attr)
       end
+    end
 
-      def xpack
-        @xpack ||= Elasticsearch::XPack::API::Client.new(self)
+    def xpack
+      unless @xpack
+        warn(
+          'Deprecation notice: The elasticsearch-xpack gem will be deprecated and all the ' \
+          "functionality will be available from elasticsearch-api.\n" \
+          'See https://github.com/elastic/elasticsearch-ruby/issues/1274'
+        )
       end
+      @xpack ||= Elasticsearch::XPack::API::Client.new(self)
+    end
 
-      def security
-        @security ||= xpack.security
-      end
+    def security
+      @security ||= xpack.security
+    end
 
-      def ml
-        @ml ||= xpack.ml
-      end
+    def ml
+      @ml ||= xpack.ml
+    end
 
-      def rollup
-        @rollup ||= xpack.rollup
-      end
+    def rollup
+      @rollup ||= xpack.rollup
+    end
 
-      def watcher
-        @watcher ||= xpack.watcher
-      end
+    def watcher
+      @watcher ||= xpack.watcher
+    end
 
-      def graph
-        @graph ||= xpack.graph
-      end
+    def graph
+      @graph ||= xpack.graph
+    end
 
-      def migration
-        @migration ||= xpack.migration
-      end
+    def migration
+      @migration ||= xpack.migration
+    end
 
-      def sql
-        @sql ||= xpack.sql
-      end
+    def sql
+      @sql ||= xpack.sql
+    end
 
-      def deprecation
-        @deprecation ||= xpack.deprecation
-      end
+    def deprecation
+      @deprecation ||= xpack.deprecation
+    end
 
-      def data_frame
-        @data_frame ||= xpack.data_frame
-      end
+    def data_frame
+      @data_frame ||= xpack.data_frame
+    end
 
-      def ilm
-        @ilm ||= xpack.ilm
-      end
+    def ilm
+      @ilm ||= xpack.ilm
+    end
 
-      def license
-        @license ||= xpack.license
-      end
+    def license
+      @license ||= xpack.license
+    end
 
-      def transform
-        @transform ||= xpack.transform
-      end
+    def transform
+      @transform ||= xpack.transform
+    end
 
-      def async_search
-        @async_search ||= xpack.async_search
-      end
+    def async_search
+      @async_search ||= xpack.async_search
+    end
 
-      def cat
-        @cat ||= xpack.cat
-      end
+    def cat
+      @cat ||= xpack.cat
+    end
 
-      def indices
-        @indices ||= xpack.indices
-      end
+    def indices
+      @indices ||= xpack.indices
+    end
 
-      def searchable_snapshots
-        @searchable_snapshots ||= xpack.searchable_snapshots
-      end
+    def searchable_snapshots
+      @searchable_snapshots ||= xpack.searchable_snapshots
+    end
 
-      def cross_cluster_replication
-        @cross_cluster_replication ||= xpack.cross_cluster_replication
-      end
+    def cross_cluster_replication
+      @cross_cluster_replication ||= xpack.cross_cluster_replication
+    end
 
-      def autoscaling
-        @autoscaling ||= xpack.autoscaling
-      end
+    def autoscaling
+      @autoscaling ||= xpack.autoscaling
+    end
 
-      def enrich
-        @enrich ||= xpack.enrich
-      end
+    def enrich
+      @enrich ||= xpack.enrich
+    end
 
-      def eql
-        @eql ||= xpack.eql
-      end
+    def eql
+      @eql ||= xpack.eql
+    end
 
-      def snapshot_lifecycle_management
-        @snapshot_lifecycle_management ||= xpack.snapshot_lifecycle_management
-      end
+    def snapshot_lifecycle_management
+      @snapshot_lifecycle_management ||= xpack.snapshot_lifecycle_management
+    end
 
-      def text_structure
-        @text_structure ||= xpack.text_structure
-      end
+    def text_structure
+      @text_structure ||= xpack.text_structure
+    end
 
-      def logstash
-        @logstash ||= xpack.logstash
-      end
+    def logstash
+      @logstash ||= xpack.logstash
+    end
 
-      def fleet
-        @fleet ||= xpack.fleet
-      end
+    def fleet
+      @fleet ||= xpack.fleet
     end
   end
-end if defined?(Elasticsearch::Transport::Client)
+end if defined?(Elasticsearch::Client)