elastic-enterprise-search 8.1.1 → 8.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (134) hide show
  1. checksums.yaml +4 -4
  2. data/.ci/jobs/{elastic+enterprise-search-ruby+7.15.yml → elastic+enterprise-search-ruby+7.17.yml} +4 -4
  3. data/.ci/jobs/{elastic+enterprise-search-ruby+7.16.yml → elastic+enterprise-search-ruby+8.0.yml} +4 -4
  4. data/.ci/jobs/elastic+enterprise-search-ruby+8.1.yml +12 -0
  5. data/.ci/jobs/elastic+enterprise-search-ruby+8.2.yml +12 -0
  6. data/.ci/run-enterprise-search.sh +1 -0
  7. data/.ci/test-matrix.yml +1 -1
  8. data/docs/guide/app-search-api.asciidoc +21 -0
  9. data/docs/guide/connecting.asciidoc +14 -0
  10. data/docs/guide/enterprise-search-api.asciidoc +17 -2
  11. data/docs/guide/index.asciidoc +1 -1
  12. data/docs/guide/overview.asciidoc +4 -2
  13. data/docs/guide/release_notes/82.asciidoc +42 -0
  14. data/docs/guide/release_notes/index.asciidoc +3 -0
  15. data/elastic-enterprise-search.gemspec +1 -1
  16. data/lib/elastic/app-search/api/adaptive_relevance_settings.rb +1 -0
  17. data/lib/elastic/app-search/api/adaptive_relevance_suggestions.rb +2 -1
  18. data/lib/elastic/app-search/api/add_meta_engine_source.rb +1 -0
  19. data/lib/elastic/app-search/api/api_key.rb +1 -0
  20. data/lib/elastic/app-search/api/api_logs.rb +1 -0
  21. data/lib/elastic/app-search/api/count_analytics.rb +1 -0
  22. data/lib/elastic/app-search/api/crawler_active_crawl_request.rb +1 -0
  23. data/lib/elastic/app-search/api/crawler_crawl_request.rb +1 -0
  24. data/lib/elastic/app-search/api/crawler_crawl_schedule.rb +1 -0
  25. data/lib/elastic/app-search/api/crawler_domain.rb +1 -0
  26. data/lib/elastic/app-search/api/crawler_domain_validation_result.rb +1 -0
  27. data/lib/elastic/app-search/api/crawler_metrics.rb +1 -0
  28. data/lib/elastic/app-search/api/crawler_overview.rb +1 -0
  29. data/lib/elastic/app-search/api/crawler_process_crawl.rb +1 -0
  30. data/lib/elastic/app-search/api/crawler_process_crawl_denied_urls.rb +1 -0
  31. data/lib/elastic/app-search/api/crawler_url_extraction_result.rb +1 -0
  32. data/lib/elastic/app-search/api/crawler_url_tracing_result.rb +1 -0
  33. data/lib/elastic/app-search/api/crawler_url_validation_result.rb +1 -0
  34. data/lib/elastic/app-search/api/crawler_user_agent.rb +1 -0
  35. data/lib/elastic/app-search/api/create_api_key.rb +1 -0
  36. data/lib/elastic/app-search/api/create_crawler_crawl_request.rb +1 -0
  37. data/lib/elastic/app-search/api/create_crawler_crawl_rule.rb +1 -0
  38. data/lib/elastic/app-search/api/create_crawler_domain.rb +1 -0
  39. data/lib/elastic/app-search/api/create_crawler_entry_point.rb +1 -0
  40. data/lib/elastic/app-search/api/create_crawler_process_crawl.rb +1 -0
  41. data/lib/elastic/app-search/api/create_crawler_sitemap.rb +1 -0
  42. data/lib/elastic/app-search/api/create_curation.rb +2 -1
  43. data/lib/elastic/app-search/api/create_engine.rb +1 -0
  44. data/lib/elastic/app-search/api/create_synonym_set.rb +1 -0
  45. data/lib/elastic/app-search/api/curation.rb +1 -0
  46. data/lib/elastic/app-search/api/delete_api_key.rb +1 -0
  47. data/lib/elastic/app-search/api/delete_crawler_active_crawl_request.rb +1 -0
  48. data/lib/elastic/app-search/api/delete_crawler_crawl_rule.rb +1 -0
  49. data/lib/elastic/app-search/api/delete_crawler_crawl_schedule.rb +1 -0
  50. data/lib/elastic/app-search/api/delete_crawler_domain.rb +1 -0
  51. data/lib/elastic/app-search/api/delete_crawler_entry_point.rb +1 -0
  52. data/lib/elastic/app-search/api/delete_crawler_sitemap.rb +1 -0
  53. data/lib/elastic/app-search/api/delete_curation.rb +1 -0
  54. data/lib/elastic/app-search/api/delete_documents.rb +1 -0
  55. data/lib/elastic/app-search/api/delete_engine.rb +1 -0
  56. data/lib/elastic/app-search/api/delete_meta_engine_source.rb +1 -0
  57. data/lib/elastic/app-search/api/delete_synonym_set.rb +1 -0
  58. data/lib/elastic/app-search/api/documents.rb +1 -0
  59. data/lib/elastic/app-search/api/engine.rb +1 -0
  60. data/lib/elastic/app-search/api/index_documents.rb +1 -0
  61. data/lib/elastic/app-search/api/list_adaptive_relevance_suggestions.rb +2 -1
  62. data/lib/elastic/app-search/api/list_api_keys.rb +1 -0
  63. data/lib/elastic/app-search/api/list_crawler_crawl_requests.rb +1 -0
  64. data/lib/elastic/app-search/api/list_crawler_domains.rb +1 -0
  65. data/lib/elastic/app-search/api/list_crawler_process_crawls.rb +1 -0
  66. data/lib/elastic/app-search/api/list_curations.rb +1 -0
  67. data/lib/elastic/app-search/api/list_documents.rb +1 -0
  68. data/lib/elastic/app-search/api/list_engines.rb +1 -0
  69. data/lib/elastic/app-search/api/list_synonym_sets.rb +1 -0
  70. data/lib/elastic/app-search/api/log_clickthrough.rb +1 -0
  71. data/lib/elastic/app-search/api/multi_search.rb +8 -6
  72. data/lib/elastic/app-search/api/put_adaptive_relevance_settings.rb +2 -1
  73. data/lib/elastic/app-search/api/put_adaptive_relevance_suggestions.rb +1 -0
  74. data/lib/elastic/app-search/api/put_api_key.rb +1 -0
  75. data/lib/elastic/app-search/api/put_crawler_crawl_rule.rb +1 -0
  76. data/lib/elastic/app-search/api/put_crawler_crawl_schedule.rb +1 -0
  77. data/lib/elastic/app-search/api/put_crawler_domain.rb +1 -0
  78. data/lib/elastic/app-search/api/put_crawler_entry_point.rb +1 -0
  79. data/lib/elastic/app-search/api/put_crawler_sitemap.rb +1 -0
  80. data/lib/elastic/app-search/api/put_curation.rb +2 -1
  81. data/lib/elastic/app-search/api/put_documents.rb +1 -0
  82. data/lib/elastic/app-search/api/put_schema.rb +1 -0
  83. data/lib/elastic/app-search/api/put_search_settings.rb +1 -0
  84. data/lib/elastic/app-search/api/put_synonym_set.rb +1 -0
  85. data/lib/elastic/app-search/api/query_suggestion.rb +1 -0
  86. data/lib/elastic/app-search/api/refresh_adaptive_relevance_update_process.rb +1 -0
  87. data/lib/elastic/app-search/api/reset_search_settings.rb +1 -0
  88. data/lib/elastic/app-search/api/schema.rb +1 -0
  89. data/lib/elastic/app-search/api/search.rb +1 -0
  90. data/lib/elastic/app-search/api/search_es_search.rb +54 -0
  91. data/lib/elastic/app-search/api/search_explain.rb +62 -0
  92. data/lib/elastic/app-search/api/search_settings.rb +1 -0
  93. data/lib/elastic/app-search/api/synonym_set.rb +1 -0
  94. data/lib/elastic/app-search/api/top_clicks_analytics.rb +1 -0
  95. data/lib/elastic/app-search/api/top_queries_analytics.rb +1 -0
  96. data/lib/elastic/enterprise-search/api/health.rb +1 -0
  97. data/lib/elastic/enterprise-search/api/put_read_only.rb +1 -0
  98. data/lib/elastic/enterprise-search/api/read_only.rb +1 -0
  99. data/lib/elastic/enterprise-search/api/search_engines.rb +44 -0
  100. data/lib/elastic/enterprise-search/api/stats.rb +1 -0
  101. data/lib/elastic/enterprise-search/api/version.rb +2 -1
  102. data/lib/elastic/enterprise-search/version.rb +1 -1
  103. data/lib/elastic/workplace-search/api/auto_query_refinement_details.rb +1 -0
  104. data/lib/elastic/workplace-search/api/command_sync_jobs.rb +1 -0
  105. data/lib/elastic/workplace-search/api/content_source.rb +1 -0
  106. data/lib/elastic/workplace-search/api/create_analytics_event.rb +1 -0
  107. data/lib/elastic/workplace-search/api/create_batch_synonym_sets.rb +1 -0
  108. data/lib/elastic/workplace-search/api/create_content_source.rb +1 -0
  109. data/lib/elastic/workplace-search/api/create_external_identity.rb +1 -0
  110. data/lib/elastic/workplace-search/api/current_user.rb +1 -0
  111. data/lib/elastic/workplace-search/api/delete_content_source.rb +1 -0
  112. data/lib/elastic/workplace-search/api/delete_documents.rb +1 -0
  113. data/lib/elastic/workplace-search/api/delete_documents_by_query.rb +1 -0
  114. data/lib/elastic/workplace-search/api/delete_external_identity.rb +1 -0
  115. data/lib/elastic/workplace-search/api/delete_synonym_set.rb +1 -0
  116. data/lib/elastic/workplace-search/api/document.rb +1 -0
  117. data/lib/elastic/workplace-search/api/external_identity.rb +1 -0
  118. data/lib/elastic/workplace-search/api/index_documents.rb +1 -0
  119. data/lib/elastic/workplace-search/api/list_content_sources.rb +1 -0
  120. data/lib/elastic/workplace-search/api/list_documents.rb +1 -0
  121. data/lib/elastic/workplace-search/api/list_external_identities.rb +1 -0
  122. data/lib/elastic/workplace-search/api/list_synonym_sets.rb +1 -0
  123. data/lib/elastic/workplace-search/api/put_content_source.rb +1 -0
  124. data/lib/elastic/workplace-search/api/put_content_source_icons.rb +1 -0
  125. data/lib/elastic/workplace-search/api/put_external_identity.rb +1 -0
  126. data/lib/elastic/workplace-search/api/put_synonym_set.rb +1 -0
  127. data/lib/elastic/workplace-search/api/put_triggers_blocklist.rb +1 -0
  128. data/lib/elastic/workplace-search/api/search.rb +1 -0
  129. data/lib/elastic/workplace-search/api/synonym_set.rb +1 -0
  130. data/lib/elastic/workplace-search/api/triggers_blocklist.rb +1 -0
  131. data/spec/integration/app-search/elasticsearch_search_spec.rb +63 -0
  132. data/spec/integration/app-search/explain_search_spec.rb +59 -0
  133. data/spec/integration/enterprise_search_api_spec.rb +11 -0
  134. metadata +16 -8
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 7c6b7f543ecfbb56fa72e108d6c86b8aad6c4185e14654ab1e32cc739054073e
4
- data.tar.gz: b4692ff93dd20556e6dd8e758577c107c02c2ed0b114bab15aad094ace4dba37
3
+ metadata.gz: 95fb62ab62fbcabaccdcdbebc1b8caf15fbfe6ca1cec388af5778da738ce0aff
4
+ data.tar.gz: 1ce82e08b5ab98ea8a0ea47076806b709e765b98b01d6ecb1c1a3284b3660922
5
5
  SHA512:
6
- metadata.gz: 428fc9ca35fcf144bf83e8ed51d71901f5faf6f8b933c6c5118d95af3aea859b14307c7473b891f49538890f127bfcc5c7980c04531c93ae7f5b22f99a056b72
7
- data.tar.gz: 2dde8ce3996c9a6b0ee7e5fef81000ea9397c5c4c1ae0b54e3b61b8fb604508c1727cf61cf4a6ee87c86090e088e8d19e2a02effec877e637e76af74724109e6
6
+ metadata.gz: 6681c1fb77c29e120cc726345bc97e244aada238720255ad375bf8e6447beb31b4bbeb6283f4153196c6be42f8a807e1b234dd3caa064d5d2fd4da021965e800
7
+ data.tar.gz: df33f6629dcf8b0ec537b47619fbcce2327cb715a69536df22ed6693429948874c49f2728504a0ae11c351d73020865f77e42ca3addfe0226ba7e1ce570da021
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  - job:
3
- name: elastic+enterprise-search-ruby+7.15
4
- display-name: 'elastic / enterprise-search-ruby # 7.15'
5
- description: Testing the enterprise-search-ruby 7.15 branch.
3
+ name: elastic+enterprise-search-ruby+7.17
4
+ display-name: 'elastic / enterprise-search-ruby # 7.17'
5
+ description: Testing the enterprise-search-ruby 7.17 branch.
6
6
  junit_results: "*-junit.xml"
7
7
  parameters:
8
8
  - string:
9
9
  name: branch_specifier
10
- default: refs/heads/7.15
10
+ default: refs/heads/7.17
11
11
  description: the Git branch specifier to build (<branchName>, <tagName>,
12
12
  <commitId>, etc.)
@@ -1,12 +1,12 @@
1
1
  ---
2
2
  - job:
3
- name: elastic+enterprise-search-ruby+7.16
4
- display-name: 'elastic / enterprise-search-ruby # 7.16'
5
- description: Testing the enterprise-search-ruby 7.16 branch.
3
+ name: elastic+enterprise-search-ruby+8.0
4
+ display-name: 'elastic / enterprise-search-ruby # 8.0'
5
+ description: Testing the enterprise-search-ruby 8.0 branch.
6
6
  junit_results: "*-junit.xml"
7
7
  parameters:
8
8
  - string:
9
9
  name: branch_specifier
10
- default: refs/heads/7.16
10
+ default: refs/heads/8.0
11
11
  description: the Git branch specifier to build (<branchName>, <tagName>,
12
12
  <commitId>, etc.)
@@ -0,0 +1,12 @@
1
+ ---
2
+ - job:
3
+ name: elastic+enterprise-search-ruby+8.1
4
+ display-name: 'elastic / enterprise-search-ruby # 8.1'
5
+ description: Testing the enterprise-search-ruby 8.1 branch.
6
+ junit_results: "*-junit.xml"
7
+ parameters:
8
+ - string:
9
+ name: branch_specifier
10
+ default: refs/heads/8.1
11
+ description: the Git branch specifier to build (<branchName>, <tagName>,
12
+ <commitId>, etc.)
@@ -0,0 +1,12 @@
1
+ ---
2
+ - job:
3
+ name: elastic+enterprise-search-ruby+8.2
4
+ display-name: 'elastic / enterprise-search-ruby # 8.2'
5
+ description: Testing the enterprise-search-ruby 8.2 branch.
6
+ junit_results: "*-junit.xml"
7
+ parameters:
8
+ - string:
9
+ name: branch_specifier
10
+ default: refs/heads/8.2
11
+ description: the Git branch specifier to build (<branchName>, <tagName>,
12
+ <commitId>, etc.)
@@ -54,6 +54,7 @@ docker run \
54
54
  --env "elasticsearch.ssl.certificate=/usr/share/app-search/config/certs/testnode.crt" \
55
55
  --env "elasticsearch.ssl.certificate_authority=/usr/share/app-search/config/certs/ca.crt" \
56
56
  --env "elasticsearch.ssl.key=/usr/share/app-search/config/certs/testnode.key" \
57
+ --env "ELASTICSEARCH_SEARCH_API=true" \
57
58
  --volume $ssl_cert:/usr/share/app-search/config/certs/testnode.crt \
58
59
  --volume $ssl_key:/usr/share/app-search/config/certs/testnode.key \
59
60
  --volume $ssl_ca:/usr/share/app-search/config/certs/ca.crt \
data/.ci/test-matrix.yml CHANGED
@@ -5,7 +5,7 @@ RUBY_VERSION:
5
5
  - 2.7
6
6
 
7
7
  STACK_VERSION:
8
- - 8.1-SNAPSHOT
8
+ - 8.3-SNAPSHOT
9
9
 
10
10
  SERVICE:
11
11
  - appsearch
@@ -336,6 +336,27 @@ client.put_adaptive_relevance_settings(engine_name, body: body)
336
336
  client.refresh_adaptive_relevance_update_process(engine_name, adaptive_relevance_suggestion_type: 'curation')
337
337
  ----------------------------
338
338
 
339
+ === Elasticsearch Search
340
+
341
+ Utilize the API to passthrough and execute raw Elasticsearch queries against the indices that power Enterprise Search engines.
342
+
343
+ [source,rb]
344
+ ----------------------------
345
+ es_request = { body: { query: { bool: { must: { term: { title: 'test' } } } } } }
346
+ client.search_es_search(engine_name, body: { request: es_request })
347
+ ----------------------------
348
+
349
+ === Search Explain
350
+
351
+ Submit a search and retrieve an Elasticsearch query.
352
+
353
+ [source,rb]
354
+ ----------------------------
355
+ response = client.search_explain(engine_name, body: { query: 'test' })
356
+ response.body['query_string']
357
+ # => "GET enterprise-search-engine-app-search-explain/_search"
358
+ ----------------------------
359
+
339
360
  === Other API Endpoints
340
361
 
341
362
  [source,rb]
@@ -7,6 +7,7 @@ This page contains the information you need to connect and use the Client with E
7
7
 
8
8
  * <<authentication>>
9
9
  * <<custom_headers>>
10
+ * <<transport>>
10
11
 
11
12
 
12
13
  [discrete]
@@ -168,3 +169,16 @@ workplace_search_client.index_documents(
168
169
  { body: documents, headers: headers }
169
170
  )
170
171
  ----------------------------
172
+
173
+ [discrete]
174
+ [[transport]]
175
+ === Transport
176
+
177
+ The Enterprise Search Ruby client is powered by the https://github.com/elastic/elastic-transport-ruby/[`elastic-transport`] gem. You can read more about it https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/transport.html[here]. The client accepts a transport object as an initializer:
178
+
179
+ [source,rb]
180
+ ----------------------------
181
+ transport = Elastic::Transport::Transport::HTTP::Curb.new
182
+ ent_client = Elastic::EnterpriseSearch::Client.new(transport: transport)
183
+ ----------------------------
184
+
@@ -3,6 +3,8 @@
3
3
 
4
4
  === Health API
5
5
 
6
+ Get information on the health of a deployment and basic statistics around resource usage.
7
+
6
8
  [source,rb]
7
9
  ----------------------------
8
10
  > response = ent_client.health
@@ -17,6 +19,8 @@
17
19
 
18
20
  === Version API
19
21
 
22
+ Get version information for the server.
23
+
20
24
  [source,rb]
21
25
  ----------------------------
22
26
  > response = ent_client.version
@@ -29,14 +33,16 @@
29
33
  [source,rb]
30
34
  ----------------------------
31
35
  # Set read-only flag state
32
- ent_client.put_read_only(body: { enabled: false })
36
+ > ent_client.put_read_only(body: { enabled: false })
33
37
 
34
38
  # Get read-only flag state
35
- ent_client.read_only
39
+ > ent_client.read_only
36
40
  ----------------------------
37
41
 
38
42
  === Stats API
39
43
 
44
+ Get information about the resource usage of the application, the state of different internal queues, etc.
45
+
40
46
  [source,rb]
41
47
  ----------------------------
42
48
  > ent_client.stats.body
@@ -44,3 +50,12 @@ ent_client.read_only
44
50
  "queues"=>{"connectors"=>{...}, "document_destroyer"=>{...}, "engine_destroyer"=>{...}, "index_adder"=>{...}, ...},
45
51
  "connectors"=>{"alive"=>true, "pool"=>{...}, "job_store"=>{...}}}}
46
52
  ----------------------------
53
+
54
+ === Search Engines
55
+
56
+ Retrieve information about search engines
57
+
58
+ [source,rb]
59
+ ----------------------------
60
+ > ent_client.search_engines
61
+ ----------------------------
@@ -1,4 +1,4 @@
1
- = enterprise-search-ruby
1
+ = Enterprise Search Ruby client
2
2
 
3
3
  :doctype: book
4
4
 
@@ -10,7 +10,9 @@ Current development happens in the main branch.
10
10
 
11
11
  The library is compatible with all Elastic Enterprise Search versions since `7.x` but you **have to use a matching major version**:
12
12
 
13
- For **Elastic Enterprise Search 7.0** and later, use the major version 7 (`7.x.y`) of the library.
13
+ * For **Elastic Enterprise Search 7.0** and later, use the major version 7 (`7.x.y`) of the library.
14
+ * For **Elastic Enterprise Search 8.0** and later, use the major version 8 (`8.x.y`) of the library.
15
+
14
16
 
15
17
  [discrete]
16
18
  === HTTP Library
@@ -27,7 +29,7 @@ client = Elastic::EnterpriseSearch::Client.new(adapter: :net_http_persistent)
27
29
 
28
30
  All requests, if successful, will return an `Elastic::Transport::Transport::Response` instance. You can access the response `body`, `headers` and `status`.
29
31
 
30
- `elastic-transport` defines a https://github.com/elastic/elastic-transport-ruby/blob/main/lib/elastic/transport/transport/errors.rb[number of exception classes] for various client and server errors, as well as unsuccessful HTTP responses, making it possible to rescue specific exceptions with desired granularity. More details https://github.com/elastic/elastic-transport-ruby#exception-handling[here]. You can find the full documentation for `elastic-transport` at https://rubydoc.info/gems/elastic-transport[RubyDoc].
32
+ `elastic-transport` defines a https://github.com/elastic/elastic-transport-ruby/blob/main/lib/elastic/transport/transport/errors.rb[number of exception classes] for various client and server errors, as well as unsuccessful HTTP responses, making it possible to rescue specific exceptions with desired granularity. More details https://github.com/elastic/elastic-transport-ruby#exception-handling[here]. You can find the full documentation for `elastic-transport` at https://www.elastic.co/guide/en/elasticsearch/client/ruby-api/current/transport.html[our official documentation] and https://rubydoc.info/gems/elastic-transport[RubyDoc].
31
33
 
32
34
  The clients pass different options to transport, you can check them out https://rubydoc.info/github/elastic/enterprise-search-ruby/Elastic/EnterpriseSearch/Client[on RubyDocs].
33
35
 
@@ -0,0 +1,42 @@
1
+ [[release_notes_82]]
2
+ === 8.2 Release notes
3
+
4
+ [discrete]
5
+ [[release_notes_821]]
6
+ === 8.2.1 Release notes
7
+
8
+ - Adds tracer parameters to enable tracing in elastic-transport. See https://www.elastic.co/guide/en/enterprise-search-clients/ruby/current/overview.html#_logging[logging] for more information.
9
+ - Updates Workplace Search OAuth implementation. See https://www.elastic.co/guide/en/enterprise-search-clients/ruby/current/workplace-search-api.html#ws-oauth-authentication[OAuth Authentication] for changes in the OAuth process.
10
+
11
+ [discrete]
12
+ [[release_notes_820]]
13
+ === 8.2.0 Release notes
14
+
15
+ [discrete]
16
+ ==== General
17
+
18
+ - Tested with Elastic Enterprise Search API version 8.2.0.
19
+ - Tested with Ruby 2.7, 3.0, 3.1, JRuby 9.3. Older versions of Ruby have reached end of life and been removed from the testing matrices. Minimum required Ruby version is Ruby 2.6 to keep compatibility with JRuby 9.3, but it may be upgraded to 2.7 once JRuby 9.4 comes out.
20
+
21
+ [discrete]
22
+ ==== App Search
23
+ [discrete]
24
+ ==== New APIs
25
+
26
+ * Adds Elasticsearch Search API (In Technical Preview): Utilize the API to passthrough and execute raw Elasticsearch queries against the indices that power Enterprise Search engines.
27
+
28
+ +
29
+ [source,rb]
30
+ ----------------------------
31
+ es_request = { body: { query: { bool: { must: { term: { title: 'test' } } } } } }
32
+ client.search_es_search(engine_name, body: { request: es_request })
33
+ ----------------------------
34
+
35
+ * Adds Search Explain API: Submit a search and retrieve an Elasticsearch query.
36
+ +
37
+ [source,rb]
38
+ ----------------------------
39
+ response = client.search_explain(engine_name, body: { query: 'test' })
40
+ response.body['query_string']
41
+ # => "GET enterprise-search-engine-app-search-explain/_search"
42
+ ----------------------------
@@ -3,6 +3,8 @@
3
3
 
4
4
  [discrete]
5
5
  === 8.x
6
+
7
+ * <<release_notes_82, 8.2.0 Release Notes>>
6
8
  * <<release_notes_81, 8.1.0 Release Notes>>
7
9
  * <<release_notes_80, 8.0.0 Release Notes>>
8
10
 
@@ -18,6 +20,7 @@
18
20
  * <<release_notes_711, 7.11.0 Release Notes>>
19
21
  * <<release_notes_710, 7.10.0.beta.1 Release Notes>>
20
22
 
23
+ include::82.asciidoc[]
21
24
  include::81.asciidoc[]
22
25
  include::80.asciidoc[]
23
26
  include::717.asciidoc[]
@@ -47,7 +47,7 @@ Gem::Specification.new do |s|
47
47
  s.executables = `git ls-files -- bin/*`.split("\n").map { |f| File.basename(f) }
48
48
  s.require_paths = ['lib']
49
49
 
50
- s.add_dependency 'elastic-transport', '8.0.0.pre.1'
50
+ s.add_dependency 'elastic-transport', '~> 8'
51
51
  s.add_runtime_dependency 'jwt', '>= 1.5', '< 3.0'
52
52
  s.add_development_dependency 'awesome_print'
53
53
  s.add_development_dependency 'byebug' unless defined?(JRUBY_VERSION)
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # AdaptiveRelevanceSettings - Retrieve adaptive relevance settings
25
26
  # Retrieve adaptive relevance settings
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # AdaptiveRelevanceSuggestions - Retrieve adaptive relevance
25
26
  # Retrieve adaptive relevance for a single query
@@ -29,7 +30,7 @@ module Elastic
29
30
  # @option arguments [String] :search_suggestion_query Query to obtain suggestions (*Required*)
30
31
  # @option arguments [Hash] :body
31
32
  # @option body :page
32
- # @option body [string] :filters
33
+ # @option body [Hash] :filters
33
34
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
34
35
  #
35
36
  # @see https://www.elastic.co/guide/en/app-search/current/adaptive-relevance-api-reference.html#adaptive-relevance-api-get-engine-adaptive-relevance-suggestions-query
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Engines - Add a source engine
25
26
  # Adds a source engine to a given meta engine
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Credentials - Retrieve an API key
25
26
  # Retrieves details of an API key
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # APILogs - Retrieve API logs
25
26
  # The API Log displays API request and response data at the Engine level
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Analytics - Query for analytics counts data
25
26
  # Returns the number of clicks and total number of queries over a period
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Get active crawl request details
25
26
  # Returns active crawl request details.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Get crawl request details
25
26
  # Returns crawl request details.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Get crawl schedule
25
26
  # Returns the current crawl schedule for a given engine
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Get domain configuration
25
26
  # Returns crawler domain configuration details
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Validate Domain with Crawler
25
26
  # Performs a number of checks on a given domain name to make sure it is ready to be crawled and ingested into App Search.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Retrieve a snapshot of crawler metrics
25
26
  # Retrieves a momentary snapshot of key crawler metrics, including global and node-level crawler health
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Retrieve crawler configuration overview
25
26
  # Retrieves crawler configuration overview of a given engine, including configured domains
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Get process crawl details
25
26
  # Returns process crawl details.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - View denied urls for Process Crawl
25
26
  # Provides a sample list of urls identified for deletion by the given process crawl id.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Extract content from a URL
25
26
  # Performs an HTTP request to a given URL and extracts content from the page using standard App Search Crawler extraction pipeline.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Trace a history of a crawled URL
25
26
  # Returns information about the history of a given URL with the App Search Crawler.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Validate URL with Crawler
25
26
  # Performs a number of checks on a given URL to make sure it is ready to be crawled and ingested into App Search.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Get the User-Agent header value for the crawler
25
26
  # Retrieves the currently configured value for the User-Agent header used for all Crawler HTTP requests
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Credentials - Create an API key
25
26
  # Creates an App Search API key
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Create a crawl request
25
26
  # Creates a request to perform a crawl of a given engine with the Crawler.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Create a crawl rule
25
26
  # Creates a crawl rule for a given engine and domain
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Create a crawler domain
25
26
  # Creates a crawler domain configuration for a given engine
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Create a crawler entry point
25
26
  # Creates a crawler domain entry point for a given engine and domain
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Create a process crawl
25
26
  # Queues a task to reprocess crawled documents with current crawl configuration
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Create a crawler sitemap
25
26
  # Creates a crawler sitemap configuration for a given engine and domain
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Curations - Create a new curation
25
26
  # Create a new curation for the engine
@@ -31,7 +32,7 @@ module Elastic
31
32
  # @option body [Array<string>] :queries List of affected search queries
32
33
  # @option body [Array<string>] :promoted List of promoted document IDs
33
34
  # @option body [Array<string>] :hidden List of hidden document IDs
34
- # @option body [Hash] :suggestion
35
+ # @option body :suggestion
35
36
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
36
37
  #
37
38
  # @see https://www.elastic.co/guide/en/app-search/current/curations.html#curations-create
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Engines - Create an Engine
25
26
  # Creates an App Search Engine
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Synonyms - Create a synonym set
25
26
  # Creates a new synonym set for the engine
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Curations - Retrieve a curation
25
26
  # Retrieves a curation by ID
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Credentials - Delete an API key
25
26
  # Deletes a given API key
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Cancel an active crawl request
25
26
  # Cancels an active crawl request, stopping a running crawl if needed.
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Delete a crawl rule
25
26
  # Deletes a crawl rule from a given domain
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Delete a crawl schedule
25
26
  # Deletes a crawl schedule for a given engine
@@ -20,6 +20,7 @@
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
+ # Generated from build hash 835a1a87f357f7b7cfd3453b5c5a937c47995772
23
24
  module Actions
24
25
  # Crawler - Delete domain configuration
25
26
  # Deletes crawler domain configuration for a given domain