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

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

@@ -4,8 +4,8 @@
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
 
-# This code was generated from OpenSearch API Spec.
-# Update the code generation logic instead of modifying this file directly.
+# 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
 
@@ -13,29 +13,24 @@ module OpenSearch
   module API
     module Security
       module Actions
-        CREATE_USER_QUERY_PARAMS = Set.new(%i[
-        ]).freeze
-
         # Creates or replaces the specified user.
         #
-        # @option arguments [String] :username *Required*
-        # @option arguments [Hash] :body *Required*
-        #
-        # {API Reference}[https://opensearch.org/docs/latest/security/access-control/api/#create-user]
-        def create_user(arguments = {})
-          raise ArgumentError, "Required argument 'username' missing" unless arguments[:username]
-          raise ArgumentError, "Required argument 'body' missing" unless arguments[:body]
+        # @option args [String] :username *Required* The name of the user to be created.
+        # @option args [Hash] :body *Required*
+        def create_user(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'username' missing" if args['username'].nil?
+          raise ArgumentError, "Required argument 'body' missing" if args['body'].nil?
 
-          arguments = arguments.clone
-          _username = arguments.delete(:username)
+          _username = args.delete('username')
 
-          headers = arguments.delete(:headers) || {}
-          body    = arguments.delete(:body)
-          url     = Utils.__pathify '_plugins', '_security', 'api', 'internalusers', _username
-          method  = OpenSearch::API::HTTP_PUT
-          params  = Utils.__validate_and_extract_params arguments, CREATE_USER_QUERY_PARAMS
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url('_plugins/_security/api/internalusers', _username)
 
-          perform_request(method, url, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
         end
       end
     end

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

@@ -0,0 +1,38 @@
+# 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 Security
+      module Actions
+        # Creates or replaces the specified user. Legacy API.
+        #
+        # @option args [String] :username *Required* The name of the user to be created.
+        # @option args [Hash] :body *Required*
+        def create_user_legacy(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'username' missing" if args['username'].nil?
+          raise ArgumentError, "Required argument 'body' missing" if args['body'].nil?
+
+          _username = args.delete('username')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'PUT'
+          url     = Utils.build_url('_plugins/_security/api/user', _username)
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

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

@@ -4,8 +4,8 @@
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
 
-# This code was generated from OpenSearch API Spec.
-# Update the code generation logic instead of modifying this file directly.
+# 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
 
@@ -13,27 +13,24 @@ module OpenSearch
   module API
     module Security
       module Actions
-        DELETE_ACTION_GROUP_QUERY_PARAMS = Set.new(%i[
-        ]).freeze
-
         # Delete a specified action group.
         #
-        # @option arguments [String] :action_group *Required* Action group to delete.
-        #
-        # {API Reference}[https://opensearch.org/docs/latest/security/access-control/api/#delete-action-group]
-        def delete_action_group(arguments = {})
-          raise ArgumentError, "Required argument 'action_group' missing" unless arguments[:action_group]
+        # @option args [String] :action_group *Required* The name of the action group to delete.
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_action_group(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'action_group' missing" if args['action_group'].nil?
 
-          arguments = arguments.clone
-          _action_group = arguments.delete(:action_group)
+          _action_group = args.delete('action_group')
 
-          headers = arguments.delete(:headers) || {}
-          body    = arguments.delete(:body)
-          url     = Utils.__pathify '_plugins', '_security', 'api', 'actiongroups', _action_group
-          method  = OpenSearch::API::HTTP_DELETE
-          params  = Utils.__validate_and_extract_params arguments, DELETE_ACTION_GROUP_QUERY_PARAMS
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = Utils.build_url('_plugins/_security/api/actiongroups', _action_group)
 
-          perform_request(method, url, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
         end
       end
     end

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

@@ -0,0 +1,38 @@
+# 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 Security
+      module Actions
+        # Deletes all distinguished names in the specified cluster or node allow list. Only accessible to super-admins and with rest-api permissions when enabled.
+        #
+        # @option args [String] :cluster_name *Required* The cluster-name to delete from list of distinguished names.
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_distinguished_name(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'cluster_name' missing" if args['cluster_name'].nil?
+
+          _cluster_name = args.delete('cluster_name')
+
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = Utils.build_url('_plugins/_security/api/nodesdn', _cluster_name)
+
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+        end
+      end
+    end
+  end
+end

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

@@ -4,8 +4,8 @@
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
 
-# This code was generated from OpenSearch API Spec.
-# Update the code generation logic instead of modifying this file directly.
+# 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
 
@@ -13,27 +13,24 @@ module OpenSearch
   module API
     module Security
       module Actions
-        DELETE_ROLE_QUERY_PARAMS = Set.new(%i[
-        ]).freeze
-
         # Delete the specified role.
         #
-        # @option arguments [String] :role *Required*
-        #
-        # {API Reference}[https://opensearch.org/docs/latest/security/access-control/api/#delete-role]
-        def delete_role(arguments = {})
-          raise ArgumentError, "Required argument 'role' missing" unless arguments[:role]
+        # @option args [String] :role *Required* The name of the role to delete.
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_role(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'role' missing" if args['role'].nil?
 
-          arguments = arguments.clone
-          _role = arguments.delete(:role)
+          _role = args.delete('role')
 
-          headers = arguments.delete(:headers) || {}
-          body    = arguments.delete(:body)
-          url     = Utils.__pathify '_plugins', '_security', 'api', 'roles', _role
-          method  = OpenSearch::API::HTTP_DELETE
-          params  = Utils.__validate_and_extract_params arguments, DELETE_ROLE_QUERY_PARAMS
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = Utils.build_url('_plugins/_security/api/roles', _role)
 
-          perform_request(method, url, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
         end
       end
     end

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

@@ -4,8 +4,8 @@
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
 
-# This code was generated from OpenSearch API Spec.
-# Update the code generation logic instead of modifying this file directly.
+# 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
 
@@ -13,27 +13,24 @@ module OpenSearch
   module API
     module Security
       module Actions
-        DELETE_ROLE_MAPPING_QUERY_PARAMS = Set.new(%i[
-        ]).freeze
-
         # Deletes the specified role mapping.
         #
-        # @option arguments [String] :role *Required*
-        #
-        # {API Reference}[https://opensearch.org/docs/latest/security/access-control/api/#delete-role-mapping]
-        def delete_role_mapping(arguments = {})
-          raise ArgumentError, "Required argument 'role' missing" unless arguments[:role]
+        # @option args [String] :role *Required* The name of the role whose mapping needs to delete.
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_role_mapping(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'role' missing" if args['role'].nil?
 
-          arguments = arguments.clone
-          _role = arguments.delete(:role)
+          _role = args.delete('role')
 
-          headers = arguments.delete(:headers) || {}
-          body    = arguments.delete(:body)
-          url     = Utils.__pathify '_plugins', '_security', 'api', 'rolesmapping', _role
-          method  = OpenSearch::API::HTTP_DELETE
-          params  = Utils.__validate_and_extract_params arguments, DELETE_ROLE_MAPPING_QUERY_PARAMS
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = Utils.build_url('_plugins/_security/api/rolesmapping', _role)
 
-          perform_request(method, url, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
         end
       end
     end

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

@@ -4,8 +4,8 @@
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
 
-# This code was generated from OpenSearch API Spec.
-# Update the code generation logic instead of modifying this file directly.
+# 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
 
@@ -13,27 +13,24 @@ module OpenSearch
   module API
     module Security
       module Actions
-        DELETE_TENANT_QUERY_PARAMS = Set.new(%i[
-        ]).freeze
-
         # Delete the specified tenant.
         #
-        # @option arguments [String] :tenant *Required*
-        #
-        # {API Reference}[https://opensearch.org/docs/latest/security/access-control/api/#delete-action-group]
-        def delete_tenant(arguments = {})
-          raise ArgumentError, "Required argument 'tenant' missing" unless arguments[:tenant]
+        # @option args [String] :tenant *Required* The name of the tenant to delete.
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_tenant(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'tenant' missing" if args['tenant'].nil?
 
-          arguments = arguments.clone
-          _tenant = arguments.delete(:tenant)
+          _tenant = args.delete('tenant')
 
-          headers = arguments.delete(:headers) || {}
-          body    = arguments.delete(:body)
-          url     = Utils.__pathify '_plugins', '_security', 'api', 'tenants', _tenant
-          method  = OpenSearch::API::HTTP_DELETE
-          params  = Utils.__validate_and_extract_params arguments, DELETE_TENANT_QUERY_PARAMS
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = Utils.build_url('_plugins/_security/api/tenants', _tenant)
 
-          perform_request(method, url, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
         end
       end
     end

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

@@ -4,8 +4,8 @@
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
 
-# This code was generated from OpenSearch API Spec.
-# Update the code generation logic instead of modifying this file directly.
+# 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
 
@@ -13,27 +13,24 @@ module OpenSearch
   module API
     module Security
       module Actions
-        DELETE_USER_QUERY_PARAMS = Set.new(%i[
-        ]).freeze
-
         # Delete the specified user.
         #
-        # @option arguments [String] :username *Required*
-        #
-        # {API Reference}[https://opensearch.org/docs/latest/security/access-control/api/#delete-user]
-        def delete_user(arguments = {})
-          raise ArgumentError, "Required argument 'username' missing" unless arguments[:username]
+        # @option args [String] :username *Required* The name of the user to delete.
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_user(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'username' missing" if args['username'].nil?
 
-          arguments = arguments.clone
-          _username = arguments.delete(:username)
+          _username = args.delete('username')
 
-          headers = arguments.delete(:headers) || {}
-          body    = arguments.delete(:body)
-          url     = Utils.__pathify '_plugins', '_security', 'api', 'internalusers', _username
-          method  = OpenSearch::API::HTTP_DELETE
-          params  = Utils.__validate_and_extract_params arguments, DELETE_USER_QUERY_PARAMS
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = Utils.build_url('_plugins/_security/api/internalusers', _username)
 
-          perform_request(method, url, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
         end
       end
     end

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

@@ -0,0 +1,38 @@
+# 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 Security
+      module Actions
+        # Delete the specified user. Legacy API.
+        #
+        # @option args [String] :username *Required* The name of the user to delete.
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def delete_user_legacy(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'username' missing" if args['username'].nil?
+
+          _username = args.delete('username')
+
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = Utils.build_url('_plugins/_security/api/user', _username)
+
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+        end
+      end
+    end
+  end
+end

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

@@ -4,8 +4,8 @@
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
 
-# This code was generated from OpenSearch API Spec.
-# Update the code generation logic instead of modifying this file directly.
+# 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
 
@@ -13,22 +13,19 @@ module OpenSearch
   module API
     module Security
       module Actions
-        FLUSH_CACHE_QUERY_PARAMS = Set.new(%i[
-        ]).freeze
-
         # Flushes the Security plugin user, authentication, and authorization cache.
         #
-        #
-        # {API Reference}[https://opensearch.org/docs/2.7/security/access-control/api/#flush-cache]
-        def flush_cache(arguments = {})
-          arguments = arguments.clone
-          headers = arguments.delete(:headers) || {}
-          body    = arguments.delete(:body)
-          url     = Utils.__pathify '_plugins', '_security', 'api', 'cache'
-          method  = OpenSearch::API::HTTP_DELETE
-          params  = Utils.__validate_and_extract_params arguments, FLUSH_CACHE_QUERY_PARAMS
+        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
+        def flush_cache(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          ignore  = args.delete('ignore') || []
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'DELETE'
+          url     = '_plugins/_security/api/cache'
 
-          perform_request(method, url, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
         end
       end
     end

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

@@ -0,0 +1,34 @@
+# 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 Security
+      module Actions
+        # Generates On-Behalf-Of token for the current user.
+        #
+        # @option args [Hash] :body *Required*
+        def generate_obo_token(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'body' missing" if args['body'].nil?
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = '_plugins/_security/api/generateonbehalfoftoken'
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# 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 Security
+      module Actions
+        # Generates authorization token for the given user.
+        #
+        # @option args [String] :username *Required* The name of the user for whom an auth token is to be vended.
+        def generate_user_token(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'username' missing" if args['username'].nil?
+
+          _username = args.delete('username')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = Utils.build_url('_plugins/_security/api/internalusers', _username, 'authtoken')
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,36 @@
+# 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 Security
+      module Actions
+        # Generates authorization token for the given user. Legacy API. Not Implemented.
+        #
+        # @option args [String] :username *Required* The name of the user for whom an auth token is to be vended.
+        def generate_user_token_legacy(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          raise ArgumentError, "Required argument 'username' missing" if args['username'].nil?
+
+          _username = args.delete('username')
+
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'POST'
+          url     = Utils.build_url('_plugins/_security/api/user', _username, 'authtoken')
+
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
+        end
+      end
+    end
+  end
+end

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

@@ -4,8 +4,8 @@
 # this file be licensed under the Apache-2.0 license or a
 # compatible open source license.
 
-# This code was generated from OpenSearch API Spec.
-# Update the code generation logic instead of modifying this file directly.
+# 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
 
@@ -13,22 +13,17 @@ module OpenSearch
   module API
     module Security
       module Actions
-        GET_ACCOUNT_DETAILS_QUERY_PARAMS = Set.new(%i[
-        ]).freeze
-
         # Returns account details for the current user.
         #
-        #
-        # {API Reference}[https://opensearch.org/docs/latest/security/access-control/api/#get-account-details]
-        def get_account_details(arguments = {})
-          arguments = arguments.clone
-          headers = arguments.delete(:headers) || {}
-          body    = arguments.delete(:body)
-          url     = Utils.__pathify '_plugins', '_security', 'api', 'account'
-          method  = OpenSearch::API::HTTP_GET
-          params  = Utils.__validate_and_extract_params arguments, GET_ACCOUNT_DETAILS_QUERY_PARAMS
+        def get_account_details(args = {})
+          args = Utils.clone_and_normalize_arguments(args)
+          headers = args.delete('headers') || {}
+          body    = args.delete('body')
+          method  = 'GET'
+          url     = '_plugins/_security/api/account'
 
-          perform_request(method, url, params, body, headers).body
+          Utils.validate_query_params! args
+          transport.perform_request(method, url, args, body, headers).body
         end
       end
     end