elastic-enterprise-search 7.12.1 → 7.15.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (236) hide show
  1. checksums.yaml +4 -4
  2. data/.ci/functions/imports.sh +1 -0
  3. data/.ci/jobs/defaults.yml +4 -0
  4. data/.ci/jobs/elastic+enterprise-search-ruby+7.10.0.beta.1.yml +12 -0
  5. data/.ci/jobs/{elastic+enterprise-search-ruby+7.11.yml → elastic+enterprise-search-ruby+main.yml} +4 -4
  6. data/.ci/make.sh +162 -0
  7. data/.ci/run-repository.sh +2 -1
  8. data/.ci/test-matrix.yml +5 -3
  9. data/{spec/app-search/api_logs_spec.rb → .github/check_license_headers.rb} +13 -16
  10. data/.github/license-header.txt +16 -0
  11. data/.github/workflows/license.yml +13 -0
  12. data/.github/workflows/testing.yml +1 -1
  13. data/CONTRIBUTING.md +1 -1
  14. data/README.md +1 -1
  15. data/Rakefile +20 -0
  16. data/docs/guide/app-search-api.asciidoc +157 -1
  17. data/docs/guide/connecting.asciidoc +47 -1
  18. data/docs/guide/overview.asciidoc +3 -3
  19. data/docs/guide/release_notes/712.asciidoc +0 -10
  20. data/docs/guide/release_notes/713.asciidoc +21 -0
  21. data/docs/guide/release_notes/714.asciidoc +21 -0
  22. data/docs/guide/release_notes/715.asciidoc +36 -0
  23. data/docs/guide/release_notes/index.asciidoc +6 -0
  24. data/docs/guide/workplace-search-api.asciidoc +115 -2
  25. data/elastic-enterprise-search.gemspec +1 -1
  26. data/lib/elastic/app-search/api/add_meta_engine_source.rb +3 -2
  27. data/lib/elastic/app-search/api/api_key.rb +52 -0
  28. data/lib/elastic/app-search/api/api_logs.rb +14 -13
  29. data/lib/elastic/app-search/api/count_analytics.rb +7 -6
  30. data/lib/elastic/app-search/api/crawler_active_crawl_request.rb +51 -0
  31. data/lib/elastic/app-search/api/crawler_crawl_request.rb +54 -0
  32. data/lib/elastic/app-search/api/crawler_crawl_schedule.rb +51 -0
  33. data/lib/elastic/app-search/api/crawler_domain.rb +54 -0
  34. data/lib/elastic/app-search/api/crawler_domain_validation_result.rb +48 -0
  35. data/lib/elastic/app-search/api/crawler_metrics.rb +48 -0
  36. data/lib/elastic/app-search/api/crawler_overview.rb +51 -0
  37. data/lib/elastic/app-search/api/crawler_process_crawl.rb +54 -0
  38. data/lib/elastic/app-search/api/crawler_process_crawl_denied_urls.rb +54 -0
  39. data/lib/elastic/app-search/api/crawler_url_extraction_result.rb +52 -0
  40. data/lib/elastic/app-search/api/crawler_url_tracing_result.rb +52 -0
  41. data/lib/elastic/app-search/api/crawler_url_validation_result.rb +52 -0
  42. data/lib/elastic/app-search/api/crawler_user_agent.rb +48 -0
  43. data/lib/elastic/app-search/api/create_api_key.rb +57 -0
  44. data/lib/elastic/app-search/api/create_crawler_crawl_request.rb +51 -0
  45. data/lib/elastic/app-search/api/create_crawler_crawl_rule.rb +59 -0
  46. data/lib/elastic/app-search/api/create_crawler_domain.rb +55 -0
  47. data/lib/elastic/app-search/api/create_crawler_entry_point.rb +56 -0
  48. data/lib/elastic/app-search/api/create_crawler_process_crawl.rb +53 -0
  49. data/lib/elastic/app-search/api/create_crawler_sitemap.rb +56 -0
  50. data/lib/elastic/app-search/api/create_curation.rb +7 -6
  51. data/lib/elastic/app-search/api/create_engine.rb +9 -7
  52. data/lib/elastic/app-search/api/create_synonym_set.rb +7 -4
  53. data/lib/elastic/app-search/api/curation.rb +4 -3
  54. data/lib/elastic/app-search/api/delete_active_crawl_request.rb +51 -0
  55. data/lib/elastic/app-search/api/delete_api_key.rb +52 -0
  56. data/lib/elastic/app-search/api/delete_crawler_active_crawl_request.rb +51 -0
  57. data/lib/elastic/app-search/api/delete_crawler_crawl_rule.rb +57 -0
  58. data/lib/elastic/app-search/api/delete_crawler_crawl_schedule.rb +51 -0
  59. data/lib/elastic/app-search/api/delete_crawler_domain.rb +54 -0
  60. data/lib/elastic/app-search/api/delete_crawler_entry_point.rb +57 -0
  61. data/lib/elastic/app-search/api/delete_crawler_sitemap.rb +57 -0
  62. data/lib/elastic/app-search/api/delete_curation.rb +4 -3
  63. data/lib/elastic/app-search/api/delete_documents.rb +2 -1
  64. data/lib/elastic/app-search/api/delete_engine.rb +3 -2
  65. data/lib/elastic/app-search/api/delete_meta_engine_source.rb +3 -3
  66. data/lib/elastic/app-search/api/delete_synonym_set.rb +4 -3
  67. data/lib/elastic/app-search/api/denied_urls.rb +54 -0
  68. data/lib/elastic/app-search/api/documents.rb +3 -2
  69. data/lib/elastic/app-search/api/engine.rb +3 -2
  70. data/lib/elastic/app-search/api/index_documents.rb +3 -2
  71. data/lib/elastic/app-search/api/list_api_keys.rb +50 -0
  72. data/lib/elastic/app-search/api/list_crawler_crawl_requests.rb +52 -0
  73. data/lib/elastic/app-search/api/list_crawler_process_crawls.rb +51 -0
  74. data/lib/elastic/app-search/api/list_curations.rb +3 -2
  75. data/lib/elastic/app-search/api/list_documents.rb +3 -2
  76. data/lib/elastic/app-search/api/list_engines.rb +2 -1
  77. data/lib/elastic/app-search/api/list_synonym_sets.rb +3 -2
  78. data/lib/elastic/app-search/api/log_clickthrough.rb +8 -10
  79. data/lib/elastic/app-search/api/put_api_key.rb +59 -0
  80. data/lib/elastic/app-search/api/put_crawler_crawl_rule.rb +62 -0
  81. data/lib/elastic/app-search/api/put_crawler_crawl_schedule.rb +53 -0
  82. data/lib/elastic/app-search/api/put_crawler_domain.rb +58 -0
  83. data/lib/elastic/app-search/api/put_crawler_entry_point.rb +59 -0
  84. data/lib/elastic/app-search/api/put_crawler_sitemap.rb +59 -0
  85. data/lib/elastic/app-search/api/put_curation.rb +9 -8
  86. data/lib/elastic/app-search/api/put_documents.rb +3 -3
  87. data/lib/elastic/app-search/api/put_schema.rb +4 -4
  88. data/lib/elastic/app-search/api/put_search_settings.rb +6 -2
  89. data/lib/elastic/app-search/api/put_synonym_set.rb +8 -5
  90. data/lib/elastic/app-search/api/query_suggestion.rb +7 -7
  91. data/lib/elastic/app-search/api/reset_search_settings.rb +3 -2
  92. data/lib/elastic/app-search/api/schema.rb +3 -2
  93. data/lib/elastic/app-search/api/search.rb +14 -3
  94. data/lib/elastic/app-search/api/search_settings.rb +3 -2
  95. data/lib/elastic/app-search/api/synonym_set.rb +4 -3
  96. data/lib/elastic/app-search/api/top_clicks_analytics.rb +8 -8
  97. data/lib/elastic/app-search/api/top_queries_analytics.rb +7 -7
  98. data/lib/elastic/app-search/app_search.rb +0 -10
  99. data/lib/elastic/enterprise-search/api/health.rb +1 -0
  100. data/lib/elastic/enterprise-search/api/put_read_only.rb +3 -0
  101. data/lib/elastic/enterprise-search/api/read_only.rb +1 -0
  102. data/lib/elastic/enterprise-search/api/version.rb +1 -0
  103. data/lib/elastic/enterprise-search/client.rb +0 -16
  104. data/lib/elastic/enterprise-search/request.rb +14 -3
  105. data/lib/elastic/enterprise-search/version.rb +1 -1
  106. data/lib/elastic/enterprise_search.rb +11 -0
  107. data/lib/elastic/workplace-search/api/auto_query_refinement_details.rb +49 -0
  108. data/lib/elastic/workplace-search/api/command_sync_jobs.rb +53 -0
  109. data/lib/elastic/workplace-search/api/content_source.rb +49 -0
  110. data/lib/elastic/workplace-search/api/create_analytics_event.rb +8 -8
  111. data/lib/elastic/workplace-search/api/create_batch_synonym_sets.rb +50 -0
  112. data/lib/elastic/workplace-search/api/create_content_source.rb +55 -0
  113. data/lib/elastic/workplace-search/api/create_external_identity.rb +3 -1
  114. data/lib/elastic/workplace-search/api/current_user.rb +47 -0
  115. data/lib/elastic/workplace-search/api/delete_all_documents.rb +49 -0
  116. data/lib/elastic/workplace-search/api/delete_content_source.rb +49 -0
  117. data/lib/elastic/workplace-search/api/delete_documents.rb +1 -1
  118. data/lib/elastic/workplace-search/api/delete_documents_by_query.rb +50 -0
  119. data/lib/elastic/workplace-search/api/delete_synonym_set.rb +51 -0
  120. data/lib/elastic/workplace-search/api/document.rb +53 -0
  121. data/lib/elastic/workplace-search/api/list_content_sources.rb +48 -0
  122. data/lib/elastic/workplace-search/api/list_synonym_sets.rb +51 -0
  123. data/lib/elastic/workplace-search/api/put_content_source.rb +58 -0
  124. data/lib/elastic/workplace-search/api/put_content_source_icons.rb +53 -0
  125. data/lib/elastic/workplace-search/api/put_external_identity.rb +3 -1
  126. data/lib/elastic/workplace-search/api/put_synonym_set.rb +53 -0
  127. data/lib/elastic/workplace-search/api/put_triggers_blocklist.rb +47 -0
  128. data/lib/elastic/workplace-search/api/search.rb +4 -1
  129. data/lib/elastic/workplace-search/api/synonym_set.rb +51 -0
  130. data/lib/elastic/workplace-search/api/triggers_blocklist.rb +45 -0
  131. data/lib/elastic/workplace-search/workplace_search.rb +0 -10
  132. data/rake_tasks/unified_release_tasks.rake +46 -0
  133. data/spec/enterprise-search/client_spec.rb +0 -1
  134. data/spec/enterprise-search/request_spec.rb +26 -0
  135. data/spec/integration/app-search/api_key_spec.rb +110 -0
  136. data/spec/integration/app-search/api_logs_spec.rb +59 -0
  137. data/spec/integration/app-search/app_search_helper.rb +39 -0
  138. data/spec/integration/app-search/count_analytics_spec.rb +47 -0
  139. data/spec/integration/app-search/crawl_requests_spec.rb +86 -0
  140. data/spec/integration/app-search/crawler_crawl_rule_spec.rb +73 -0
  141. data/spec/integration/app-search/crawler_domain_spec.rb +82 -0
  142. data/spec/integration/app-search/crawler_entry_point_spec.rb +89 -0
  143. data/spec/integration/app-search/crawler_metrics_spec.rb +46 -0
  144. data/spec/integration/app-search/crawler_overview_spec.rb +45 -0
  145. data/spec/integration/app-search/crawler_process_crawl_denied_urls_spec.rb +50 -0
  146. data/spec/integration/app-search/crawler_process_crawl_spec.rb +66 -0
  147. data/spec/integration/app-search/crawler_scheduling_spec.rb +81 -0
  148. data/spec/integration/app-search/crawler_sitemap_spec.rb +72 -0
  149. data/spec/integration/app-search/crawler_urls_spec.rb +60 -0
  150. data/spec/{app-search/api_count_analytics_spec.rb → integration/app-search/crawler_user_agent_spec.rb} +6 -9
  151. data/spec/integration/app-search/curations_spec.rb +118 -0
  152. data/spec/integration/app-search/documents_spec.rb +123 -0
  153. data/spec/integration/app-search/engines_spec.rb +77 -0
  154. data/spec/{app-search/api_log_clickthrough_spec.rb → integration/app-search/log_clickthrough_spec.rb} +14 -7
  155. data/spec/integration/app-search/meta_engines_spec.rb +75 -0
  156. data/spec/integration/app-search/query_suggestion_spec.rb +50 -0
  157. data/spec/{app-search/api_schema_spec.rb → integration/app-search/schema_spec.rb} +21 -16
  158. data/spec/integration/app-search/search_and_multiple_search_spec.rb +67 -0
  159. data/spec/integration/app-search/search_settings_spec.rb +87 -0
  160. data/spec/integration/app-search/synonyms_spec.rb +79 -0
  161. data/spec/{app-search/api_top_clicks_analytics_spec.rb → integration/app-search/top_clicks_analytics_spec.rb} +20 -14
  162. data/spec/{app-search/api_top_queries_analytics_spec.rb → integration/app-search/top_queries_analytics_spec.rb} +16 -8
  163. data/spec/integration/enterprise_search_api_spec.rb +4 -0
  164. data/spec/integration/workplace-search/content_sources_spec.rb +106 -0
  165. data/spec/integration/workplace-search/documents_spec.rb +95 -0
  166. data/spec/{workplace-search → integration/workplace-search}/external_identities_spec.rb +37 -24
  167. data/spec/integration/workplace-search/icon.png +0 -0
  168. data/spec/integration/workplace-search/permissions_spec.rb +77 -0
  169. data/spec/integration/workplace-search/synonym_sets_spec.rb +92 -0
  170. data/spec/integration/workplace-search/triggers_spec.rb +43 -0
  171. data/spec/{app-search/api_query_suggestion_spec.rb → integration/workplace-search/users_spec.rb} +12 -15
  172. data/spec/integration/workplace-search/workplace_search_helper.rb +39 -0
  173. data/spec/webmock_requires.rb +16 -0
  174. data/spec/workplace-search/client_spec.rb +24 -2
  175. metadata +112 -83
  176. data/.ci/jobs/elastic+enterprise-search-ruby+master.yml +0 -12
  177. data/spec/app-search/api_curations_spec.rb +0 -97
  178. data/spec/app-search/api_documents_spec.rb +0 -102
  179. data/spec/app-search/api_engines_spec.rb +0 -67
  180. data/spec/app-search/api_meta_engines_spec.rb +0 -72
  181. data/spec/app-search/api_search_and_multi_search_spec.rb +0 -48
  182. data/spec/app-search/api_search_settings_spec.rb +0 -76
  183. data/spec/app-search/api_spec_helper.rb +0 -14
  184. data/spec/app-search/api_synonyms_spec.rb +0 -79
  185. data/spec/fixtures/vcr/app_search/add_meta_engine_source.yml +0 -109
  186. data/spec/fixtures/vcr/app_search/api_documents.yml +0 -56
  187. data/spec/fixtures/vcr/app_search/api_index_documents.yml +0 -57
  188. data/spec/fixtures/vcr/app_search/api_log_clickthrough.yml +0 -54
  189. data/spec/fixtures/vcr/app_search/api_logs.yml +0 -70
  190. data/spec/fixtures/vcr/app_search/api_put_schema.yml +0 -109
  191. data/spec/fixtures/vcr/app_search/api_put_search_settings.yml +0 -56
  192. data/spec/fixtures/vcr/app_search/api_query_suggestion.yml +0 -59
  193. data/spec/fixtures/vcr/app_search/api_reset_search_settings.yml +0 -56
  194. data/spec/fixtures/vcr/app_search/api_schema.yml +0 -56
  195. data/spec/fixtures/vcr/app_search/api_search_settings.yml +0 -56
  196. data/spec/fixtures/vcr/app_search/api_top_clicks_analytics.yml +0 -55
  197. data/spec/fixtures/vcr/app_search/api_top_clicks_analytics_query.yml +0 -55
  198. data/spec/fixtures/vcr/app_search/api_top_queries_analytics.yml +0 -55
  199. data/spec/fixtures/vcr/app_search/count_analytics.yml +0 -55
  200. data/spec/fixtures/vcr/app_search/create_and_update_document.yml +0 -107
  201. data/spec/fixtures/vcr/app_search/create_curation.yml +0 -113
  202. data/spec/fixtures/vcr/app_search/create_engine.yml +0 -55
  203. data/spec/fixtures/vcr/app_search/create_meta_engine.yml +0 -56
  204. data/spec/fixtures/vcr/app_search/create_synonym_set.yml +0 -56
  205. data/spec/fixtures/vcr/app_search/delete_curation.yml +0 -56
  206. data/spec/fixtures/vcr/app_search/delete_engine.yml +0 -55
  207. data/spec/fixtures/vcr/app_search/delete_meta_engine_source.yml +0 -56
  208. data/spec/fixtures/vcr/app_search/delete_synonym_set.yml +0 -56
  209. data/spec/fixtures/vcr/app_search/get_curation.yml +0 -56
  210. data/spec/fixtures/vcr/app_search/get_engine.yml +0 -55
  211. data/spec/fixtures/vcr/app_search/index_and_delete_document.yml +0 -107
  212. data/spec/fixtures/vcr/app_search/list_curations.yml +0 -56
  213. data/spec/fixtures/vcr/app_search/list_documents.yml +0 -57
  214. data/spec/fixtures/vcr/app_search/list_engines.yml +0 -55
  215. data/spec/fixtures/vcr/app_search/list_synonym_sets.yml +0 -56
  216. data/spec/fixtures/vcr/app_search/multi_query_search.yml +0 -63
  217. data/spec/fixtures/vcr/app_search/put_curation.yml +0 -113
  218. data/spec/fixtures/vcr/app_search/put_synonym_set.yml +0 -56
  219. data/spec/fixtures/vcr/app_search/search.yml +0 -57
  220. data/spec/fixtures/vcr/app_search/single_query_search.yml +0 -60
  221. data/spec/fixtures/vcr/app_search/synonym_set.yml +0 -56
  222. data/spec/fixtures/vcr/workplace_search/add_user_permissions.yml +0 -53
  223. data/spec/fixtures/vcr/workplace_search/clear_user_permissions.yml +0 -53
  224. data/spec/fixtures/vcr/workplace_search/create_external_identity.yml +0 -53
  225. data/spec/fixtures/vcr/workplace_search/delete_documents.yml +0 -53
  226. data/spec/fixtures/vcr/workplace_search/delete_external_identity.yml +0 -53
  227. data/spec/fixtures/vcr/workplace_search/index_documents.yml +0 -55
  228. data/spec/fixtures/vcr/workplace_search/list_external_identities.yml +0 -53
  229. data/spec/fixtures/vcr/workplace_search/list_permissions.yml +0 -53
  230. data/spec/fixtures/vcr/workplace_search/put_external_identity.yml +0 -53
  231. data/spec/fixtures/vcr/workplace_search/put_user_permissions.yml +0 -103
  232. data/spec/fixtures/vcr/workplace_search/remove_user_permissions.yml +0 -53
  233. data/spec/fixtures/vcr/workplace_search/retrieve_external_identity.yml +0 -53
  234. data/spec/fixtures/vcr/workplace_search/user_permissions_empty.yml +0 -53
  235. data/spec/workplace-search/documents_spec.rb +0 -80
  236. data/spec/workplace-search/permissions_spec.rb +0 -136
@@ -0,0 +1,58 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Licensed to Elasticsearch B.V. under one or more contributor
4
+ # license agreements. See the NOTICE file distributed with
5
+ # this work for additional information regarding copyright
6
+ # ownership. Elasticsearch B.V. licenses this file to you under
7
+ # the Apache License, Version 2.0 (the "License"); you may
8
+ # not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing,
14
+ # software distributed under the License is distributed on an
15
+ # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16
+ # KIND, either express or implied. See the License for the
17
+ # specific language governing permissions and limitations
18
+ # under the License.
19
+
20
+ module Elastic
21
+ module EnterpriseSearch
22
+ module AppSearch
23
+ module Actions
24
+ # Crawler - Update domain configuration
25
+ # Updates crawler domain configuration for a given domain
26
+ #
27
+ # @param engine_name [String] Name of the engine (*Required*)
28
+ # @param arguments [Hash] endpoint arguments
29
+ # @option arguments [String] :domain_id Crawler Domain ID (*Required*)
30
+ # @option arguments [Hash] :body
31
+ # @option body [String] :name
32
+ # @option body [Array] :entry_points
33
+ # @option body [Array] :crawl_rules
34
+ # @option body [Array] :sitemaps
35
+ # @option arguments [Hash] :headers optional HTTP headers to send with the request
36
+ #
37
+ # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-put-crawler-domain
38
+ #
39
+ def put_crawler_domain(engine_name, arguments = {})
40
+ raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
41
+ raise ArgumentError, "Required parameter 'domain_id' missing" unless arguments[:domain_id]
42
+
43
+ domain_id = arguments[:domain_id]
44
+ body = arguments.delete(:body) || {}
45
+ headers = arguments.delete(:headers) || {}
46
+
47
+ request(
48
+ :put,
49
+ "api/as/v0/engines/#{engine_name}/crawler/domains/#{domain_id}/",
50
+ arguments,
51
+ body,
52
+ headers
53
+ )
54
+ end
55
+ end
56
+ end
57
+ end
58
+ end
@@ -0,0 +1,59 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Licensed to Elasticsearch B.V. under one or more contributor
4
+ # license agreements. See the NOTICE file distributed with
5
+ # this work for additional information regarding copyright
6
+ # ownership. Elasticsearch B.V. licenses this file to you under
7
+ # the Apache License, Version 2.0 (the "License"); you may
8
+ # not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing,
14
+ # software distributed under the License is distributed on an
15
+ # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16
+ # KIND, either express or implied. See the License for the
17
+ # specific language governing permissions and limitations
18
+ # under the License.
19
+
20
+ module Elastic
21
+ module EnterpriseSearch
22
+ module AppSearch
23
+ module Actions
24
+ # Crawler - Update a crawler entry point
25
+ # Updates a crawler entry point with a new value
26
+ #
27
+ # @param engine_name [String] Name of the engine (*Required*)
28
+ # @param arguments [Hash] endpoint arguments
29
+ # @option arguments [String] :domain_id Crawler Domain ID (*Required*)
30
+ # @option arguments [String] :entry_point_id Crawler Entry Point identifier (*Required*)
31
+ # @option arguments [Hash] :body (Required: value)
32
+ # @option body [String] :id
33
+ # @option body [String] :value (*Required)
34
+ # @option arguments [Hash] :headers optional HTTP headers to send with the request
35
+ #
36
+ # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-put-entry-point
37
+ #
38
+ def put_crawler_entry_point(engine_name, arguments = {})
39
+ raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
40
+ raise ArgumentError, "Required parameter 'domain_id' missing" unless arguments[:domain_id]
41
+ raise ArgumentError, "Required parameter 'entry_point_id' missing" unless arguments[:entry_point_id]
42
+
43
+ domain_id = arguments[:domain_id]
44
+ entry_point_id = arguments[:entry_point_id]
45
+ body = arguments.delete(:body) || {}
46
+ headers = arguments.delete(:headers) || {}
47
+
48
+ request(
49
+ :put,
50
+ "api/as/v0/engines/#{engine_name}/crawler/domains/#{domain_id}/entry_points/#{entry_point_id}/",
51
+ arguments,
52
+ body,
53
+ headers
54
+ )
55
+ end
56
+ end
57
+ end
58
+ end
59
+ end
@@ -0,0 +1,59 @@
1
+ # frozen_string_literal: true
2
+
3
+ # Licensed to Elasticsearch B.V. under one or more contributor
4
+ # license agreements. See the NOTICE file distributed with
5
+ # this work for additional information regarding copyright
6
+ # ownership. Elasticsearch B.V. licenses this file to you under
7
+ # the Apache License, Version 2.0 (the "License"); you may
8
+ # not use this file except in compliance with the License.
9
+ # You may obtain a copy of the License at
10
+ #
11
+ # http://www.apache.org/licenses/LICENSE-2.0
12
+ #
13
+ # Unless required by applicable law or agreed to in writing,
14
+ # software distributed under the License is distributed on an
15
+ # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
16
+ # KIND, either express or implied. See the License for the
17
+ # specific language governing permissions and limitations
18
+ # under the License.
19
+
20
+ module Elastic
21
+ module EnterpriseSearch
22
+ module AppSearch
23
+ module Actions
24
+ # Crawler - Update a sitemap
25
+ # Updates sitemap configuration
26
+ #
27
+ # @param engine_name [String] Name of the engine (*Required*)
28
+ # @param arguments [Hash] endpoint arguments
29
+ # @option arguments [String] :domain_id Crawler Domain ID (*Required*)
30
+ # @option arguments [String] :sitemap_id Sitemap ID (*Required*)
31
+ # @option arguments [Hash] :body (Required: url)
32
+ # @option body [String] :id
33
+ # @option body [String] :url (*Required)
34
+ # @option arguments [Hash] :headers optional HTTP headers to send with the request
35
+ #
36
+ # @see https://www.elastic.co/guide/en/app-search/current/web-crawler-api-reference.html#web-crawler-apis-put-sitemap
37
+ #
38
+ def put_crawler_sitemap(engine_name, arguments = {})
39
+ raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
40
+ raise ArgumentError, "Required parameter 'domain_id' missing" unless arguments[:domain_id]
41
+ raise ArgumentError, "Required parameter 'sitemap_id' missing" unless arguments[:sitemap_id]
42
+
43
+ domain_id = arguments[:domain_id]
44
+ sitemap_id = arguments[:sitemap_id]
45
+ body = arguments.delete(:body) || {}
46
+ headers = arguments.delete(:headers) || {}
47
+
48
+ request(
49
+ :put,
50
+ "api/as/v0/engines/#{engine_name}/crawler/domains/#{domain_id}/sitemaps/#{sitemap_id}/",
51
+ arguments,
52
+ body,
53
+ headers
54
+ )
55
+ end
56
+ end
57
+ end
58
+ end
59
+ end
@@ -21,21 +21,22 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Curations - Update an existing curation
24
+ # Curations - Update a curation
25
+ # Updates an existing curation
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [Array] :queries List of affected search queries (*Required*)
29
- # @option arguments [String] :curation_id (*Required*)
30
- # @option arguments :promoted_doc_ids List of promoted document IDs
31
- # @option arguments :hidden_doc_ids List of hidden document IDs
32
- # @option arguments [Hash] :body The request body
29
+ # @option arguments [String] :curation_id Curation ID (*Required*)
30
+ # @option arguments [Hash] :body (Required: queries)
31
+ # @option body [String] :id
32
+ # @option body [Array] :queries List of affected search queries (*Required)
33
+ # @option body [Array] :promoted List of promoted document IDs
34
+ # @option body [Array] :hidden List of hidden document IDs
33
35
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
34
36
  #
35
37
  # @see https://www.elastic.co/guide/en/app-search/current/curations.html#curations-update
36
38
  #
37
39
  def put_curation(engine_name, arguments = {})
38
- raise ArgumentError, "Required parameter 'queries' missing" unless arguments[:queries]
39
40
  raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
40
41
  raise ArgumentError, "Required parameter 'curation_id' missing" unless arguments[:curation_id]
41
42
 
@@ -22,17 +22,17 @@ module Elastic
22
22
  module AppSearch
23
23
  module Actions
24
24
  # Documents - Partial update of documents
25
+ # Update specific document fields by id and field
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [Array] :documents List of documents to update (*Required*)
29
+ # @option arguments [Array] :documents
29
30
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
30
31
  #
31
32
  # @see https://www.elastic.co/guide/en/app-search/current/documents.html#documents-partial
32
33
  #
33
34
  def put_documents(engine_name, arguments = {})
34
35
  raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
35
- raise ArgumentError, "Required parameter 'documents' missing" unless arguments[:documents]
36
36
 
37
37
  documents = arguments.delete(:documents) || {}
38
38
  headers = arguments.delete(:headers) || {}
@@ -21,18 +21,18 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Schema - Update schema for the current engine
24
+ # Schema - Update engine schema
25
+ # Update schema for the current engine
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [Object] :schema Schema description (*Required*)
29
+ # @option arguments [Object] :schema
29
30
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
30
31
  #
31
32
  # @see https://www.elastic.co/guide/en/app-search/current/schema.html#schema-patch
32
33
  #
33
34
  def put_schema(engine_name, arguments = {})
34
35
  raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
35
- raise ArgumentError, "Required parameter 'schema' missing" unless arguments[:schema]
36
36
 
37
37
  schema = arguments.delete(:schema) || {}
38
38
  headers = arguments.delete(:headers) || {}
@@ -23,9 +23,13 @@ module Elastic
23
23
  module Actions
24
24
  # Searchsettings - Update search settings for the engine
25
25
  #
26
- # @param engine_name [String] (*Required*)
26
+ # @param engine_name [String] Name of the engine (*Required*)
27
27
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [Object] :body Search settings (*Required*)
28
+ # @option arguments [Hash] :body
29
+ # @option body :boosts
30
+ # @option body :search_fields
31
+ # @option body :result_fields
32
+ # @option body [Integer] :precision
29
33
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
30
34
  #
31
35
  # @see https://www.elastic.co/guide/en/app-search/current/search-settings.html#search-settings-update
@@ -21,12 +21,15 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Synonyms - Update a synonym set by ID
24
+ # Synonyms - Update a synonym set
25
+ # Updates a synonym set by ID
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [String] :synonym_set_id (*Required*)
29
- # @option arguments [Object] :body Synonym set description (*Required*)
29
+ # @option arguments [String] :synonym_set_id Synonym Set ID (*Required*)
30
+ # @option arguments [Hash] :body (Required: synonyms)
31
+ # @option body [String] :id
32
+ # @option body :synonyms (*Required)
30
33
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
31
34
  #
32
35
  # @see https://www.elastic.co/guide/en/app-search/current/synonyms.html#synonyms-update
@@ -34,7 +37,7 @@ module Elastic
34
37
  def put_synonym_set(engine_name, arguments = {})
35
38
  raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
36
39
  raise ArgumentError, "Required parameter 'synonym_set_id' missing" unless arguments[:synonym_set_id]
37
- raise ArgumentError, "Required parameter 'body' missing" unless arguments[:body]
40
+ raise ArgumentError, "Required parameter 'body (synonyms)' missing" unless arguments[:body] || arguments[:synonyms]
38
41
 
39
42
  synonym_set_id = arguments[:synonym_set_id]
40
43
  body = arguments.delete(:body) || {}
@@ -21,20 +21,20 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Querysuggestion - Provide relevant query suggestions for incomplete queries
24
+ # QuerySuggestion - Retrieve query suggestions
25
+ # Provide relevant query suggestions for incomplete queries
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [String] :query A partial query for which to receive suggestions (*Required*)
29
- # @option arguments [Array] :fields List of fields to use to generate suggestions. Defaults to all text fields
30
- # @option arguments [Integer] :size Number of query suggestions to return. Must be between 1 and 20. Defaults to 5
31
- # @option arguments [Hash] :body The request body
29
+ # @option arguments [Hash] :body
30
+ # @option body [String] :query
31
+ # @option body :types
32
+ # @option body [Integer] :size
32
33
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
33
34
  #
34
35
  # @see https://www.elastic.co/guide/en/app-search/current/query-suggestion.html
35
36
  #
36
37
  def query_suggestion(engine_name, arguments = {})
37
- raise ArgumentError, "Required parameter 'query' missing" unless arguments[:query]
38
38
  raise ArgumentError, "Required parameter 'engine_name' missing" unless engine_name
39
39
 
40
40
  body = arguments.delete(:body) || {}
@@ -21,9 +21,10 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Searchsettings - Reset search settings for the engine
24
+ # Synonyms - Reset search settings
25
+ # Resets search settings for the engine
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
29
  # @option arguments [Hash] :body The request body
29
30
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
@@ -21,9 +21,10 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Schema - Retrieve current schema for the engine
24
+ # Schema - Retrieve engine schema
25
+ # Retrieve current schema for the engine
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
29
  # @option arguments [Hash] :body The request body
29
30
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
@@ -21,11 +21,22 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Search - Allows you to search over, facet and filter your data
24
+ # Search - Submit a search
25
+ # Submit a search and receive a set of results with meta data
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [Object] :body Search request parameters
29
+ # @option arguments [Hash] :body (Required: query)
30
+ # @option body [String] :query (*Required)
31
+ # @option body :analytics
32
+ # @option body :boost
33
+ # @option body :facets
34
+ # @option body :filters
35
+ # @option body :group
36
+ # @option body :page
37
+ # @option body :result_fields
38
+ # @option body :search_fields
39
+ # @option body :sort
29
40
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
30
41
  #
31
42
  # @see https://www.elastic.co/guide/en/app-search/current/search.html
@@ -21,9 +21,10 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Searchsettings - Retrieve current search settings for the engine
24
+ # SearchSettings - Retrieve search settings
25
+ # Retrieve current search settings for the engine
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
29
  # @option arguments [Hash] :body The request body
29
30
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
@@ -21,11 +21,12 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Synonyms - Retrieve a synonym set by ID
24
+ # Synonyms - Retrieve a synonym set
25
+ # Retrieves a synonym set by ID
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [String] :synonym_set_id (*Required*)
29
+ # @option arguments [String] :synonym_set_id Synonym Set ID (*Required*)
29
30
  # @option arguments [Hash] :body The request body
30
31
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
31
32
  #
@@ -21,15 +21,15 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Analytics - Returns the number of clicks received by a document in descending order
24
+ # Analytics - Query for analytics click data
25
+ # Returns the number of clicks received by a document in descending order
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [String] :query Filter clicks over a search query
29
- # @option arguments [Integer] :current_page The page to fetch. Defaults to 1
30
- # @option arguments [Integer] :page_size The number of results per page
31
- # @option arguments [Array] :filters Analytics filters
32
- # @option arguments [Hash] :body The request body
29
+ # @option arguments [Hash] :body
30
+ # @option body [String] :query
31
+ # @option body :filters
32
+ # @option body [Object] :page
33
33
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
34
34
  #
35
35
  # @see https://www.elastic.co/guide/en/app-search/current/clicks.html
@@ -41,7 +41,7 @@ module Elastic
41
41
  headers = arguments.delete(:headers) || {}
42
42
 
43
43
  request(
44
- :get,
44
+ :post,
45
45
  "api/as/v1/engines/#{engine_name}/analytics/clicks/",
46
46
  arguments,
47
47
  body,
@@ -21,14 +21,14 @@ module Elastic
21
21
  module EnterpriseSearch
22
22
  module AppSearch
23
23
  module Actions
24
- # Analytics - Returns queries analytics by usage count
24
+ # Analytics - Query for analytics query data
25
+ # Returns queries analytics by usage count
25
26
  #
26
- # @param engine_name [String] (*Required*)
27
+ # @param engine_name [String] Name of the engine (*Required*)
27
28
  # @param arguments [Hash] endpoint arguments
28
- # @option arguments [Integer] :current_page The page to fetch. Defaults to 1
29
- # @option arguments [Integer] :page_size The number of results per page
30
- # @option arguments [Array] :filters Analytics filters
31
- # @option arguments [Hash] :body The request body
29
+ # @option arguments [Hash] :body
30
+ # @option body :filters
31
+ # @option body [Object] :page
32
32
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
33
33
  #
34
34
  # @see https://www.elastic.co/guide/en/app-search/current/queries.html#queries-top-queries
@@ -40,7 +40,7 @@ module Elastic
40
40
  headers = arguments.delete(:headers) || {}
41
41
 
42
42
  request(
43
- :get,
43
+ :post,
44
44
  "api/as/v1/engines/#{engine_name}/analytics/queries/",
45
45
  arguments,
46
46
  body,
@@ -25,20 +25,10 @@ module Elastic
25
25
  #
26
26
  # @see https://www.elastic.co/guide/en/app-search/current/index.html
27
27
  module AppSearch
28
- # The Request module is included in the AppSearch Client to override
29
- # EnterpriseSearch client's authentication method with App's
30
- # authentication.
31
- module Request
32
- def setup_authentication_header
33
- "Bearer #{http_auth}"
34
- end
35
- end
36
-
37
28
  # The App Search Client
38
29
  # Extends EnterpriseSearch client but overrides authentication to use access token.
39
30
  class Client < Elastic::EnterpriseSearch::Client
40
31
  include Elastic::EnterpriseSearch::AppSearch::Actions
41
- include Elastic::EnterpriseSearch::AppSearch::Request
42
32
 
43
33
  # Create a new Elastic::EnterpriseSearch::AppSearch::Client client
44
34
  #
@@ -23,6 +23,7 @@ module Elastic
23
23
  # Health - Get information on the health of a deployment and basic statistics around resource usage
24
24
  # Get information on the health of a deployment and basic statistics around resource usage
25
25
  #
26
+ # @param arguments [Hash] endpoint arguments
26
27
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
27
28
  #
28
29
  # @see https://www.elastic.co/guide/en/enterprise-search/current/monitoring-apis.html#health-api-example
@@ -23,6 +23,9 @@ module Elastic
23
23
  # Read-Only - Update the read-only flag's state
24
24
  # Update the read-only flag's state
25
25
  #
26
+ # @param arguments [Hash] endpoint arguments
27
+ # @option arguments [Hash] :body (Required: enabled)
28
+ # @option body [Boolean] :enabled (*Required)
26
29
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
27
30
  #
28
31
  # @see https://www.elastic.co/guide/en/enterprise-search/current/read-only-api.html#setting-read-only-state
@@ -23,6 +23,7 @@ module Elastic
23
23
  # Read-Only - Get the read-only flag's state
24
24
  # Get the read-only flag's state
25
25
  #
26
+ # @param arguments [Hash] endpoint arguments
26
27
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
27
28
  #
28
29
  # @see https://www.elastic.co/guide/en/enterprise-search/current/read-only-api.html#getting-read-only-state
@@ -23,6 +23,7 @@ module Elastic
23
23
  # Version - Get version information for this server
24
24
  # Get version information for this server
25
25
  #
26
+ # @param arguments [Hash] endpoint arguments
26
27
  # @option arguments [Hash] :headers optional HTTP headers to send with the request
27
28
  #
28
29
  # @see https://www.elastic.co/guide/en/enterprise-search/current/management-apis.html
@@ -22,18 +22,6 @@ require 'elastic/enterprise-search/utils'
22
22
  require 'elasticsearch-transport'
23
23
 
24
24
  module Elastic
25
- # If the version is X.X.X.pre/alpha/beta, use X.X.Xp for the meta-header:
26
- def self.client_meta_version
27
- regexp = /^([0-9]+\.[0-9]+\.[0-9]+)\.?([a-z0-9.-]+)?$/
28
- match = Elastic::EnterpriseSearch::VERSION.match(regexp)
29
- return "#{match[1]}p" if match[2]
30
-
31
- Elastic::EnterpriseSearch::VERSION
32
- end
33
-
34
- META_HEADER_SERVICE_VERSION = [:ent, client_meta_version].freeze
35
- ENTERPRISE_SERVICE_VERSION = [:ent, client_meta_version].freeze
36
-
37
25
  module EnterpriseSearch
38
26
  # API client for the {Elastic Enterprise Search API}[https://www.elastic.co/enterprise-search].
39
27
  # This is the main client from which the Workplace Search and App Search clients inherit.
@@ -95,10 +83,6 @@ module Elastic
95
83
  @options[:open_timeout] || DEFAULT_TIMEOUT
96
84
  end
97
85
 
98
- def proxy
99
- @options[:proxy]
100
- end
101
-
102
86
  def overall_timeout
103
87
  (@options[:overall_timeout] || DEFAULT_TIMEOUT).to_f
104
88
  end
@@ -46,11 +46,9 @@ module Elastic
46
46
  end
47
47
 
48
48
  # Construct and send a request to the API.
49
- #
50
- # @raise [Timeout::Error] when the timeout expires
51
49
  def request(method, path, params = {}, body = {}, headers = {})
52
50
  meta_headers = { authorization: decide_authorization(params), user_agent: request_user_agent }
53
- headers = if headers.nil? || !headers.is_a?(Hash)
51
+ headers = if !headers.is_a?(Hash)
54
52
  meta_headers
55
53
  else
56
54
  headers.merge(meta_headers)
@@ -60,6 +58,19 @@ module Elastic
60
58
  end
61
59
 
62
60
  def setup_authentication_header
61
+ if instance_of? Elastic::EnterpriseSearch::Client
62
+ basic_auth_header
63
+ else
64
+ case http_auth
65
+ when Hash
66
+ basic_auth_header
67
+ when String
68
+ "Bearer #{http_auth}"
69
+ end
70
+ end
71
+ end
72
+
73
+ def basic_auth_header
63
74
  credentials = Base64.strict_encode64("#{http_auth[:user]}:#{http_auth[:password]}")
64
75
  "Basic #{credentials}"
65
76
  end
@@ -19,6 +19,6 @@
19
19
 
20
20
  module Elastic
21
21
  module EnterpriseSearch
22
- VERSION = '7.12.1'
22
+ VERSION = '7.15.0'
23
23
  end
24
24
  end
@@ -33,6 +33,17 @@ require 'elastic/workplace-search/workplace_search'
33
33
  require 'elastic/app-search/app_search'
34
34
 
35
35
  module Elastic
36
+ # If the version is X.X.X.pre/alpha/beta, use X.X.Xp for the meta-header:
37
+ def self.client_meta_version
38
+ regexp = /^([0-9]+\.[0-9]+\.[0-9]+)\.?([a-z0-9.-]+)?$/
39
+ match = Elastic::EnterpriseSearch::VERSION.match(regexp)
40
+ return "#{match[1]}p" if match[2]
41
+
42
+ Elastic::EnterpriseSearch::VERSION
43
+ end
44
+
45
+ ENTERPRISE_SERVICE_VERSION = [:ent, client_meta_version].freeze
46
+
36
47
  module EnterpriseSearch
37
48
  end
38
49
  end