elasticsearch-api 7.3.0 → 7.5.0

data/lib/elasticsearch/api/actions/ingest/delete_pipeline.rb

@@ -6,32 +6,38 @@ module Elasticsearch
   module API
     module Ingest
       module Actions
-
-        # Delete a speficied pipeline
+        # Deletes a pipeline.
         #
-        # @option arguments [String] :id Pipeline ID (*Required*)
+        # @option arguments [String] :id Pipeline ID
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
         # @option arguments [Time] :timeout Explicit operation timeout
+
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/plugins/master/ingest.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/delete-pipeline-api.html
         #
-        def delete_pipeline(arguments={})
+        def delete_pipeline(arguments = {})
           raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
-          method = 'DELETE'
-          path   = Utils.__pathify "_ingest/pipeline", Utils.__escape(arguments[:id])
+
+          arguments = arguments.clone
+
+          _id = arguments.delete(:id)
+
+          method = Elasticsearch::API::HTTP_DELETE
+          path   = "_ingest/pipeline/#{Utils.__listify(_id)}"
           params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-          body   = nil
 
+          body = nil
           perform_request(method, path, params, body).body
         end
 
         # Register this action with its valid params when the module is loaded.
         #
-        # @since 6.1.1
+        # @since 6.2.0
         ParamsRegistry.register(:delete_pipeline, [
-            :master_timeout,
-            :timeout ].freeze)
+          :master_timeout,
+          :timeout
+        ].freeze)
+end
       end
-    end
   end
 end

data/lib/elasticsearch/api/actions/ingest/get_pipeline.rb

@@ -6,28 +6,38 @@ module Elasticsearch
   module API
     module Ingest
       module Actions
-
-        # Return a specified pipeline
+        # Returns a pipeline.
         #
-        # @option arguments [String] :id Comma separated list of pipeline ids (wildcards supported).
+        # @option arguments [String] :id Comma separated list of pipeline ids. Wildcards supported
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
+
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/plugins/master/ingest.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/get-pipeline-api.html
         #
-        def get_pipeline(arguments={})
-          method = 'GET'
-          path   = Utils.__pathify "_ingest/pipeline", Utils.__escape(arguments[:id])
+        def get_pipeline(arguments = {})
+          arguments = arguments.clone
+
+          _id = arguments.delete(:id)
+
+          method = Elasticsearch::API::HTTP_GET
+          path   = if _id
+                     "_ingest/pipeline/#{Utils.__listify(_id)}"
+                   else
+                     "_ingest/pipeline"
+end
           params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-          body   = nil
 
+          body = nil
           perform_request(method, path, params, body).body
         end
 
         # Register this action with its valid params when the module is loaded.
         #
-        # @since 6.1.1
-        ParamsRegistry.register(:get_pipeline, [ :master_timeout ].freeze)
+        # @since 6.2.0
+        ParamsRegistry.register(:get_pipeline, [
+          :master_timeout
+        ].freeze)
+end
       end
-    end
   end
 end

data/lib/elasticsearch/api/actions/ingest/params_registry.rb

@@ -7,7 +7,6 @@ module Elasticsearch
     module Ingest
       module Actions
         module ParamsRegistry
-
           extend self
 
           # A Mapping of all the actions to their list of valid params.

data/lib/elasticsearch/api/actions/ingest/processor_grok.rb

@@ -1,29 +1,28 @@
+# 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 API
     module Ingest
       module Actions
-
-        # Extracts structured fields out of a single text field within a document. You choose which field to extract
-        #   matched fields from, as well as the grok pattern you expect will match.
+        # Returns a list of the built-in patterns.
         #
+
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/plugins/current/ingest.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/grok-processor.html#grok-processor-rest-get
         #
-        def processor_grok(arguments={})
+        def processor_grok(arguments = {})
+          arguments = arguments.clone
+
           method = Elasticsearch::API::HTTP_GET
           path   = "_ingest/processor/grok"
           params = {}
-          body   = nil
 
+          body = nil
           perform_request(method, path, params, body).body
         end
-
-        # Register this action with its valid params when the module is loaded.
-        #
-        # @since 6.2.0
-        ParamsRegistry.register(:processor_grok, [
-        ].freeze)
+end
       end
-    end
   end
 end

data/lib/elasticsearch/api/actions/ingest/put_pipeline.rb

@@ -6,35 +6,40 @@ module Elasticsearch
   module API
     module Ingest
       module Actions
-
-        # Add or update a specified pipeline
+        # Creates or updates a pipeline.
         #
-        # @option arguments [String] :id Pipeline ID (*Required*)
-        # @option arguments [Hash] :body The ingest definition (*Required*)
+        # @option arguments [String] :id Pipeline ID
         # @option arguments [Time] :master_timeout Explicit operation timeout for connection to master node
         # @option arguments [Time] :timeout Explicit operation timeout
+
+        # @option arguments [Hash] :body The ingest definition (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/plugins/master/ingest.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/put-pipeline-api.html
         #
-        def put_pipeline(arguments={})
-          raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
+        def put_pipeline(arguments = {})
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-          method = 'PUT'
-          path   = Utils.__pathify "_ingest/pipeline", Utils.__escape(arguments[:id])
+          raise ArgumentError, "Required argument 'id' missing" unless arguments[:id]
+
+          arguments = arguments.clone
 
+          _id = arguments.delete(:id)
+
+          method = Elasticsearch::API::HTTP_PUT
+          path   = "_ingest/pipeline/#{Utils.__listify(_id)}"
           params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-          body   = arguments[:body]
 
+          body = arguments[:body]
           perform_request(method, path, params, body).body
         end
 
         # Register this action with its valid params when the module is loaded.
         #
-        # @since 6.1.1
+        # @since 6.2.0
         ParamsRegistry.register(:put_pipeline, [
-            :master_timeout,
-            :timeout ].freeze)
+          :master_timeout,
+          :timeout
+        ].freeze)
+end
       end
-    end
   end
 end

data/lib/elasticsearch/api/actions/ingest/simulate.rb

@@ -6,31 +6,41 @@ module Elasticsearch
   module API
     module Ingest
       module Actions
-
-        # Execute a specific pipeline against the set of documents provided in the body of the request
+        # Allows to simulate a pipeline with example documents.
         #
         # @option arguments [String] :id Pipeline ID
-        # @option arguments [Hash] :body The pipeline definition (*Required*)
-        # @option arguments [Boolean] :verbose Verbose mode. Display data output for each processor
-        #                                                    in executed pipeline
+        # @option arguments [Boolean] :verbose Verbose mode. Display data output for each processor in executed pipeline
+
+        # @option arguments [Hash] :body The simulate definition (*Required*)
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/master/simulate-pipeline-api.html
+        # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/simulate-pipeline-api.html
         #
-        def simulate(arguments={})
+        def simulate(arguments = {})
           raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-          method = 'GET'
-          path   = Utils.__pathify "_ingest/pipeline", Utils.__escape(arguments[:id]), '_simulate'
+
+          arguments = arguments.clone
+
+          _id = arguments.delete(:id)
+
+          method = Elasticsearch::API::HTTP_GET
+          path   = if _id
+                     "_ingest/pipeline/#{Utils.__listify(_id)}/_simulate"
+                   else
+                     "_ingest/pipeline/_simulate"
+  end
           params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-          body   = arguments[:body]
 
+          body = arguments[:body]
           perform_request(method, path, params, body).body
         end
 
         # Register this action with its valid params when the module is loaded.
         #
-        # @since 6.1.1
-        ParamsRegistry.register(:simulate, [ :verbose ].freeze)
+        # @since 6.2.0
+        ParamsRegistry.register(:simulate, [
+          :verbose
+        ].freeze)
+end
       end
-    end
   end
 end

data/lib/elasticsearch/api/actions/mget.rb

@@ -5,33 +5,10 @@
 module Elasticsearch
   module API
     module Actions
-
-      # Return multiple documents from one or more indices in a single request.
-      #
-      # Pass the request definition in the `:body` argument, either as an Array of `docs` specifications,
-      # or `ids`, when the `:index` and document `:type` are specified.
-      #
-      # @example Get multiple documents fully specified in the `docs` definition
-      #
-      #     client.mget body: {
-      #       docs: [
-      #         { _index: 'myindex', _type: 'mytype', _id: '1' },
-      #         { _index: 'myindex', _type: 'mytype', _id: '2' },
-      #         { _index: 'myindex', _type: 'mytype', _id: '3' }
-      #       ]
-      #     }
-      #
-      # @example Get multiple documents specified by `ids` while passing `:index` and `:type`
-      #
-      #     client.mget index: 'myindex', type: 'mytype', body: { ids: ['1', '2', '3'] }
-      #
-      # @example Get only specific fields from documents
-      #
-      #     client.mget index: 'myindex', type: 'mytype', body: { ids: ['1', '2', '3'] }, fields: ['title']
+      # Allows to get multiple documents in one request.
       #
       # @option arguments [String] :index The name of the index
-      # @option arguments [String] :type The type of the document
-      # @option arguments [Hash] :body Document identifiers; can be either `docs` (containing full document information) or `ids` (when index and type is provided in the URL. (*Required*)
+      # @option arguments [String] :type The type of the document   *Deprecated*
       # @option arguments [List] :stored_fields A comma-separated list of stored fields to return in the response
       # @option arguments [String] :preference Specify the node or shard the operation should be performed on (default: random)
       # @option arguments [Boolean] :realtime Specify whether to perform the operation in realtime or search mode
@@ -40,36 +17,52 @@ module Elasticsearch
       # @option arguments [List] :_source True or false to return the _source field or not, or a list of fields to return
       # @option arguments [List] :_source_excludes A list of fields to exclude from the returned _source field
       # @option arguments [List] :_source_includes A list of fields to extract and return from the _source field
+
+      # @option arguments [Hash] :body Document identifiers; can be either `docs` (containing full document information) or `ids` (when index and type is provided in the URL. (*Required*)
+      #
+      # *Deprecation notice*:
+      # Specifying types in urls has been deprecated
+      # Deprecated since version 7.0.0
+      #
       #
-      # @see http://elasticsearch.org/guide/reference/api/multi-get/
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/docs-multi-get.html
       #
-      def mget(arguments={})
+      def mget(arguments = {})
         raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-        method = HTTP_GET
-        path   = Utils.__pathify Utils.__escape(arguments[:index]),
-                                 Utils.__escape(arguments[:type]),
-                                 '_mget'
 
-        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-        body   = arguments[:body]
+        arguments = arguments.clone
+
+        _index = arguments.delete(:index)
 
-        params[:fields] = Utils.__listify(params[:fields]) if params[:fields]
+        _type = arguments.delete(:type)
 
+        method = Elasticsearch::API::HTTP_GET
+        path   = if _index && _type
+                   "#{Utils.__listify(_index)}/#{Utils.__listify(_type)}/_mget"
+                 elsif _index
+                   "#{Utils.__listify(_index)}/_mget"
+                 else
+                   "_mget"
+  end
+        params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+
+        body = arguments[:body]
         perform_request(method, path, params, body).body
       end
 
       # Register this action with its valid params when the module is loaded.
       #
-      # @since 6.1.1
+      # @since 6.2.0
       ParamsRegistry.register(:mget, [
-          :stored_fields,
-          :preference,
-          :realtime,
-          :refresh,
-          :routing,
-          :_source,
-          :_source_excludes,
-          :_source_includes ].freeze)
+        :stored_fields,
+        :preference,
+        :realtime,
+        :refresh,
+        :routing,
+        :_source,
+        :_source_excludes,
+        :_source_includes
+      ].freeze)
+    end
     end
-  end
 end

data/lib/elasticsearch/api/actions/msearch.rb

@@ -5,88 +5,88 @@
 module Elasticsearch
   module API
     module Actions
-
-      # Perform multiple search operations in a single request.
-      #
-      # Pass the search definitions in the `:body` argument
-      #
-      # @example Perform multiple different searches as `:search`
-      #
-      #     client.msearch \
-      #       body: [
-      #         { search: { query: { match_all: {} } } },
-      #         { index: 'myindex', type: 'mytype', search: { query: { query_string: { query: '"Test 1"' } } } },
-      #         { search_type: 'count', search: { aggregations: { published: { terms: { field: 'published' } } } } }
-      #       ]
-      #
-      # @example Perform multiple different searches as an array of meta/data pairs
-      #
-      #     client.msearch \
-      #       body: [
-      #         { query: { match_all: {} } },
-      #         { index: 'myindex', type: 'mytype' },
-      #         { query: { query_string: { query: '"Test 1"' } } },
-      #         { search_type: 'query_then_fetch' },
-      #         { aggregations: { published: { terms: { field: 'published' } } } }
-      #       ]
+      # Allows to execute several search operations in one request.
       #
       # @option arguments [List] :index A comma-separated list of index names to use as default
       # @option arguments [List] :type A comma-separated list of document types to use as default
-      # @option arguments [Hash] :body The request definitions (metadata-search request definition pairs), separated by newlines (*Required*)
-      # @option arguments [String] :search_type Search operation type (options: query_then_fetch, query_and_fetch, dfs_query_then_fetch, dfs_query_and_fetch)
+      # @option arguments [String] :search_type Search operation type
+      #   (options: query_then_fetch,query_and_fetch,dfs_query_then_fetch,dfs_query_and_fetch)
+
       # @option arguments [Number] :max_concurrent_searches Controls the maximum number of concurrent searches the multi search api will execute
       # @option arguments [Boolean] :typed_keys Specify whether aggregation and suggester names should be prefixed by their respective types in the response
       # @option arguments [Number] :pre_filter_shard_size A threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on it's rewrite method ie. if date filters are mandatory to match but the shard bounds and the query are disjoint.
-      # @option arguments [Number] :max_concurrent_shard_requests The number of concurrent shard requests each sub search executes concurrently. This value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests
+      # @option arguments [Number] :max_concurrent_shard_requests The number of concurrent shard requests each sub search executes concurrently per node. This value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests
       # @option arguments [Boolean] :rest_total_hits_as_int Indicates whether hits.total should be rendered as an integer or an object in the rest search response
       # @option arguments [Boolean] :ccs_minimize_roundtrips Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution
+
+      # @option arguments [Hash] :body The request definitions (metadata-search request definition pairs), separated by newlines (*Required*)
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/5.x/search-multi-search.html
+      # *Deprecation notice*:
+      # Specifying types in urls has been deprecated
+      # Deprecated since version 7.0.0
       #
-      def msearch(arguments={})
+      #
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/search-multi-search.html
+      #
+      def msearch(arguments = {})
         raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-        method = HTTP_GET
-        path   = Utils.__pathify( Utils.__listify(arguments[:index]), Utils.__listify(arguments[:type]), '_msearch' )
 
+        arguments = arguments.clone
+
+        _index = arguments.delete(:index)
+
+        _type = arguments.delete(:type)
+
+        method = Elasticsearch::API::HTTP_GET
+        path   = if _index && _type
+                   "#{Utils.__listify(_index)}/#{Utils.__listify(_type)}/_msearch"
+                 elsif _index
+                   "#{Utils.__listify(_index)}/_msearch"
+                 else
+                   "_msearch"
+  end
         params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-        body   = arguments[:body]
 
+        body = arguments[:body]
         case
         when body.is_a?(Array) && body.any? { |d| d.has_key? :search }
-          payload = body.
-            inject([]) do |sum, item|
-              meta = item
-              data = meta.delete(:search)
+          payload = body
+                    .inject([]) do |sum, item|
+                      meta = item
+                      data = meta.delete(:search)
 
-              sum << meta
-              sum << data
-              sum
-            end.
-            map { |item| Elasticsearch::API.serializer.dump(item) }
+                      sum << meta
+                      sum << data
+                      sum
+                    end
+                    .map { |item| Elasticsearch::API.serializer.dump(item) }
           payload << "" unless payload.empty?
-          payload = payload.join("\n")
+          payload = payload.join("
+")
         when body.is_a?(Array)
           payload = body.map { |d| d.is_a?(String) ? d : Elasticsearch::API.serializer.dump(d) }
           payload << "" unless payload.empty?
-          payload = payload.join("\n")
+          payload = payload.join("
+")
         else
           payload = body
-        end
+      end
 
-        perform_request(method, path, params, payload, {"Content-Type" => "application/x-ndjson"}).body
+        perform_request(method, path, params, payload, { "Content-Type" => "application/x-ndjson" }).body
       end
 
       # Register this action with its valid params when the module is loaded.
       #
-      # @since 6.1.1
+      # @since 6.2.0
       ParamsRegistry.register(:msearch, [
-          :search_type,
-          :max_concurrent_searches,
-          :typed_keys,
-          :pre_filter_shard_size,
-          :max_concurrent_shard_requests,
-          :rest_total_hits_as_int,
-          :ccs_minimize_roundtrips ].freeze)
+        :search_type,
+        :max_concurrent_searches,
+        :typed_keys,
+        :pre_filter_shard_size,
+        :max_concurrent_shard_requests,
+        :rest_total_hits_as_int,
+        :ccs_minimize_roundtrips
+      ].freeze)
+    end
     end
-  end
 end

data/lib/elasticsearch/api/actions/msearch_template.rb

@@ -5,57 +5,68 @@
 module Elasticsearch
   module API
     module Actions
-
-      # Execute several search requests using templates (inline, indexed or stored in a file)
-      #
-      # @example Search with an inline script
-      #
-      #     client.msearch_template body: [
-      #       { index: 'test' },
-      #       { inline: { query: { match: { title: '{{q}}' } } }, params: { q: 'foo'} }
-      #     ]
+      # Allows to execute several search template operations in one request.
       #
       # @option arguments [List] :index A comma-separated list of index names to use as default
       # @option arguments [List] :type A comma-separated list of document types to use as default
-      # @option arguments [Hash] :body The request definitions (metadata-search request definition pairs), separated by newlines (*Required*)
-      # @option arguments [String] :search_type Search operation type (options: query_then_fetch, query_and_fetch, dfs_query_then_fetch, dfs_query_and_fetch)
+      # @option arguments [String] :search_type Search operation type
+      #   (options: query_then_fetch,query_and_fetch,dfs_query_then_fetch,dfs_query_and_fetch)
+
       # @option arguments [Boolean] :typed_keys Specify whether aggregation and suggester names should be prefixed by their respective types in the response
       # @option arguments [Number] :max_concurrent_searches Controls the maximum number of concurrent searches the multi search api will execute
       # @option arguments [Boolean] :rest_total_hits_as_int Indicates whether hits.total should be rendered as an integer or an object in the rest search response
-      # @option arguments [Boolean] :ccs_minimize_roundtrips Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution
+
+      # @option arguments [Hash] :body The request definitions (metadata-search request definition pairs), separated by newlines (*Required*)
+      #
+      # *Deprecation notice*:
+      # Specifying types in urls has been deprecated
+      # Deprecated since version 7.0.0
+      #
       #
-      # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/multi-search-template.html
+      # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.5/search-multi-search.html
       #
-      def msearch_template(arguments={})
+      def msearch_template(arguments = {})
         raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
-        method = HTTP_GET
-        path   = Utils.__pathify Utils.__listify(arguments[:index]),
-                                 Utils.__listify(arguments[:type]),
-                                 '_msearch/template'
+
+        arguments = arguments.clone
+
+        _index = arguments.delete(:index)
+
+        _type = arguments.delete(:type)
+
+        method = Elasticsearch::API::HTTP_GET
+        path   = if _index && _type
+                   "#{Utils.__listify(_index)}/#{Utils.__listify(_type)}/_msearch/template"
+                 elsif _index
+                   "#{Utils.__listify(_index)}/_msearch/template"
+                 else
+                   "_msearch/template"
+  end
         params = Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
-        body   = arguments[:body]
 
+        body = arguments[:body]
         case
-          when body.is_a?(Array)
-            payload = body.map { |d| d.is_a?(String) ? d : Elasticsearch::API.serializer.dump(d) }
-            payload << "" unless payload.empty?
-            payload = payload.join("\n")
-          else
-            payload = body
-        end
-
-        perform_request(method, path, params, payload, {"Content-Type" => "application/x-ndjson"}).body
+        when body.is_a?(Array)
+          payload = body.map { |d| d.is_a?(String) ? d : Elasticsearch::API.serializer.dump(d) }
+          payload << "" unless payload.empty?
+          payload = payload.join("
+")
+        else
+          payload = body
+      end
+
+        perform_request(method, path, params, payload, { "Content-Type" => "application/x-ndjson" }).body
       end
 
       # Register this action with its valid params when the module is loaded.
       #
-      # @since 6.1.1
+      # @since 6.2.0
       ParamsRegistry.register(:msearch_template, [
-          :search_type,
-          :typed_keys,
-          :max_concurrent_searches,
-          :rest_total_hits_as_int,
-          :ccs_minimize_roundtrips ].freeze)
+        :search_type,
+        :typed_keys,
+        :max_concurrent_searches,
+        :rest_total_hits_as_int
+      ].freeze)
+    end
     end
-  end
 end