elasticsearch-api 9.1.3 → 9.2.1

data/lib/elasticsearch/api/actions/tasks/list.rb

@@ -78,10 +78,9 @@ module Elasticsearch
         # In this example, `X-Opaque-Id: 123456` is the ID as a part of the response header.
         # The `X-Opaque-Id` in the task `headers` is the ID for the task that was initiated by the REST request.
         # The `X-Opaque-Id` in the children `headers` is the child task of the task that was initiated by the REST request.
-        # This functionality is Experimental and may be changed or removed
-        # completely in a future release. Elastic will take a best effort approach
-        # to fix any issues, but experimental features are not subject to the
-        # support SLA of official GA features.
+        # This functionality is in technical preview and may be changed or removed in a future
+        # release. Elastic will apply best effort to fix any issues, but features in technical
+        # preview are not subject to the support SLA of official GA features.
         #
         # @option arguments [String, Array<String>] :actions A comma-separated list or wildcard expression of actions used to limit the request.
         #  For example, you can use `cluser:*` to retrieve all cluster-related tasks.

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

@@ -52,6 +52,7 @@ module Elasticsearch
         end
         request_opts[:defined_params] = defined_params unless defined_params.empty?
 
+        raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
         raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
 
         arguments = arguments.clone
@@ -61,12 +62,7 @@ module Elasticsearch
 
         _index = arguments.delete(:index)
 
-        method = if body
-                   Elasticsearch::API::HTTP_POST
-                 else
-                   Elasticsearch::API::HTTP_GET
-                 end
-
+        method = Elasticsearch::API::HTTP_POST
         path   = "#{Utils.listify(_index)}/_terms_enum"
         params = Utils.process_params(arguments)
 

data/lib/elasticsearch/api/actions/transform/get_node_stats.rb

@@ -22,11 +22,23 @@ module Elasticsearch
   module API
     module Transform
       module Actions
-        # Retrieves transform usage information for transform nodes
+        # Get node stats.
+        # Get per-node information about transform usage.
         #
+        # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
+        #  when they occur.
+        # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response
+        #  returned by Elasticsearch.
+        # @option arguments [Boolean] :human When set to `true` will return statistics in a format suitable for humans.
+        #  For example `"exists_time": "1h"` for humans and
+        #  `"exists_time_in_millis": 3600000` for computers. When disabled the human
+        #  readable values will be omitted. This makes sense for responses being consumed
+        #  only by machines.
+        # @option arguments [Boolean] :pretty If set to `true` the returned JSON will be "pretty-formatted". Only use
+        #  this option for debugging only.
         # @option arguments [Hash] :headers Custom HTTP headers
         #
-        # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/get-transform-node-stats.html
+        # @see https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-transform-get-node-stats
         #
         def get_node_stats(arguments = {})
           request_opts = { endpoint: arguments[:endpoint] || 'transform.get_node_stats' }
@@ -38,7 +50,7 @@ module Elasticsearch
 
           method = Elasticsearch::API::HTTP_GET
           path   = '_transform/_node_stats'
-          params = {}
+          params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(
             perform_request(method, path, params, body, headers, request_opts)

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

@@ -37,7 +37,7 @@ module Elasticsearch
         #  there are no matches or only partial matches. Server default: true.
         # @option arguments [Integer] :from Skips the specified number of transforms. Server default: 0.
         # @option arguments [Integer] :size Specifies the maximum number of transforms to obtain. Server default: 100.
-        # @option arguments [Time] :timeout Controls the time to wait for the stats
+        # @option arguments [Time] :timeout Controls the time to wait for the stats Server default: 30s.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.
         # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

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

@@ -103,20 +103,20 @@ module Elasticsearch
       # @option arguments [Boolean] :analyze_wildcard If `true`, wildcard and prefix queries are analyzed.
       #  This parameter can be used only when the `q` query string parameter is specified.
       # @option arguments [String] :conflicts The preferred behavior when update by query hits version conflicts: `abort` or `proceed`. Server default: abort.
-      # @option arguments [String] :default_operator The default operator for query string query: `AND` or `OR`.
-      #  This parameter can be used only when the `q` query string parameter is specified. Server default: OR.
+      # @option arguments [String] :default_operator The default operator for query string query: `and` or `or`.
+      #  This parameter can be used only when the `q` query string parameter is specified. Server default: or.
       # @option arguments [String] :df The field to use as default where no field prefix is given in the query string.
       #  This parameter can be used only when the `q` query string parameter is specified.
       # @option arguments [String, Array<String>] :expand_wildcards The type of index that wildcard patterns can match.
       #  If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.
-      #  It supports comma-separated values, such as `open,hidden`.
+      #  It supports comma-separated values, such as `open,hidden`. Server default: open.
       # @option arguments [Integer] :from Skips the specified number of documents. Server default: 0.
       # @option arguments [Boolean] :ignore_unavailable If `false`, the request returns an error if it targets a missing or closed index.
       # @option arguments [Boolean] :lenient If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.
       #  This parameter can be used only when the `q` query string parameter is specified.
       # @option arguments [Integer] :max_docs The maximum number of documents to process.
       #  It defaults to all documents.
-      #  When set to a value less then or equal to `scroll_size` then a scroll will not be used to retrieve the results for the operation.
+      #  When set to a value less than or equal to `scroll_size` and `conflicts` is set to `abort`, a scroll will not be used to retrieve the results for the operation.
       # @option arguments [String] :pipeline The ID of the pipeline to use to preprocess incoming documents.
       #  If the index has a default ingest pipeline specified, then setting the value to `_none` disables the default ingest pipeline for this request.
       #  If a final pipeline is configured it will always run, regardless of the value of this parameter.

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

@@ -27,7 +27,7 @@ module Elasticsearch
       #
       # @option arguments [String] :task_id The ID for the task. (*Required*)
       # @option arguments [Float] :requests_per_second The throttle for this request in sub-requests per second.
-      #  To turn off throttling, set it to `-1`. Server default: -1.
+      #  To turn off throttling, set it to `-1`. (*Required*)
       # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
       #  when they occur.
       # @option arguments [String, Array<String>] :filter_path Comma-separated list of filters in dot notation which reduce the response

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

@@ -35,8 +35,8 @@ module Elasticsearch
         # @option arguments [String] :id The identifier for the watch. (*Required*)
         # @option arguments [Boolean] :active The initial state of the watch.
         #  The default value is `true`, which means the watch is active by default. Server default: true.
-        # @option arguments [Integer] :if_primary_term only update the watch if the last operation that has changed the watch has the specified primary term
-        # @option arguments [Integer] :if_seq_no only update the watch if the last operation that has changed the watch has the specified sequence number
+        # @option arguments [Integer] :if_primary_term Only update the watch if the last operation that has changed the watch has the specified primary term
+        # @option arguments [Integer] :if_seq_no Only update the watch if the last operation that has changed the watch has the specified sequence number
         # @option arguments [Integer] :version Explicit version number for concurrency control
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors
         #  when they occur.

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

@@ -30,7 +30,7 @@ module Elasticsearch
         #
         # @option arguments [Array<String>] :categories A comma-separated list of the information categories to include in the response.
         #  For example, `build,license,features`.
-        # @option arguments [Boolean] :accept_enterprise If this param is used it must be set to true
+        # @option arguments [Boolean] :accept_enterprise If used, this otherwise ignored parameter must be set to true
         # @option arguments [Boolean] :human Defines whether additional human-readable information is included in the response.
         #  In particular, it adds descriptions and a tag line. Server default: true.
         # @option arguments [Boolean] :error_trace When set to `true` Elasticsearch will include the full stack trace of errors

data/lib/elasticsearch/api/version.rb

@@ -17,7 +17,7 @@
 
 module Elasticsearch
   module API
-    VERSION = '9.1.3'.freeze
-    ES_SPECIFICATION_COMMIT = 'ab308fbed818e33443a905ef54a3e2ee7333c11a'.freeze
+    VERSION = '9.2.1'.freeze
+    ES_SPECIFICATION_COMMIT = '49022a2c08d291955de83e26c583b7dc628fb558'.freeze
   end
 end

data/lib/elasticsearch/api.rb

@@ -28,6 +28,7 @@ module Elasticsearch
   # It includes the namespace modules from ./api/actions
   module API
     include Elasticsearch::API::Actions
+
     DEFAULT_SERIALIZER = MultiJson
 
     HTTP_GET          = 'GET'.freeze
@@ -71,6 +72,7 @@ module Elasticsearch
                       :migration,
                       :machine_learning,
                       :nodes,
+                      :project,
                       :query_rules,
                       :search_application,
                       :searchable_snapshots,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elasticsearch-api
 version: !ruby/object:Gem::Version
-  version: 9.1.3
+  version: 9.2.1
 platform: ruby
 authors:
 - Elastic Client Library Maintainers
@@ -454,6 +454,7 @@ files:
 - lib/elasticsearch/api/actions/indices/get_data_lifecycle.rb
 - lib/elasticsearch/api/actions/indices/get_data_lifecycle_stats.rb
 - lib/elasticsearch/api/actions/indices/get_data_stream.rb
+- lib/elasticsearch/api/actions/indices/get_data_stream_mappings.rb
 - lib/elasticsearch/api/actions/indices/get_data_stream_options.rb
 - lib/elasticsearch/api/actions/indices/get_data_stream_settings.rb
 - lib/elasticsearch/api/actions/indices/get_field_mapping.rb
@@ -469,6 +470,7 @@ files:
 - lib/elasticsearch/api/actions/indices/promote_data_stream.rb
 - lib/elasticsearch/api/actions/indices/put_alias.rb
 - lib/elasticsearch/api/actions/indices/put_data_lifecycle.rb
+- lib/elasticsearch/api/actions/indices/put_data_stream_mappings.rb
 - lib/elasticsearch/api/actions/indices/put_data_stream_options.rb
 - lib/elasticsearch/api/actions/indices/put_data_stream_settings.rb
 - lib/elasticsearch/api/actions/indices/put_index_template.rb
@@ -497,6 +499,7 @@ files:
 - lib/elasticsearch/api/actions/inference/get.rb
 - lib/elasticsearch/api/actions/inference/inference.rb
 - lib/elasticsearch/api/actions/inference/put.rb
+- lib/elasticsearch/api/actions/inference/put_ai21.rb
 - lib/elasticsearch/api/actions/inference/put_alibabacloud.rb
 - lib/elasticsearch/api/actions/inference/put_amazonbedrock.rb
 - lib/elasticsearch/api/actions/inference/put_amazonsagemaker.rb
@@ -504,6 +507,7 @@ files:
 - lib/elasticsearch/api/actions/inference/put_azureaistudio.rb
 - lib/elasticsearch/api/actions/inference/put_azureopenai.rb
 - lib/elasticsearch/api/actions/inference/put_cohere.rb
+- lib/elasticsearch/api/actions/inference/put_contextualai.rb
 - lib/elasticsearch/api/actions/inference/put_custom.rb
 - lib/elasticsearch/api/actions/inference/put_deepseek.rb
 - lib/elasticsearch/api/actions/inference/put_elasticsearch.rb
@@ -512,6 +516,7 @@ files:
 - lib/elasticsearch/api/actions/inference/put_googlevertexai.rb
 - lib/elasticsearch/api/actions/inference/put_hugging_face.rb
 - lib/elasticsearch/api/actions/inference/put_jinaai.rb
+- lib/elasticsearch/api/actions/inference/put_llama.rb
 - lib/elasticsearch/api/actions/inference/put_mistral.rb
 - lib/elasticsearch/api/actions/inference/put_openai.rb
 - lib/elasticsearch/api/actions/inference/put_voyageai.rb
@@ -631,6 +636,7 @@ files:
 - lib/elasticsearch/api/actions/nodes/usage.rb
 - lib/elasticsearch/api/actions/open_point_in_time.rb
 - lib/elasticsearch/api/actions/ping.rb
+- lib/elasticsearch/api/actions/project/tags.rb
 - lib/elasticsearch/api/actions/put_script.rb
 - lib/elasticsearch/api/actions/query_rules/delete_rule.rb
 - lib/elasticsearch/api/actions/query_rules/delete_ruleset.rb
@@ -698,6 +704,7 @@ files:
 - lib/elasticsearch/api/actions/security/get_service_accounts.rb
 - lib/elasticsearch/api/actions/security/get_service_credentials.rb
 - lib/elasticsearch/api/actions/security/get_settings.rb
+- lib/elasticsearch/api/actions/security/get_stats.rb
 - lib/elasticsearch/api/actions/security/get_token.rb
 - lib/elasticsearch/api/actions/security/get_user.rb
 - lib/elasticsearch/api/actions/security/get_user_privileges.rb
@@ -834,7 +841,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Ruby API for Elasticsearch.
 test_files: []