elasticsearch-xpack 7.8.0 → 7.9.0.pre

data/lib/elasticsearch/xpack/api/actions/machine_learning/explain_data_frame_analytics.rb

@@ -26,7 +26,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body The data frame analytics config to explain
           #
-          # @see http://www.elastic.co/guide/en/elasticsearch/reference/7.8/explain-dfanalytics.html
+          # @see http://www.elastic.co/guide/en/elasticsearch/reference/7.x/explain-dfanalytics.html
           #
           def explain_data_frame_analytics(arguments = {})
             headers = arguments.delete(:headers) || {}
@@ -35,19 +35,24 @@ module Elasticsearch
 
             _id = arguments.delete(:id)
 
-            method = Elasticsearch::API::HTTP_GET
-            path   = if _id
-                       "_ml/data_frame/analytics/#{Elasticsearch::API::Utils.__listify(_id)}/_explain"
+            method = if arguments[:body]
+                       Elasticsearch::API::HTTP_POST
                      else
-                       "_ml/data_frame/analytics/_explain"
-            end
+                       Elasticsearch::API::HTTP_GET
+                     end
+
+            path = if _id
+                     "_ml/data_frame/analytics/#{Elasticsearch::API::Utils.__listify(_id)}/_explain"
+                   else
+                     "_ml/data_frame/analytics/_explain"
+                   end
             params = {}
 
             body = arguments[:body]
             perform_request(method, path, params, body, headers).body
           end
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/find_file_structure.rb

@@ -41,7 +41,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.8/ml-find-file-structure.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-find-file-structure.html
           #
           def find_file_structure(arguments = {})
             raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
@@ -77,8 +77,8 @@ module Elasticsearch
             :timestamp_format,
             :explain
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/flush_job.rb

@@ -31,7 +31,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body Flush parameters
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-flush-job.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-flush-job.html
           #
           def flush_job(arguments = {})
             raise ArgumentError, "Required argument 'job_id' missing" unless arguments[:job_id]
@@ -60,8 +60,8 @@ module Elasticsearch
             :advance_time,
             :skip_time
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/forecast.rb

@@ -25,9 +25,10 @@ module Elasticsearch
           # @option arguments [String] :job_id The ID of the job to forecast for
           # @option arguments [Time] :duration The duration of the forecast
           # @option arguments [Time] :expires_in The time interval after which the forecast expires. Expired forecasts will be deleted at the first opportunity.
+          # @option arguments [String] :max_model_memory The max memory able to be used by the forecast. Default is 20mb.
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-forecast.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-forecast.html
           #
           def forecast(arguments = {})
             raise ArgumentError, "Required argument 'job_id' missing" unless arguments[:job_id]
@@ -51,10 +52,11 @@ module Elasticsearch
           # @since 6.2.0
           ParamsRegistry.register(:forecast, [
             :duration,
-            :expires_in
+            :expires_in,
+            :max_model_memory
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_buckets.rb

@@ -36,7 +36,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body Bucket selection details if not provided in URI
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-bucket.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-bucket.html
           #
           def get_buckets(arguments = {})
             raise ArgumentError, "Required argument 'job_id' missing" unless arguments[:job_id]
@@ -49,12 +49,17 @@ module Elasticsearch
 
             _timestamp = arguments.delete(:timestamp)
 
-            method = Elasticsearch::API::HTTP_GET
-            path   = if _job_id && _timestamp
-                       "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/buckets/#{Elasticsearch::API::Utils.__listify(_timestamp)}"
+            method = if arguments[:body]
+                       Elasticsearch::API::HTTP_POST
                      else
-                       "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/buckets"
-  end
+                       Elasticsearch::API::HTTP_GET
+                     end
+
+            path = if _job_id && _timestamp
+                     "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/buckets/#{Elasticsearch::API::Utils.__listify(_timestamp)}"
+                   else
+                     "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/buckets"
+                   end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = arguments[:body]
@@ -75,8 +80,8 @@ module Elasticsearch
             :sort,
             :desc
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_calendar_events.rb

@@ -30,7 +30,7 @@ module Elasticsearch
           # @option arguments [Int] :size Specifies a max number of events to get
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-calendar-event.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-calendar-event.html
           #
           def get_calendar_events(arguments = {})
             raise ArgumentError, "Required argument 'calendar_id' missing" unless arguments[:calendar_id]
@@ -59,8 +59,8 @@ module Elasticsearch
             :from,
             :size
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_calendars.rb

@@ -28,7 +28,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body The from and size parameters optionally sent in the body
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-calendar.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-calendar.html
           #
           def get_calendars(arguments = {})
             headers = arguments.delete(:headers) || {}
@@ -37,12 +37,17 @@ module Elasticsearch
 
             _calendar_id = arguments.delete(:calendar_id)
 
-            method = Elasticsearch::API::HTTP_GET
-            path   = if _calendar_id
-                       "_ml/calendars/#{Elasticsearch::API::Utils.__listify(_calendar_id)}"
+            method = if arguments[:body]
+                       Elasticsearch::API::HTTP_POST
                      else
-                       "_ml/calendars"
-            end
+                       Elasticsearch::API::HTTP_GET
+                     end
+
+            path = if _calendar_id
+                     "_ml/calendars/#{Elasticsearch::API::Utils.__listify(_calendar_id)}"
+                   else
+                     "_ml/calendars"
+                   end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = arguments[:body]
@@ -56,8 +61,8 @@ module Elasticsearch
             :from,
             :size
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_categories.rb

@@ -26,10 +26,11 @@ module Elasticsearch
           # @option arguments [Long] :category_id The identifier of the category definition of interest
           # @option arguments [Int] :from skips a number of categories
           # @option arguments [Int] :size specifies a max number of categories to get
+          # @option arguments [String] :partition_field_value Specifies the partition to retrieve categories for. This is optional, and should never be used for jobs where per-partition categorization is disabled.
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body Category selection details if not provided in URI
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-category.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-category.html
           #
           def get_categories(arguments = {})
             raise ArgumentError, "Required argument 'job_id' missing" unless arguments[:job_id]
@@ -42,12 +43,17 @@ module Elasticsearch
 
             _category_id = arguments.delete(:category_id)
 
-            method = Elasticsearch::API::HTTP_GET
-            path   = if _job_id && _category_id
-                       "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/categories/#{Elasticsearch::API::Utils.__listify(_category_id)}"
+            method = if arguments[:body]
+                       Elasticsearch::API::HTTP_POST
                      else
-                       "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/categories"
-  end
+                       Elasticsearch::API::HTTP_GET
+                     end
+
+            path = if _job_id && _category_id
+                     "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/categories/#{Elasticsearch::API::Utils.__listify(_category_id)}"
+                   else
+                     "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/categories"
+                   end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = arguments[:body]
@@ -59,10 +65,11 @@ module Elasticsearch
           # @since 6.2.0
           ParamsRegistry.register(:get_categories, [
             :from,
-            :size
+            :size,
+            :partition_field_value
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_data_frame_analytics.rb

@@ -28,7 +28,7 @@ module Elasticsearch
           # @option arguments [Int] :size specifies a max number of analytics to get
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/get-dfanalytics.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/get-dfanalytics.html
           #
           def get_data_frame_analytics(arguments = {})
             headers = arguments.delete(:headers) || {}
@@ -42,7 +42,7 @@ module Elasticsearch
                        "_ml/data_frame/analytics/#{Elasticsearch::API::Utils.__listify(_id)}"
                      else
                        "_ml/data_frame/analytics"
-            end
+                     end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = nil
@@ -57,8 +57,8 @@ module Elasticsearch
             :from,
             :size
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_data_frame_analytics_stats.rb

@@ -28,7 +28,7 @@ module Elasticsearch
           # @option arguments [Int] :size specifies a max number of analytics to get
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/get-dfanalytics-stats.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/get-dfanalytics-stats.html
           #
           def get_data_frame_analytics_stats(arguments = {})
             headers = arguments.delete(:headers) || {}
@@ -42,7 +42,7 @@ module Elasticsearch
                        "_ml/data_frame/analytics/#{Elasticsearch::API::Utils.__listify(_id)}/_stats"
                      else
                        "_ml/data_frame/analytics/_stats"
-            end
+                     end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = nil
@@ -57,8 +57,8 @@ module Elasticsearch
             :from,
             :size
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_datafeed_stats.rb

@@ -26,7 +26,7 @@ module Elasticsearch
           # @option arguments [Boolean] :allow_no_datafeeds Whether to ignore if a wildcard expression matches no datafeeds. (This includes `_all` string or when no datafeeds have been specified)
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-datafeed-stats.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-datafeed-stats.html
           #
           def get_datafeed_stats(arguments = {})
             headers = arguments.delete(:headers) || {}
@@ -40,7 +40,7 @@ module Elasticsearch
                        "_ml/datafeeds/#{Elasticsearch::API::Utils.__listify(_datafeed_id)}/_stats"
                      else
                        "_ml/datafeeds/_stats"
-            end
+                     end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = nil
@@ -53,8 +53,8 @@ module Elasticsearch
           ParamsRegistry.register(:get_datafeed_stats, [
             :allow_no_datafeeds
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_datafeeds.rb

@@ -26,7 +26,7 @@ module Elasticsearch
           # @option arguments [Boolean] :allow_no_datafeeds Whether to ignore if a wildcard expression matches no datafeeds. (This includes `_all` string or when no datafeeds have been specified)
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-datafeed.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-datafeed.html
           #
           def get_datafeeds(arguments = {})
             headers = arguments.delete(:headers) || {}
@@ -40,7 +40,7 @@ module Elasticsearch
                        "_ml/datafeeds/#{Elasticsearch::API::Utils.__listify(_datafeed_id)}"
                      else
                        "_ml/datafeeds"
-            end
+                     end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = nil
@@ -53,8 +53,8 @@ module Elasticsearch
           ParamsRegistry.register(:get_datafeeds, [
             :allow_no_datafeeds
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_filters.rb

@@ -27,7 +27,7 @@ module Elasticsearch
           # @option arguments [Int] :size specifies a max number of filters to get
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-filter.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-filter.html
           #
           def get_filters(arguments = {})
             headers = arguments.delete(:headers) || {}
@@ -41,7 +41,7 @@ module Elasticsearch
                        "_ml/filters/#{Elasticsearch::API::Utils.__listify(_filter_id)}"
                      else
                        "_ml/filters"
-            end
+                     end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = nil
@@ -55,8 +55,8 @@ module Elasticsearch
             :from,
             :size
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_influencers.rb

@@ -34,7 +34,7 @@ module Elasticsearch
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body Influencer selection criteria
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-influencer.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-influencer.html
           #
           def get_influencers(arguments = {})
             raise ArgumentError, "Required argument 'job_id' missing" unless arguments[:job_id]
@@ -45,8 +45,13 @@ module Elasticsearch
 
             _job_id = arguments.delete(:job_id)
 
-            method = Elasticsearch::API::HTTP_GET
-            path   = "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/influencers"
+            method = if arguments[:body]
+                       Elasticsearch::API::HTTP_POST
+                     else
+                       Elasticsearch::API::HTTP_GET
+                     end
+
+            path = "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/results/influencers"
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = arguments[:body]
@@ -66,8 +71,8 @@ module Elasticsearch
             :sort,
             :desc
           ].freeze)
+        end
       end
     end
-    end
   end
 end

data/lib/elasticsearch/xpack/api/actions/machine_learning/get_job_stats.rb

@@ -26,7 +26,7 @@ module Elasticsearch
           # @option arguments [Boolean] :allow_no_jobs Whether to ignore if a wildcard expression matches no jobs. (This includes `_all` string or when no jobs have been specified)
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.8/ml-get-job-stats.html
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-job-stats.html
           #
           def get_job_stats(arguments = {})
             headers = arguments.delete(:headers) || {}
@@ -40,7 +40,7 @@ module Elasticsearch
                        "_ml/anomaly_detectors/#{Elasticsearch::API::Utils.__listify(_job_id)}/_stats"
                      else
                        "_ml/anomaly_detectors/_stats"
-            end
+                     end
             params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
 
             body = nil
@@ -53,8 +53,8 @@ module Elasticsearch
           ParamsRegistry.register(:get_job_stats, [
             :allow_no_jobs
           ].freeze)
+        end
       end
     end
-    end
   end
 end