opensearch-ruby 4.0.0.pre.beta.1 → 4.0.0.pre.beta.2

data/lib/opensearch/api/actions/ml/train_predict.rb

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Trains a model and predicts against the same training dataset.
+        #
+        # @option args [String] :algorithm_name *Required*
+        # @option args [Hash] :body
+        def train_predict(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'algorithm_name' missing" if args['algorithm_name'].nil?
+
+          _algorithm_name = args.delete('algorithm_name')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = Utils.build_url('_plugins/_ml/_train_predict', _algorithm_name)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/undeploy_model.rb

@@ -15,11 +15,10 @@ module OpenSearch
       module Actions
         # Undeploys a model.
         #
-        # @option args [String] :model_id *Required*
+        # @option args [String] :model_id
+        # @option args [Hash] :body
         def undeploy_model(args = {})
           args = Utils.clone_and_normalize_arguments(args)
-          raise ArgumentError, "Required argument 'model_id' missing" if args['model_id'].nil?
-
           _model_id = args.delete('model_id')
 
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/ml/unload_model.rb

@@ -0,0 +1,35 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Unloads a model.
+        #
+        # @option args [String] :model_id
+        # @option args [Hash] :body
+        def unload_model(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          _model_id = args.delete('model_id')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = Utils.build_url('_plugins/_ml/models', _model_id, '_unload')
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/update_connector.rb

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Updates a standalone connector.
+        #
+        # @option args [String] :connector_id *Required*
+        # @option args [Hash] :body
+        def update_connector(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'connector_id' missing" if args['connector_id'].nil?
+
+          _connector_id = args.delete('connector_id')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url('_plugins/_ml/connectors', _connector_id)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/update_controller.rb

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Updates a controller.
+        #
+        # @option args [String] :model_id *Required*
+        # @option args [Hash] :body
+        def update_controller(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'model_id' missing" if args['model_id'].nil?
+
+          _model_id = args.delete('model_id')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url('_plugins/_ml/controllers', _model_id)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/update_memory.rb

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Update a memory.
+        #
+        # @option args [String] :memory_id *Required*
+        # @option args [Hash] :body
+        def update_memory(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'memory_id' missing" if args['memory_id'].nil?
+
+          _memory_id = args.delete('memory_id')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url('_plugins/_ml/memory', _memory_id)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/update_message.rb

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Update a message.
+        #
+        # @option args [String] :message_id *Required*
+        # @option args [Hash] :body
+        def update_message(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'message_id' missing" if args['message_id'].nil?
+
+          _message_id = args.delete('message_id')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url('_plugins/_ml/memory/message', _message_id)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/update_model.rb

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Updates a model.
+        #
+        # @option args [String] :model_id *Required*
+        # @option args [Hash] :body
+        def update_model(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'model_id' missing" if args['model_id'].nil?
+
+          _model_id = args.delete('model_id')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url('_plugins/_ml/models', _model_id)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/update_model_group.rb

@@ -0,0 +1,37 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Updates a model group.
+        #
+        # @option args [String] :model_group_id *Required*
+        # @option args [Hash] :body
+        def update_model_group(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'model_group_id' missing" if args['model_group_id'].nil?
+
+          _model_group_id = args.delete('model_group_id')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url('_plugins/_ml/model_groups', _model_group_id)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/upload_chunk.rb

@@ -0,0 +1,40 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Uploads model chunk.
+        #
+        # @option args [Integer] :chunk_number *Required*
+        # @option args [String] :model_id *Required*
+        # @option args [Hash] :body
+        def upload_chunk(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'chunk_number' missing" if args['chunk_number'].nil?
+          raise ArgumentError, "Required argument 'model_id' missing" if args['model_id'].nil?
+
+          _chunk_number = args.delete('chunk_number')
+          _model_id = args.delete('model_id')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = Utils.build_url('_plugins/_ml/models', _model_id, 'upload_chunk', _chunk_number)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/ml/upload_model.rb

@@ -0,0 +1,32 @@
+# SPDX-License-Identifier: Apache-2.0
+#
+# The OpenSearch Contributors require contributions made to
+# this file be licensed under the Apache-2.0 license or a
+# compatible open source license.
+
+# This file is generated from the OpenSearch REST API spec.
+# Do not modify it by hand. Instead, modify the generator or the spec.
+
+# frozen_string_literal: true
+
+module OpenSearch
+  module API
+    module Ml
+      module Actions
+        # Registers a model.
+        #
+        # @option args [Hash] :body
+        def upload_model(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = '_plugins/_ml/models/_upload'
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

data/lib/opensearch/api/actions/notifications/delete_config.rb

@@ -16,21 +16,19 @@ module OpenSearch
         # Delete a channel configuration.
         #
         # @option args [String] :config_id *Required* The ID of the channel configuration to delete.
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def delete_config(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           raise ArgumentError, "Required argument 'config_id' missing" if args['config_id'].nil?
 
           _config_id = args.delete('config_id')
 
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = Utils.build_url('_plugins/_notifications/configs', _config_id)
 
           Utils.validate_query_params! args
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
       end
     end

data/lib/opensearch/api/actions/notifications/delete_configs.rb

@@ -17,19 +17,17 @@ module OpenSearch
         #
         # @option args [String] :config_id *Required* The ID of the channel configuration to delete.
         # @option args [String] :config_id_list A comma-separated list of channel IDs to delete.
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def delete_configs(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           raise ArgumentError, "Required argument 'config_id' missing" if args['config_id'].nil?
 
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = '_plugins/_notifications/configs'
 
           Utils.validate_query_params! args, DELETE_CONFIGS_QUERY_PARAMS
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
 
         DELETE_CONFIGS_QUERY_PARAMS = Set.new(%w[

data/lib/opensearch/api/actions/observability/delete_object.rb

@@ -16,21 +16,19 @@ module OpenSearch
         # Deletes specific observability object specified by ID.
         #
         # @option args [String] :object_id *Required* The ID of the Observability Object.
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def delete_object(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           raise ArgumentError, "Required argument 'object_id' missing" if args['object_id'].nil?
 
           _object_id = args.delete('object_id')
 
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = Utils.build_url('_plugins/_observability/object', _object_id)
 
           Utils.validate_query_params! args
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
       end
     end

data/lib/opensearch/api/actions/observability/delete_objects.rb

@@ -17,17 +17,15 @@ module OpenSearch
         #
         # @option args [String] :objectId The ID of a single Observability Object to delete.
         # @option args [String] :objectIdList A comma-separated list of Observability Object IDs to delete.
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def delete_objects(args = {})
           args = Utils.clone_and_normalize_arguments(args)
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = '_plugins/_observability/object'
 
           Utils.validate_query_params! args, DELETE_OBJECTS_QUERY_PARAMS
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
 
         DELETE_OBJECTS_QUERY_PARAMS = Set.new(%w[

data/lib/opensearch/api/actions/query/datasource_delete.rb

@@ -16,21 +16,19 @@ module OpenSearch
         # Deletes specific datasource specified by name.
         #
         # @option args [String] :datasource_name *Required* The Name of the DataSource to delete.
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def datasource_delete(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           raise ArgumentError, "Required argument 'datasource_name' missing" if args['datasource_name'].nil?
 
           _datasource_name = args.delete('datasource_name')
 
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = Utils.build_url('_plugins/_query/_datasources', _datasource_name)
 
           Utils.validate_query_params! args
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
       end
     end

data/lib/opensearch/api/actions/reindex.rb

@@ -20,8 +20,9 @@ module OpenSearch
         # @option args [Integer] :max_docs Maximum number of documents to process. By default, all documents.
         # @option args [Boolean, String] :refresh If `true`, the request refreshes affected shards to make this operation visible to search.
         # @option args [Float] :requests_per_second (default: 0) The throttle for this request in sub-requests per second. Defaults to no throttle.
+        # @option args [Boolean] :require_alias
         # @option args [String] :scroll Specifies how long a consistent view of the index should be maintained for scrolled search.
-        # @option args [Float, String] :slices The number of slices this task should be divided into. Defaults to 1 slice, meaning the task isn't sliced into subtasks.
+        # @option args [Integer, String] :slices The number of slices this task should be divided into. Defaults to 1 slice, meaning the task isn't sliced into subtasks.
         # @option args [String] :timeout Period each indexing waits for automatic index creation, dynamic mapping updates, and waiting for active shards.
         # @option args [Integer, String] :wait_for_active_shards The number of shard copies that must be active before proceeding with the operation. Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
         # @option args [Boolean] :wait_for_completion (default: true) If `true`, the request blocks until the operation is complete.
@@ -43,6 +44,7 @@ module OpenSearch
           max_docs
           refresh
           requests_per_second
+          require_alias
           scroll
           slices
           timeout

data/lib/opensearch/api/actions/reindex_rethrottle.rb

@@ -13,7 +13,7 @@ module OpenSearch
   module API
     module Root
       module Actions
-        # Changes the number of requests per second for a particular Reindex operation.
+        # Changes the number of requests per second for a particular reindex operation.
         #
         # @option args [String] :task_id *Required* Identifier for the task.
         # @option args [Float] :requests_per_second The throttle for this request in sub-requests per second.

data/lib/opensearch/api/actions/replication/delete_replication_rule.rb

@@ -16,19 +16,17 @@ module OpenSearch
         # Deletes the specified replication rule.
         #
         # @option args [Hash] :body *Required*
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def delete_replication_rule(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           raise ArgumentError, "Required argument 'body' missing" if args['body'].nil?
 
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = '_plugins/_replication/_autofollow'
 
           Utils.validate_query_params! args
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
       end
     end

data/lib/opensearch/api/actions/rollups/delete.rb

@@ -16,21 +16,19 @@ module OpenSearch
         # Delete index rollup.
         #
         # @option args [String] :id *Required* Rollup to access
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def delete(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           raise ArgumentError, "Required argument 'id' missing" if args['id'].nil?
 
           _id = args.delete('id')
 
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = Utils.build_url('_plugins/_rollup/jobs', _id)
 
           Utils.validate_query_params! args
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
       end
     end

data/lib/opensearch/api/actions/scroll.rb

@@ -18,7 +18,7 @@ module OpenSearch
         # @option args [Boolean] :rest_total_hits_as_int If `true`, the API response's `hit.total` property is returned as an integer. If `false`, the API response's `hit.total` property is returned as an object.
         # @option args [String] :scroll Period to retain the search context for scrolling.
         # @option args [String] :scroll_id DEPRECATED The scroll ID for scrolled search
-        # @option args [Hash] :body The scroll ID if not passed by URL or query parameter.
+        # @option args [Hash] :body
         def scroll(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           _scroll_id = args.delete('scroll_id')

data/lib/opensearch/api/actions/search_pipeline/delete.rb

@@ -18,21 +18,19 @@ module OpenSearch
         # @option args [String] :id *Required* Pipeline ID.
         # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
         # @option args [String] :timeout Operation timeout.
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def delete(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           raise ArgumentError, "Required argument 'id' missing" if args['id'].nil?
 
           _id = args.delete('id')
 
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = Utils.build_url('_search/pipeline', _id)
 
           Utils.validate_query_params! args, DELETE_QUERY_PARAMS
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
 
         DELETE_QUERY_PARAMS = Set.new(%w[

data/lib/opensearch/api/actions/search_shards.rb

@@ -22,7 +22,6 @@ module OpenSearch
         # @option args [String] :preference (default: random) Specifies the node or shard the operation should be performed on. Random by default.
         # @option args [Enumerable<String>, String] :routing Custom value used to route operations to a specific shard.
         # @option args [Enumerable<String>, String] :index Returns the indexes and shards that a search request would be executed against.
-        # @option args [Hash] :body Defines the parameters that can be used in the `search_shards` endpoint request. See documentation for supported query syntax.
         def search_shards(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           _index = args.delete('index')

data/lib/opensearch/api/actions/security/authinfo.rb

@@ -13,10 +13,10 @@ module OpenSearch
   module API
     module Security
       module Actions
-        # Returns the authentication information.
+        # Returns or updates authentication information for the currently authenticated user.
         #
-        # @option args [String] :auth_type The type of current authentication request.
-        # @option args [Boolean] :verbose Indicates whether a verbose response should be returned.
+        # @option args [String] :auth_type The type of the current authentication request.
+        # @option args [Boolean] :verbose Whether to return a verbose response.
         def authinfo(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/security/authtoken.rb

@@ -13,7 +13,7 @@ module OpenSearch
   module API
     module Security
       module Actions
-        # Returns the authorization token.
+        # Returns the authorization token for the current user.
         #
         def authtoken(args = {})
           args = Utils.clone_and_normalize_arguments(args)

data/lib/opensearch/api/actions/security/config_upgrade_check.rb

@@ -13,7 +13,7 @@ module OpenSearch
   module API
     module Security
       module Actions
-        # Check whether or not an upgrade can be performed and what resources can be updated.
+        # Checks whether or not an upgrade can be performed and which security resources can be updated.
         #
         def config_upgrade_check(args = {})
           args = Utils.clone_and_normalize_arguments(args)