elastic-enterprise-search 7.16.0 → 8.0.0

data/elastic-enterprise-search.gemspec

@@ -22,7 +22,7 @@ require 'elastic/enterprise-search/version'
 
 # rubocop:disable Metrics/BlockLength
 Gem::Specification.new do |s|
-  s.required_ruby_version = '>= 2.5'
+  s.required_ruby_version = '>= 2.6'
   s.name        = 'elastic-enterprise-search'
   s.version     = Elastic::EnterpriseSearch::VERSION
   s.authors     = ['Fernando Briano']
@@ -47,13 +47,13 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
   s.require_paths = ['lib']
 
-  s.add_dependency 'elasticsearch-transport', '>= 7.11'
+  s.add_dependency 'elastic-transport', '8.0.0.pre.1'
   s.add_runtime_dependency 'jwt', '>= 1.5', '< 3.0'
   s.add_development_dependency 'awesome_print'
   s.add_development_dependency 'byebug' unless defined?(JRUBY_VERSION)
   s.add_development_dependency 'rspec', '~> 3.9.0'
   s.add_development_dependency 'rspec_junit_formatter'
-  s.add_development_dependency 'rubocop', '~> 1.0.0'
+  s.add_development_dependency 'rubocop', '~> 1'
   s.add_development_dependency 'vcr', '~> 3.0.3'
   s.add_development_dependency 'webmock'
 end

data/lib/elastic/api/response.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+# Licensed to Elasticsearch B.V. under one or more contributor
+# license agreements. See the NOTICE file distributed with
+# this work for additional information regarding copyright
+# ownership. Elasticsearch B.V. licenses this file to you under
+# the Apache License, Version 2.0 (the "License"); you may
+# not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+module Elastic
+  module API
+    # Elastic client API Response object. Receives an Elastic::Transport::Transport::Response in
+    # the initializer and behaves like a Hash, except when status or headers are called upon it, in
+    # which case it returns the original object's status and headers.
+    # This class is based on Elasticsearch::API::Response in the Elasticsearch client. For future
+    # versions, we'll want this to live in elastic-transport instead.
+    class Response
+      RESPONSE_METHODS = [:status, :body, :headers].freeze
+
+      def initialize(response)
+        @response = response
+      end
+
+      def method_missing(method, *args, &block)
+        if RESPONSE_METHODS.include? method
+          @response.send method.to_sym
+        else
+          @response.body.send(method.to_sym, *args, &block)
+        end
+      end
+
+      def respond_to_missing?(method_name, include_private = false)
+        @response.body.respond_to?(method_name, include_private) ||
+          RESPONSE_METHODS.include?(method_name)
+      end
+
+      def to_s
+        @response.body.to_s
+      end
+    end
+  end
+end

data/lib/elastic/app-search/api/adaptive_relevance_settings.rb

@@ -24,9 +24,8 @@ module Elastic
         # AdaptiveRelevanceSettings - Retrieve adaptive relevance settings
         # Retrieve adaptive relevance settings
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [Hash] :body The request body
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/adaptive-relevance-api-reference.html#adaptive-relevance-api-get-engine-adaptive-relevance-settings
@@ -34,14 +33,12 @@ module Elastic
         def adaptive_relevance_settings(engine_name, arguments = {})
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
 
-          body = arguments.delete(:body) || {}
           headers = arguments.delete(:headers) || {}
-
           request(
             :get,
             "api/as/v0/engines/#{engine_name}/adaptive_relevance/settings/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/adaptive_relevance_suggestions.rb

@@ -24,24 +24,28 @@ module Elastic
         # AdaptiveRelevanceSuggestions - Retrieve adaptive relevance
         # Retrieve adaptive relevance for a single query
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [String] :search_suggestion_query Query to obtain suggestions (*Required*)
         # @option arguments [Hash] :body
         # @option body :page
-        # @option body :filters
+        # @option body [string] :filters
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/adaptive-relevance-api-reference.html#adaptive-relevance-api-get-engine-adaptive-relevance-suggestions-query
         #
         def adaptive_relevance_suggestions(engine_name, arguments = {})
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
-          raise ArgumentError, "Required parameter 'search_suggestion_query' missing" unless arguments[:search_suggestion_query]
 
-          search_suggestion_query = arguments[:search_suggestion_query]
+          unless arguments[:search_suggestion_query]
+            raise ArgumentError,
+                  "Required parameter 'search_suggestion_query' missing"
+          end
+
+          search_suggestion_query = arguments.delete(:search_suggestion_query)
           body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
 
+          headers = arguments.delete(:headers) || {}
           request(
             :post,
             "api/as/v0/engines/#{engine_name}/adaptive_relevance/suggestions/#{search_suggestion_query}/",

data/lib/elastic/app-search/api/add_meta_engine_source.rb

@@ -24,20 +24,19 @@ module Elastic
         # Engines - Add a source engine
         # Adds a source engine to a given meta engine
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [Array] :source_engines List of engine names (*Required*)
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
+        # @option arguments [Array<String>] :source_engines
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/meta-engines.html#meta-engines-add-source-engines
         #
         def add_meta_engine_source(engine_name, arguments = {})
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
-          raise ArgumentError, "Required parameter 'source_engines' missing" unless arguments[:source_engines]
 
           source_engines = arguments.delete(:source_engines) || {}
-          headers = arguments.delete(:headers) || {}
 
+          headers = arguments.delete(:headers) || {}
           request(
             :post,
             "api/as/v1/engines/#{engine_name}/source_engines/",

data/lib/elastic/app-search/api/api_key.rb

@@ -24,9 +24,8 @@ module Elastic
         # Credentials - Retrieve an API key
         # Retrieves details of an API key
         #
-        # @param arguments [Hash] endpoint arguments
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [String] :api_key_name Name of an API key (*Required*)
-        # @option arguments [Hash] :body The request body
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/credentials.html#credentials-single
@@ -34,15 +33,14 @@ module Elastic
         def api_key(arguments = {})
           raise ArgumentError, "Required parameter 'api_key_name' missing" unless arguments[:api_key_name]
 
-          api_key_name = arguments[:api_key_name]
-          body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
+          api_key_name = arguments.delete(:api_key_name)
 
+          headers = arguments.delete(:headers) || {}
           request(
             :get,
             "api/as/v1/credentials/#{api_key_name}/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/api_logs.rb

@@ -24,31 +24,24 @@ module Elastic
         # APILogs - Retrieve API logs
         # The API Log displays API request and response data at the Engine level
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [Date] :from_date Filter date from (*Required*)
-        # @option arguments [Date] :to_date Filter date to (*Required*)
-        # @option arguments [Hash] :body
-        # @option body [String] :query You can search over the full_request_path of an API Log event. Use this to specify a particular endpoint, like analytics, search, curations and so on.
-        # @option body [String] :sort_direction Would you like to have your results ascending, oldest to newest, or descending, newest to oldest? Accepts asc or desc. Defaults to ascending.
-        # @option body [Integer] :page current for current page, total_pages for the net number of pages, total_results for the overall number of results, size for the amount of results per page.
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
+        # @option arguments [Hash] :body (Required: filters)
         # @option body :filters
-        # @option filters [String] :status Filter based on a particular status code: 400, 401, 403, 429, 200
-        # @option filters [String] :method Filter based on a particular HTTP method: GET, POST, PUT, PATCH, DELETE
+        # @option body :page
+        # @option body [string] :query
+        # @option body :sort_direction
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/api-logs.html
         #
         def api_logs(engine_name, arguments = {})
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
-          raise ArgumentError, "Required parameter 'from_date' missing" unless arguments[:from_date]
-          raise ArgumentError, "Required parameter 'to_date' missing" unless arguments[:to_date]
+          raise ArgumentError, "Required parameter 'body (filters)' missing" unless arguments[:body]
 
           body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
-          arguments['filters[date][from]'] = date_to_rfc3339(arguments.delete(:from_date))
-          arguments['filters[date][to]'] = date_to_rfc3339(arguments.delete(:to_date))
 
+          headers = arguments.delete(:headers) || {}
           request(
             :post,
             "api/as/v1/engines/#{engine_name}/logs/api/",

data/lib/elastic/app-search/api/count_analytics.rb

@@ -24,11 +24,11 @@ module Elastic
         # Analytics - Query for analytics counts data
         # Returns the number of clicks and total number of queries over a period
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [Hash] :body
-        # @option body :filters Analytics filters
-        # @option body [String] :interval You can define an interval along with your date range. Can be either hour or day
+        # @option body :filters
+        # @option body [string] :interval
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/counts.html
@@ -37,8 +37,8 @@ module Elastic
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
 
           body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
 
+          headers = arguments.delete(:headers) || {}
           request(
             :post,
             "api/as/v1/engines/#{engine_name}/analytics/counts/",

data/lib/elastic/app-search/api/crawler_active_crawl_request.rb

@@ -24,9 +24,8 @@ module Elastic
         # Crawler - Get active crawl request details
         # Returns active crawl request details.
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [Hash] :body The request body
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-get-crawler-crawl-requests-active
@@ -34,14 +33,12 @@ module Elastic
         def crawler_active_crawl_request(engine_name, arguments = {})
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
 
-          body = arguments.delete(:body) || {}
           headers = arguments.delete(:headers) || {}
-
           request(
             :get,
-            "api/as/v0/engines/#{engine_name}/crawler/crawl_requests/active/",
+            "api/as/v1/engines/#{engine_name}/crawler/crawl_requests/active/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/crawler_crawl_request.rb

@@ -24,10 +24,9 @@ module Elastic
         # Crawler - Get crawl request details
         # Returns crawl request details.
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [String] :crawl_request_id Crawl Request ID (*Required*)
-        # @option arguments [Hash] :body The request body
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-get-crawler-crawl-requests-id
@@ -36,15 +35,14 @@ module Elastic
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
           raise ArgumentError, "Required parameter 'crawl_request_id' missing" unless arguments[:crawl_request_id]
 
-          crawl_request_id = arguments[:crawl_request_id]
-          body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
+          crawl_request_id = arguments.delete(:crawl_request_id)
 
+          headers = arguments.delete(:headers) || {}
           request(
             :get,
-            "api/as/v0/engines/#{engine_name}/crawler/crawl_requests/#{crawl_request_id}/",
+            "api/as/v1/engines/#{engine_name}/crawler/crawl_requests/#{crawl_request_id}/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/crawler_crawl_schedule.rb

@@ -24,9 +24,8 @@ module Elastic
         # Crawler - Get crawl schedule
         # Returns the current crawl schedule for a given engine
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [Hash] :body The request body
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-get-crawler-crawl-schedule
@@ -34,14 +33,12 @@ module Elastic
         def crawler_crawl_schedule(engine_name, arguments = {})
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
 
-          body = arguments.delete(:body) || {}
           headers = arguments.delete(:headers) || {}
-
           request(
             :get,
-            "api/as/v0/engines/#{engine_name}/crawler/crawl_schedule/",
+            "api/as/v1/engines/#{engine_name}/crawler/crawl_schedule/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/crawler_domain.rb

@@ -24,10 +24,9 @@ module Elastic
         # Crawler - Get domain configuration
         # Returns crawler domain configuration details
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [String] :domain_id Crawler Domain ID (*Required*)
-        # @option arguments [Hash] :body The request body
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-get-crawler-domain
@@ -36,15 +35,14 @@ module Elastic
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
           raise ArgumentError, "Required parameter 'domain_id' missing" unless arguments[:domain_id]
 
-          domain_id = arguments[:domain_id]
-          body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
+          domain_id = arguments.delete(:domain_id)
 
+          headers = arguments.delete(:headers) || {}
           request(
             :get,
-            "api/as/v0/engines/#{engine_name}/crawler/domains/#{domain_id}/",
+            "api/as/v1/engines/#{engine_name}/crawler/domains/#{domain_id}/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/crawler_domain_validation_result.rb

@@ -24,19 +24,20 @@ module Elastic
         # Crawler - Validate Domain with Crawler
         # Performs a number of checks on a given domain name to make sure it is ready to be crawled and ingested into App Search.
         #
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [String] :body
+        # @param [Hash] arguments endpoint arguments
+        # @option arguments [string] :body
+        # @option body [string] :url *Required*
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-post-crawler-validate-domain
         #
         def crawler_domain_validation_result(arguments = {})
           body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
 
+          headers = arguments.delete(:headers) || {}
           request(
             :post,
-            'api/as/v0/crawler/validate_url/',
+            'api/as/v1/crawler/validate_url/',
             arguments,
             body,
             headers

data/lib/elastic/app-search/api/crawler_metrics.rb

@@ -24,21 +24,18 @@ module Elastic
         # Crawler - Retrieve a snapshot of crawler metrics
         # Retrieves a momentary snapshot of key crawler metrics, including global and node-level crawler health
         #
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [Hash] :body The request body
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html
         #
         def crawler_metrics(arguments = {})
-          body = arguments.delete(:body) || {}
           headers = arguments.delete(:headers) || {}
-
           request(
             :get,
-            'api/as/v0/crawler/metrics/',
+            'api/as/v1/crawler/metrics/',
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/crawler_overview.rb

@@ -24,9 +24,8 @@ module Elastic
         # Crawler - Retrieve crawler configuration overview
         # Retrieves crawler configuration overview of a given engine, including configured domains
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [Hash] :body The request body
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-get-crawler
@@ -34,14 +33,12 @@ module Elastic
         def crawler_overview(engine_name, arguments = {})
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
 
-          body = arguments.delete(:body) || {}
           headers = arguments.delete(:headers) || {}
-
           request(
             :get,
-            "api/as/v0/engines/#{engine_name}/crawler/",
+            "api/as/v1/engines/#{engine_name}/crawler/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/crawler_process_crawl.rb

@@ -24,10 +24,9 @@ module Elastic
         # Crawler - Get process crawl details
         # Returns process crawl details.
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [String] :process_crawl_id Process Crawl identifier (*Required*)
-        # @option arguments [Hash] :body The request body
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-get-crawler-process-crawls-id
@@ -36,15 +35,14 @@ module Elastic
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
           raise ArgumentError, "Required parameter 'process_crawl_id' missing" unless arguments[:process_crawl_id]
 
-          process_crawl_id = arguments[:process_crawl_id]
-          body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
+          process_crawl_id = arguments.delete(:process_crawl_id)
 
+          headers = arguments.delete(:headers) || {}
           request(
             :get,
-            "api/as/v0/engines/#{engine_name}/crawler/process_crawls/#{process_crawl_id}/",
+            "api/as/v1/engines/#{engine_name}/crawler/process_crawls/#{process_crawl_id}/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/crawler_process_crawl_denied_urls.rb

@@ -24,10 +24,9 @@ module Elastic
         # Crawler - View denied urls for Process Crawl
         # Provides a sample list of urls identified for deletion by the given process crawl id.
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
         # @option arguments [String] :process_crawl_id Process Crawl identifier (*Required*)
-        # @option arguments [Hash] :body The request body
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-get-crawler-process-crawls-id-denied-urls
@@ -36,15 +35,14 @@ module Elastic
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
           raise ArgumentError, "Required parameter 'process_crawl_id' missing" unless arguments[:process_crawl_id]
 
-          process_crawl_id = arguments[:process_crawl_id]
-          body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
+          process_crawl_id = arguments.delete(:process_crawl_id)
 
+          headers = arguments.delete(:headers) || {}
           request(
             :get,
-            "api/as/v0/engines/#{engine_name}/crawler/process_crawls/#{process_crawl_id}/denied_urls/",
+            "api/as/v1/engines/#{engine_name}/crawler/process_crawls/#{process_crawl_id}/denied_urls/",
             arguments,
-            body,
+            nil,
             headers
           )
         end

data/lib/elastic/app-search/api/crawler_url_extraction_result.rb

@@ -24,10 +24,10 @@ module Elastic
         # Crawler - Extract content from a URL
         # Performs an HTTP request to a given URL and extracts content from the page using standard App Search Crawler extraction pipeline.
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [String] :body
-        # @option arguments [String] :url (*Required*)
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
+        # @option arguments [string] :body
+        # @option body [string] :url *Required*
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html
@@ -36,11 +36,11 @@ module Elastic
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
 
           body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
 
+          headers = arguments.delete(:headers) || {}
           request(
             :post,
-            "api/as/v0/engines/#{engine_name}/crawler/extract_url/",
+            "api/as/v1/engines/#{engine_name}/crawler/extract_url/",
             arguments,
             body,
             headers

data/lib/elastic/app-search/api/crawler_url_tracing_result.rb

@@ -24,9 +24,10 @@ module Elastic
         # Crawler - Trace a history of a crawled URL
         # Returns information about the history of a given URL with the App Search Crawler.
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [String] :body
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
+        # @option arguments [string] :body
+        # @option body [string] :url *Required*
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-post-crawler-trace-url
@@ -35,11 +36,11 @@ module Elastic
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
 
           body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
 
+          headers = arguments.delete(:headers) || {}
           request(
             :post,
-            "api/as/v0/engines/#{engine_name}/crawler/trace_url/",
+            "api/as/v1/engines/#{engine_name}/crawler/trace_url/",
             arguments,
             body,
             headers

data/lib/elastic/app-search/api/crawler_url_validation_result.rb

@@ -24,9 +24,10 @@ module Elastic
         # Crawler - Validate URL with Crawler
         # Performs a number of checks on a given URL to make sure it is ready to be crawled and ingested into App Search.
         #
-        # @param engine_name [String] Name of the engine (*Required*)
-        # @param arguments [Hash] endpoint arguments
-        # @option arguments [String] :body
+        # @param [String] engine_name Name of the engine (*Required*)
+        # @param [Hash] arguments endpoint arguments
+        # @option arguments [string] :body
+        # @option body [string] :url *Required*
         # @option arguments [Hash] :headers optional HTTP headers to send with the request
         #
         # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-post-crawler-validate-url
@@ -35,11 +36,11 @@ module Elastic
           raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
 
           body = arguments.delete(:body) || {}
-          headers = arguments.delete(:headers) || {}
 
+          headers = arguments.delete(:headers) || {}
           request(
             :post,
-            "api/as/v0/engines/#{engine_name}/crawler/validate_url/",
+            "api/as/v1/engines/#{engine_name}/crawler/validate_url/",
             arguments,
             body,
             headers