elasticsearch-xpack 7.3.0 → 7.4.0

data/lib/elasticsearch/xpack/api/actions/index_lifecycle_management/get_policy.rb

@@ -0,0 +1,38 @@
+# 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 IndexLifecycleManagement
+        module Actions
+
+          # Retrieves a lifecycle policy
+          #
+          # @option arguments [String] :policy_id Identifier for the policy
+          # @option arguments [Time] :master_timeout Specifies the period of time to wait for a connection to the master node
+          # @option arguments [Time] :timeout Specifies the period of time to wait for a response.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-get-lifecycle.html
+          #
+          def get_policy(arguments={})
+            method = Elasticsearch::API::HTTP_GET
+            path   = Elasticsearch::API::Utils.__pathify "_ilm/policy",
+                                                         Elasticsearch::API::Utils.__escape(arguments[:policy_id])
+            params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+            body   = nil
+
+            perform_request(method, path, params, body).body
+          end
+
+          # Register this action with its valid params when the module is loaded.
+          #
+          ParamsRegistry.register(:get_policy, [ :master_timeout,
+                                                 :timeout ].freeze)
+
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/xpack/api/actions/index_lifecycle_management/get_status.rb

@@ -0,0 +1,36 @@
+# 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 IndexLifecycleManagement
+        module Actions
+
+          # Retrieves the current index lifecycle management (ILM) status
+          #
+          # @option arguments [Time] :master_timeout Specifies the period of time to wait for a connection to the master node
+          # @option arguments [Time] :timeout Specifies the period of time to wait for a response.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-get-status.html
+          #
+          def get_status(arguments={})
+            method = Elasticsearch::API::HTTP_GET
+            path   = "_ilm/status"
+            params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+            body   = nil
+
+            perform_request(method, path, params, body).body
+          end
+
+          # Register this action with its valid params when the module is loaded.
+          #
+          ParamsRegistry.register(:get_status, [ :master_timeout,
+                                                 :timeout ].freeze)
+
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/xpack/api/actions/index_lifecycle_management/move_to_step.rb

@@ -0,0 +1,41 @@
+# 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 IndexLifecycleManagement
+        module Actions
+
+          # Triggers execution of a specific step in the lifecycle policy
+          #
+          # @option arguments [String] :index The target index (*Required*)
+          # @option arguments [Hash] :body The request template content (*Required*)
+          # @option arguments [Time] :master_timeout Specifies the period of time to wait for a connection to the master node
+          # @option arguments [Time] :timeout Specifies the period of time to wait for a response.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-move-to-step.html
+          #
+          def move_to_step(arguments={})
+            raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
+            raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+            method = Elasticsearch::API::HTTP_POST
+            index = Elasticsearch::API::Utils.__escape(arguments.delete(:index))
+            path   = Elasticsearch::API::Utils.__pathify "_ilm/move",
+                                                         index
+            params = Elasticsearch::API::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.
+          #
+          ParamsRegistry.register(:move_to_step, [ :master_timeout,
+                                                   :timeout ].freeze)
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/xpack/api/actions/index_lifecycle_management/params_registry.rb

@@ -0,0 +1,50 @@
+# 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 IndexLifecycleManagement
+        module Actions
+          module ParamsRegistry
+
+            extend self
+
+            # A Mapping of all the actions to their list of valid params.
+            #
+            # @since 7.4.0
+            PARAMS = {}
+
+            # Register an action with its list of valid params.
+            #
+            # @example Register the action.
+            #   ParamsRegistry.register(:benchmark, [ :verbose ])
+            #
+            # @param [ Symbol ] action The action to register.
+            # @param [ Array[Symbol] ] valid_params The list of valid params.
+            #
+            # @since 7.4.0
+            def register(action, valid_params)
+              PARAMS[action.to_sym] = valid_params
+            end
+
+            # Get the list of valid params for a given action.
+            #
+            # @example Get the list of valid params.
+            #   ParamsRegistry.get(:benchmark)
+            #
+            # @param [ Symbol ] action The action.
+            #
+            # @return [ Array<Symbol> ] The list of valid params for the action.
+            #
+            # @since 7.4.0
+            def get(action)
+              PARAMS.fetch(action, [])
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/xpack/api/actions/index_lifecycle_management/put_policy.rb

@@ -0,0 +1,40 @@
+# 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 IndexLifecycleManagement
+        module Actions
+
+          # Register a new watch in or update an existing one
+          #
+          # @option arguments [String] :policy_id Identifier for the policy (*Required*)
+          # @option arguments [Hash] :body The policy (*Required*)
+          # @option arguments [Time] :master_timeout Specifies the period of time to wait for a connection to the master node
+          # @option arguments [Time] :timeout Specifies the period of time to wait for a response.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-put-lifecycle.html
+          #
+          def put_policy(arguments={})
+            raise ArgumentError, "Required argument 'policy_id' missing" unless arguments[:policy_id]
+            raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+            method = Elasticsearch::API::HTTP_PUT
+            path   = Elasticsearch::API::Utils.__pathify "_ilm/policy",
+                                                         Elasticsearch::API::Utils.__escape(arguments[:policy_id])
+            params = Elasticsearch::API::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.
+          #
+          ParamsRegistry.register(:put_policy, [ :master_timeout,
+                                                 :timeout ].freeze)
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/xpack/api/actions/index_lifecycle_management/remove_policy.rb

@@ -0,0 +1,38 @@
+# 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 IndexLifecycleManagement
+        module Actions
+
+          # Removes the assigned lifecycle policy from an index
+          #
+          # @option arguments [String] :index The target index (*Required*)
+          # @option arguments [Time] :master_timeout Specifies the period of time to wait for a connection to the master node
+          # @option arguments [Time] :timeout Specifies the period of time to wait for a response.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-remove-policy.html
+          #
+          def remove_policy(arguments={})
+            raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
+            method = Elasticsearch::API::HTTP_POST
+            index = Elasticsearch::API::Utils.__escape(arguments.delete(:index))
+            path   = Elasticsearch::API::Utils.__pathify index, "_ilm/remove"
+            params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+            body   = nil
+
+            perform_request(method, path, params, body).body
+          end
+
+          # Register this action with its valid params when the module is loaded.
+          #
+          ParamsRegistry.register(:remove_policy, [ :master_timeout,
+                                                    :timeout ].freeze)
+        end
+      end
+    end
+  end
+end

data/lib/elasticsearch/xpack/api/actions/index_lifecycle_management/retry_policy.rb

@@ -0,0 +1,38 @@
+# 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 IndexLifecycleManagement
+        module Actions
+
+          # Retry executing the policy for an index that is in the ERROR step
+          #
+          # @option arguments [String] :index The target index (*Required*)
+          # @option arguments [Time] :master_timeout Specifies the period of time to wait for a connection to the master node
+          # @option arguments [Time] :timeout Specifies the period of time to wait for a response.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-move-to-step.html
+          #
+          def retry_policy(arguments={})
+            raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]
+            method = Elasticsearch::API::HTTP_POST
+            index = Elasticsearch::API::Utils.__escape(arguments.delete(:index))
+            path   = Elasticsearch::API::Utils.__pathify index, "_ilm/retry"
+            params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+            body   = nil
+
+            perform_request(method, path, params, body).body
+          end
+
+          # Register this action with its valid params when the module is loaded.
+          #
+          ParamsRegistry.register(:retry_policy, [ :master_timeout,
+                                                   :timeout ].freeze)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# 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 IndexLifecycleManagement
+        module Actions
+
+          # Start the index lifecycle management (ILM) plugin
+          #
+          # @option arguments [Time] :master_timeout Specifies the period of time to wait for a connection to the master node
+          # @option arguments [Time] :timeout Specifies the period of time to wait for a response.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-start.html
+          #
+          def start(arguments={})
+            method = Elasticsearch::API::HTTP_POST
+            path   = "_ilm/start"
+            params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+            body   = nil
+
+            perform_request(method, path, params, body).body
+          end
+
+          # Register this action with its valid params when the module is loaded.
+          #
+          ParamsRegistry.register(:start, [ :master_timeout,
+                                            :timeout ].freeze)
+
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# 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 IndexLifecycleManagement
+        module Actions
+
+          # Stop the index lifecycle management (ILM) plugin
+          #
+          # @option arguments [Time] :master_timeout Specifies the period of time to wait for a connection to the master node
+          # @option arguments [Time] :timeout Specifies the period of time to wait for a response.
+          #
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/current/ilm-stop.html
+          #
+          def stop(arguments={})
+            method = Elasticsearch::API::HTTP_POST
+            path   = "_ilm/stop"
+            params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
+            body   = nil
+
+            perform_request(method, path, params, body).body
+          end
+
+          # Register this action with its valid params when the module is loaded.
+          #
+          ParamsRegistry.register(:stop, [ :master_timeout,
+                                           :timeout ].freeze)
+
+        end
+      end
+    end
+  end
+end

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

@@ -17,17 +17,19 @@ module Elasticsearch
         # @see https://www.elastic.co/guide/en/x-pack/current/info-api.html
         #
         def info(arguments={})
-          valid_params = [
-            :human,
-            :categories ]
-
           method = Elasticsearch::API::HTTP_GET
           path   = "_xpack"
-          params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, valid_params
+          params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
           body   = nil
 
           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(:info, [ :human,
+                                         :categories ].freeze)
       end
     end
   end

data/lib/elasticsearch/xpack/api/actions/license/get.rb

@@ -15,14 +15,18 @@ module Elasticsearch
           # @see https://www.elastic.co/guide/en/x-pack/current/license-management.html
           #
           def get(arguments={})
-            valid_params = [ :local ]
             method = Elasticsearch::API::HTTP_GET
             path   = "_xpack/license"
-            params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, valid_params
+            params = Elasticsearch::API::Utils.__validate_and_extract_params arguments, ParamsRegistry.get(__method__)
             body   = nil
 
             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(:get, [ :local ].freeze)
         end
       end
     end

data/lib/elasticsearch/xpack/api/actions/license/params_registry.rb

@@ -0,0 +1,50 @@
+# 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 License
+        module Actions
+          module ParamsRegistry
+
+            extend self
+
+            # A Mapping of all the actions to their list of valid params.
+            #
+            # @since 7.4.0
+            PARAMS = {}
+
+            # Register an action with its list of valid params.
+            #
+            # @example Register the action.
+            #   ParamsRegistry.register(:benchmark, [ :verbose ])
+            #
+            # @param [ Symbol ] action The action to register.
+            # @param [ Array[Symbol] ] valid_params The list of valid params.
+            #
+            # @since 7.4.0
+            def register(action, valid_params)
+              PARAMS[action.to_sym] = valid_params
+            end
+
+            # Get the list of valid params for a given action.
+            #
+            # @example Get the list of valid params.
+            #   ParamsRegistry.get(:benchmark)
+            #
+            # @param [ Symbol ] action The action.
+            #
+            # @return [ Array<Symbol> ] The list of valid params for the action.
+            #
+            # @since 7.4.0
+            def get(action)
+              PARAMS.fetch(action, [])
+            end
+          end
+        end
+      end
+    end
+  end
+end