1: <?php
2:
3: declare(strict_types=1);
4:
5: /**
6: * Copyright OpenSearch Contributors
7: * SPDX-License-Identifier: Apache-2.0
8: *
9: * OpenSearch PHP client
10: *
11: * @link https://github.com/opensearch-project/opensearch-php/
12: * @copyright Copyright (c) Elasticsearch B.V (https://www.elastic.co)
13: * @license http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0
14: * @license https://www.gnu.org/licenses/lgpl-2.1.html GNU Lesser General Public License, Version 2.1
15: *
16: * Licensed to Elasticsearch B.V under one or more agreements.
17: * Elasticsearch B.V licenses this file to you under the Apache 2.0 License or
18: * the GNU Lesser General Public License, Version 2.1, at your option.
19: * See the LICENSE file in the project root for more information.
20: */
21:
22: namespace OpenSearch\Namespaces;
23:
24: use OpenSearch\Namespaces\AbstractNamespace;
25:
26: /**
27: * Class IndicesNamespace
28: *
29: * NOTE: This file is autogenerated using util/GenerateEndpoints.php
30: */
31: class IndicesNamespace extends AbstractNamespace
32: {
33: /**
34: * Adds a block to an index.
35: *
36: * $params['block'] = (string) The block to add (one of read, write, read_only or metadata)
37: * $params['index'] = (array) A comma separated list of indexes to add a block to
38: * $params['allow_no_indices'] = (boolean) Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have been specified)
39: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
40: * $params['expand_wildcards'] = (any) Whether to expand wildcard expression to concrete indexes that are open, closed or both.
41: * $params['ignore_unavailable'] = (boolean) Whether specified concrete indexes should be ignored when unavailable (missing or closed)
42: * $params['master_timeout'] = (string) Specify timeout for connection to master
43: * $params['timeout'] = (string) Explicit operation timeout
44: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
45: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
46: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
47: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
48: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
49: *
50: * @param array $params Associative array of parameters
51: * @return array
52: */
53: public function addBlock(array $params = [])
54: {
55: $block = $this->extractArgument($params, 'block');
56: $index = $this->extractArgument($params, 'index');
57:
58: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\AddBlock::class);
59: $endpoint->setParams($params);
60: $endpoint->setBlock($block);
61: $endpoint->setIndex($index);
62:
63: return $this->performRequest($endpoint);
64: }
65:
66: /**
67: * Performs the analysis process on a text and return the tokens breakdown of the text.
68: *
69: * $params['index'] = (string) Index used to derive the analyzer. If specified, the `analyzer` or field parameter overrides this value. If no index is specified or the index does not have a default analyzer, the analyze API uses the standard analyzer.
70: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
71: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
72: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
73: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
74: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
75: * $params['body'] = (array) Define analyzer/tokenizer parameters and the text on which the analysis should be performed
76: *
77: * @param array $params Associative array of parameters
78: * @return array
79: */
80: public function analyze(array $params = [])
81: {
82: $index = $this->extractArgument($params, 'index');
83: $body = $this->extractArgument($params, 'body');
84:
85: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Analyze::class);
86: $endpoint->setParams($params);
87: $endpoint->setIndex($index);
88: $endpoint->setBody($body);
89:
90: return $this->performRequest($endpoint);
91: }
92:
93: /**
94: * Clears all or specific caches for one or more indexes.
95: *
96: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
97: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
98: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
99: * $params['fielddata'] = (boolean) If `true`, clears the fields cache.Use the `fields` parameter to clear the cache of specific fields only.
100: * $params['fields'] = (any) Comma-separated list of field names used to limit the `fielddata` parameter.
101: * $params['file'] = (boolean) If true, clears the unused entries from the file cache on nodes with the Search role. (Default = false)
102: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
103: * $params['query'] = (boolean) If `true`, clears the query cache.
104: * $params['request'] = (boolean) If `true`, clears the request cache.
105: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
106: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
107: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
108: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
109: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
110: *
111: * @param array $params Associative array of parameters
112: * @return array
113: */
114: public function clearCache(array $params = [])
115: {
116: $index = $this->extractArgument($params, 'index');
117:
118: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\ClearCache::class);
119: $endpoint->setParams($params);
120: $endpoint->setIndex($index);
121:
122: return $this->performRequest($endpoint);
123: }
124:
125: /**
126: * Clones an index.
127: *
128: * $params['index'] = (string) Name of the source index to clone.
129: * $params['target'] = (string) Name of the target index to create.
130: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
131: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
132: * $params['task_execution_timeout'] = (string) Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.
133: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
134: * $params['wait_for_active_shards'] = (any) The number of shard copies that must be active before proceeding with the operation.Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
135: * $params['wait_for_completion'] = (boolean) Should this request wait until the operation has completed before returning. (Default = true)
136: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
137: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
138: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
139: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
140: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
141: * $params['body'] = (array) The configuration for the target index (`settings` and `aliases`)
142: *
143: * @param array $params Associative array of parameters
144: * @return array
145: */
146: public function clone(array $params = [])
147: {
148: $index = $this->extractArgument($params, 'index');
149: $target = $this->extractArgument($params, 'target');
150: $body = $this->extractArgument($params, 'body');
151:
152: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\CloneIndices::class);
153: $endpoint->setParams($params);
154: $endpoint->setIndex($index);
155: $endpoint->setTarget($target);
156: $endpoint->setBody($body);
157:
158: return $this->performRequest($endpoint);
159: }
160:
161: /**
162: * Closes an index.
163: *
164: * $params['index'] = (array) Comma-separated list or wildcard expression of index names used to limit the request.
165: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
166: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
167: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
168: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
169: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
170: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
171: * $params['wait_for_active_shards'] = (any) The number of shard copies that must be active before proceeding with the operation.Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
172: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
173: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
174: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
175: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
176: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
177: *
178: * @param array $params Associative array of parameters
179: * @return array
180: */
181: public function close(array $params = [])
182: {
183: $index = $this->extractArgument($params, 'index');
184:
185: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Close::class);
186: $endpoint->setParams($params);
187: $endpoint->setIndex($index);
188:
189: return $this->performRequest($endpoint);
190: }
191:
192: /**
193: * Creates an index with optional settings and mappings.
194: *
195: * $params['index'] = (string) Name of the index you wish to create.
196: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
197: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
198: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
199: * $params['wait_for_active_shards'] = (any) The number of shard copies that must be active before proceeding with the operation. Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
200: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
201: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
202: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
203: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
204: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
205: * $params['body'] = (array) The configuration for the index (`settings` and `mappings`)
206: *
207: * @param array $params Associative array of parameters
208: * @return array
209: */
210: public function create(array $params = [])
211: {
212: $index = $this->extractArgument($params, 'index');
213: $body = $this->extractArgument($params, 'body');
214:
215: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Create::class);
216: $endpoint->setParams($params);
217: $endpoint->setIndex($index);
218: $endpoint->setBody($body);
219:
220: return $this->performRequest($endpoint);
221: }
222:
223: /**
224: * Creates or updates a data stream.
225: *
226: * $params['name'] = (string) Name of the data stream, which must meet the following criteria: Lowercase only; Cannot include `\`, `/`, `*`, `?`, `"`, `<`, `>`, `|`, `,`, `#`, `:`, or a space character; Cannot start with `-`, `_`, `+`, or `.ds-`; Cannot be `.` or `..`; Cannot be longer than 255 bytes. Multi-byte characters count towards this limit faster.
227: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
228: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
229: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
230: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
231: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
232: * $params['body'] = (array) The data stream definition
233: *
234: * @param array $params Associative array of parameters
235: * @return array
236: */
237: public function createDataStream(array $params = [])
238: {
239: $name = $this->extractArgument($params, 'name');
240: $body = $this->extractArgument($params, 'body');
241:
242: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\CreateDataStream::class);
243: $endpoint->setParams($params);
244: $endpoint->setName($name);
245: $endpoint->setBody($body);
246:
247: return $this->performRequest($endpoint);
248: }
249:
250: /**
251: * Provides statistics on operations happening in a data stream.
252: *
253: * $params['name'] = (array) Comma-separated list of data streams used to limit the request. Wildcard expressions (`*`) are supported. To target all data streams in a cluster, omit this parameter or use `*`.
254: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
255: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
256: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
257: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
258: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
259: *
260: * @param array $params Associative array of parameters
261: * @return array
262: */
263: public function dataStreamsStats(array $params = [])
264: {
265: $name = $this->extractArgument($params, 'name');
266:
267: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\DataStreamsStats::class);
268: $endpoint->setParams($params);
269: $endpoint->setName($name);
270:
271: return $this->performRequest($endpoint);
272: }
273:
274: /**
275: * Deletes an index.
276: *
277: * $params['index'] = (array) Comma-separated list of indexes to delete. You cannot specify index aliases. By default, this parameter does not support wildcards (`*`) or `_all`. To use wildcards or `_all`, set the `action.destructive_requires_name` cluster setting to `false`.
278: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes. (Default = false)
279: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
280: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
281: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index. (Default = false)
282: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
283: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
284: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
285: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
286: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
287: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
288: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
289: *
290: * @param array $params Associative array of parameters
291: * @return array
292: */
293: public function delete(array $params = [])
294: {
295: $index = $this->extractArgument($params, 'index');
296:
297: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Delete::class);
298: $endpoint->setParams($params);
299: $endpoint->setIndex($index);
300:
301: return $this->performRequest($endpoint);
302: }
303:
304: /**
305: * Deletes an alias.
306: *
307: * $params['index'] = (array) Comma-separated list of data streams or indexes used to limit the request. Supports wildcards (`*`). (Required)
308: * $params['name'] = (array) Comma-separated list of aliases to remove. Supports wildcards (`*`). To remove all aliases, use `*` or `_all`. (Required)
309: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
310: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
311: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
312: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
313: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
314: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
315: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
316: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
317: *
318: * @param array $params Associative array of parameters
319: * @return array
320: */
321: public function deleteAlias(array $params = [])
322: {
323: $index = $this->extractArgument($params, 'index');
324: $name = $this->extractArgument($params, 'name');
325:
326: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\DeleteAlias::class);
327: $endpoint->setParams($params);
328: $endpoint->setIndex($index);
329: $endpoint->setName($name);
330:
331: return $this->performRequest($endpoint);
332: }
333:
334: /**
335: * Deletes a data stream.
336: *
337: * $params['name'] = (array) Comma-separated list of data streams to delete. Wildcard (`*`) expressions are supported.
338: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
339: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
340: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
341: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
342: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
343: *
344: * @param array $params Associative array of parameters
345: * @return array
346: */
347: public function deleteDataStream(array $params = [])
348: {
349: $name = $this->extractArgument($params, 'name');
350:
351: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\DeleteDataStream::class);
352: $endpoint->setParams($params);
353: $endpoint->setName($name);
354:
355: return $this->performRequest($endpoint);
356: }
357:
358: /**
359: * Deletes an index template.
360: *
361: * $params['name'] = (string) Name of the index template to delete. Wildcard (*) expressions are supported.
362: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
363: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.
364: * $params['timeout'] = (string) Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
365: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
366: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
367: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
368: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
369: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
370: *
371: * @param array $params Associative array of parameters
372: * @return array
373: */
374: public function deleteIndexTemplate(array $params = [])
375: {
376: $name = $this->extractArgument($params, 'name');
377:
378: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\DeleteIndexTemplate::class);
379: $endpoint->setParams($params);
380: $endpoint->setName($name);
381:
382: return $this->performRequest($endpoint);
383: }
384:
385: /**
386: * Deletes an index template.
387: *
388: * $params['name'] = (string) The name of the legacy index template to delete. Wildcard (`*`) expressions are supported.
389: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
390: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
391: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
392: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
393: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
394: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
395: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
396: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
397: *
398: * @param array $params Associative array of parameters
399: * @return array
400: */
401: public function deleteTemplate(array $params = [])
402: {
403: $name = $this->extractArgument($params, 'name');
404:
405: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\DeleteTemplate::class);
406: $endpoint->setParams($params);
407: $endpoint->setName($name);
408:
409: return $this->performRequest($endpoint);
410: }
411:
412: /**
413: * Returns information about whether a particular index exists.
414: *
415: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases. Supports wildcards (`*`).
416: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes. (Default = false)
417: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
418: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
419: * $params['flat_settings'] = (boolean) If `true`, returns settings in flat format. (Default = false)
420: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index. (Default = false)
421: * $params['include_defaults'] = (boolean) If `true`, return all default settings in the response. (Default = false)
422: * $params['local'] = (boolean) If `true`, the request retrieves information from the local node only. (Default = false)
423: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
424: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
425: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
426: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
427: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
428: *
429: * @param array $params Associative array of parameters
430: * @return bool
431: */
432: public function exists(array $params = []): bool
433: {
434: $index = $this->extractArgument($params, 'index');
435:
436: // manually make this verbose so we can check status code
437: $params['client']['verbose'] = true;
438:
439: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Exists::class);
440: $endpoint->setParams($params);
441: $endpoint->setIndex($index);
442:
443: return BooleanRequestWrapper::performRequest($endpoint, $this->transport);
444: }
445:
446: /**
447: * Returns information about whether a particular alias exists.
448: *
449: * $params['name'] = (array) Comma-separated list of aliases to check. Supports wildcards (`*`). (Required)
450: * $params['index'] = (array) Comma-separated list of data streams or indexes used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
451: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
452: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
453: * $params['ignore_unavailable'] = (boolean) If `false`, requests that include a missing data stream or index in the target indexes or data streams return an error.
454: * $params['local'] = (boolean) If `true`, the request retrieves information from the local node only. (Default = false)
455: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
456: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
457: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
458: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
459: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
460: *
461: * @param array $params Associative array of parameters
462: * @return bool
463: */
464: public function existsAlias(array $params = []): bool
465: {
466: $name = $this->extractArgument($params, 'name');
467: $index = $this->extractArgument($params, 'index');
468:
469: // manually make this verbose so we can check status code
470: $params['client']['verbose'] = true;
471:
472: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\ExistsAlias::class);
473: $endpoint->setParams($params);
474: $endpoint->setName($name);
475: $endpoint->setIndex($index);
476:
477: return BooleanRequestWrapper::performRequest($endpoint, $this->transport);
478: }
479:
480: /**
481: * Returns information about whether a particular index template exists.
482: *
483: * $params['name'] = (string) Name of the index template to check existence of. Wildcard (*) expressions are supported.
484: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
485: * $params['flat_settings'] = (boolean) Return settings in flat format. (Default = false)
486: * $params['local'] = (boolean) Return local information, do not retrieve the state from cluster-manager node. (Default = false)
487: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.
488: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
489: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
490: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
491: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
492: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
493: *
494: * @param array $params Associative array of parameters
495: * @return bool
496: */
497: public function existsIndexTemplate(array $params = []): bool
498: {
499: $name = $this->extractArgument($params, 'name');
500:
501: // manually make this verbose so we can check status code
502: $params['client']['verbose'] = true;
503:
504: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\ExistsIndexTemplate::class);
505: $endpoint->setParams($params);
506: $endpoint->setName($name);
507:
508: return BooleanRequestWrapper::performRequest($endpoint, $this->transport);
509: }
510:
511: /**
512: * Returns information about whether a particular index template exists.
513: *
514: * $params['name'] = (array) The comma separated names of the index templates
515: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
516: * $params['flat_settings'] = (boolean) Return settings in flat format. (Default = false)
517: * $params['local'] = (boolean) Return local information, do not retrieve the state from cluster-manager node. (Default = false)
518: * $params['master_timeout'] = (string) Explicit operation timeout for connection to master node
519: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
520: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
521: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
522: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
523: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
524: *
525: * @param array $params Associative array of parameters
526: * @return bool
527: */
528: public function existsTemplate(array $params = []): bool
529: {
530: $name = $this->extractArgument($params, 'name');
531:
532: // manually make this verbose so we can check status code
533: $params['client']['verbose'] = true;
534:
535: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\ExistsTemplate::class);
536: $endpoint->setParams($params);
537: $endpoint->setName($name);
538:
539: return BooleanRequestWrapper::performRequest($endpoint, $this->transport);
540: }
541:
542: /**
543: * Performs the flush operation on one or more indexes.
544: *
545: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases to flush. Supports wildcards (`*`). To flush all data streams and indexes, omit this parameter or use `*` or `_all`.
546: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
547: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
548: * $params['force'] = (boolean) If `true`, the request forces a flush even if there are no changes to commit to the index.
549: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
550: * $params['wait_if_ongoing'] = (boolean) If `true`, the flush operation blocks until execution when another flush operation is running.If `false`, OpenSearch returns an error if you request a flush when another flush operation is running. (Default = true)
551: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
552: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
553: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
554: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
555: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
556: *
557: * @param array $params Associative array of parameters
558: * @return array
559: */
560: public function flush(array $params = [])
561: {
562: $index = $this->extractArgument($params, 'index');
563:
564: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Flush::class);
565: $endpoint->setParams($params);
566: $endpoint->setIndex($index);
567:
568: return $this->performRequest($endpoint);
569: }
570:
571: /**
572: * Performs the force merge operation on one or more indexes.
573: *
574: * $params['index'] = (array) A comma-separated list of index names; use `_all` or empty string to perform the operation on all indexes
575: * $params['allow_no_indices'] = (boolean) Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have been specified)
576: * $params['expand_wildcards'] = (any) Whether to expand wildcard expression to concrete indexes that are open, closed or both.
577: * $params['flush'] = (boolean) Specify whether the index should be flushed after performing the operation. (Default = true)
578: * $params['ignore_unavailable'] = (boolean) Whether specified concrete indexes should be ignored when unavailable (missing or closed)
579: * $params['max_num_segments'] = (number) The number of larger segments into which smaller segments are merged.Set this parameter to 1 to merge all segments into one segment.The default behavior is to perform the merge as necessary.
580: * $params['only_expunge_deletes'] = (boolean) Specify whether the operation should only expunge deleted documents
581: * $params['primary_only'] = (boolean) Specify whether the operation should only perform on primary shards. Defaults to false. (Default = false)
582: * $params['wait_for_completion'] = (boolean) Should the request wait until the force merge is completed. (Default = true)
583: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
584: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
585: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
586: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
587: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
588: *
589: * @param array $params Associative array of parameters
590: * @return array
591: */
592: public function forcemerge(array $params = [])
593: {
594: $index = $this->extractArgument($params, 'index');
595:
596: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\ForceMerge::class);
597: $endpoint->setParams($params);
598: $endpoint->setIndex($index);
599:
600: return $this->performRequest($endpoint);
601: }
602:
603: /**
604: * Returns information about one or more indexes.
605: *
606: * $params['index'] = (array) Comma-separated list of data streams, indexes, and index aliases used to limit the request. Wildcard expressions (*) are supported.
607: * $params['allow_no_indices'] = (boolean) If false, the request returns an error if any wildcard expression, index alias, or _all value targets onlymissing or closed indexes. This behavior applies even if the request targets other open indexes. For example,a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar. (Default = false)
608: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
609: * $params['expand_wildcards'] = (any) Type of index that wildcard expressions can match. If the request can target data streams, this argumentdetermines whether wildcard expressions match hidden data streams. Supports comma-separated values,such as open,hidden.
610: * $params['flat_settings'] = (boolean) If true, returns settings in flat format. (Default = false)
611: * $params['ignore_unavailable'] = (boolean) If false, requests that target a missing index return an error. (Default = false)
612: * $params['include_defaults'] = (boolean) If true, return all default settings in the response. (Default = false)
613: * $params['local'] = (boolean) If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. (Default = false)
614: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.
615: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
616: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
617: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
618: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
619: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
620: *
621: * @param array $params Associative array of parameters
622: * @return array
623: */
624: public function get(array $params = [])
625: {
626: $index = $this->extractArgument($params, 'index');
627:
628: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Get::class);
629: $endpoint->setParams($params);
630: $endpoint->setIndex($index);
631:
632: return $this->performRequest($endpoint);
633: }
634:
635: /**
636: * Returns an alias.
637: *
638: * $params['name'] = (array) Comma-separated list of aliases to retrieve. Supports wildcards (`*`). To retrieve all aliases, omit this parameter or use `*` or `_all`.
639: * $params['index'] = (array) Comma-separated list of data streams or indexes used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
640: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
641: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
642: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
643: * $params['local'] = (boolean) If `true`, the request retrieves information from the local node only. (Default = false)
644: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
645: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
646: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
647: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
648: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
649: *
650: * @param array $params Associative array of parameters
651: * @return array
652: */
653: public function getAlias(array $params = [])
654: {
655: $name = $this->extractArgument($params, 'name');
656: $index = $this->extractArgument($params, 'index');
657:
658: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\GetAlias::class);
659: $endpoint->setParams($params);
660: $endpoint->setName($name);
661: $endpoint->setIndex($index);
662:
663: return $this->performRequest($endpoint);
664: }
665:
666: /**
667: * Returns data streams.
668: *
669: * $params['name'] = (array) Comma-separated list of data stream names used to limit the request. Wildcard (`*`) expressions are supported. If omitted, all data streams are returned.
670: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
671: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
672: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
673: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
674: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
675: *
676: * @param array $params Associative array of parameters
677: * @return array
678: */
679: public function getDataStream(array $params = [])
680: {
681: $name = $this->extractArgument($params, 'name');
682:
683: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\GetDataStream::class);
684: $endpoint->setParams($params);
685: $endpoint->setName($name);
686:
687: return $this->performRequest($endpoint);
688: }
689:
690: /**
691: * Returns mapping for one or more fields.
692: *
693: * $params['fields'] = (array) Comma-separated list or wildcard expression of fields used to limit returned information. (Required)
694: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
695: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
696: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
697: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
698: * $params['include_defaults'] = (boolean) If `true`, return all default settings in the response.
699: * $params['local'] = (boolean) If `true`, the request retrieves information from the local node only. (Default = false)
700: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
701: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
702: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
703: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
704: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
705: *
706: * @param array $params Associative array of parameters
707: * @return array
708: */
709: public function getFieldMapping(array $params = [])
710: {
711: $fields = $this->extractArgument($params, 'fields');
712: $index = $this->extractArgument($params, 'index');
713:
714: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\GetFieldMapping::class);
715: $endpoint->setParams($params);
716: $endpoint->setFields($fields);
717: $endpoint->setIndex($index);
718:
719: return $this->performRequest($endpoint);
720: }
721:
722: /**
723: * Returns an index template.
724: *
725: * $params['name'] = (array) Name of the index template to retrieve. Wildcard (*) expressions are supported.
726: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
727: * $params['flat_settings'] = (boolean) If true, returns settings in flat format. (Default = false)
728: * $params['local'] = (boolean) If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. (Default = false)
729: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.
730: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
731: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
732: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
733: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
734: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
735: *
736: * @param array $params Associative array of parameters
737: * @return array
738: */
739: public function getIndexTemplate(array $params = [])
740: {
741: $name = $this->extractArgument($params, 'name');
742:
743: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\GetIndexTemplate::class);
744: $endpoint->setParams($params);
745: $endpoint->setName($name);
746:
747: return $this->performRequest($endpoint);
748: }
749:
750: /**
751: * Returns mappings for one or more indexes.
752: *
753: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
754: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
755: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
756: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
757: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
758: * $params['local'] = (boolean) If `true`, the request retrieves information from the local node only. (Default = false)
759: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
760: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
761: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
762: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
763: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
764: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
765: *
766: * @param array $params Associative array of parameters
767: * @return array
768: */
769: public function getMapping(array $params = [])
770: {
771: $index = $this->extractArgument($params, 'index');
772:
773: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\GetMapping::class);
774: $endpoint->setParams($params);
775: $endpoint->setIndex($index);
776:
777: return $this->performRequest($endpoint);
778: }
779:
780: /**
781: * Returns settings for one or more indexes.
782: *
783: * $params['name'] = (array) Comma-separated list or wildcard expression of settings to retrieve.
784: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
785: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, indexalias, or `_all` value targets only missing or closed indexes. Thisbehavior applies even if the request targets other open indexes. Forexample, a request targeting `foo*,bar*` returns an error if an indexstarts with foo but no index starts with `bar`.
786: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
787: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.
788: * $params['flat_settings'] = (boolean) If `true`, returns settings in flat format. (Default = false)
789: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
790: * $params['include_defaults'] = (boolean) If `true`, return all default settings in the response. (Default = false)
791: * $params['local'] = (boolean) If `true`, the request retrieves information from the local node only. If`false`, information is retrieved from the master node. (Default = false)
792: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response isreceived before the timeout expires, the request fails and returns anerror.
793: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
794: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
795: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
796: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
797: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
798: *
799: * @param array $params Associative array of parameters
800: * @return array
801: */
802: public function getSettings(array $params = [])
803: {
804: $name = $this->extractArgument($params, 'name');
805: $index = $this->extractArgument($params, 'index');
806:
807: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\GetSettings::class);
808: $endpoint->setParams($params);
809: $endpoint->setName($name);
810: $endpoint->setIndex($index);
811:
812: return $this->performRequest($endpoint);
813: }
814:
815: /**
816: * Returns an index template.
817: *
818: * $params['name'] = (array) Comma-separated list of index template names used to limit the request. Wildcard (`*`) expressions are supported. To return all index templates, omit this parameter or use a value of `_all` or `*`.
819: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
820: * $params['flat_settings'] = (boolean) If `true`, returns settings in flat format. (Default = false)
821: * $params['local'] = (boolean) If `true`, the request retrieves information from the local node only. (Default = false)
822: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
823: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
824: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
825: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
826: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
827: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
828: *
829: * @param array $params Associative array of parameters
830: * @return array
831: */
832: public function getTemplate(array $params = [])
833: {
834: $name = $this->extractArgument($params, 'name');
835:
836: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\GetTemplate::class);
837: $endpoint->setParams($params);
838: $endpoint->setName($name);
839:
840: return $this->performRequest($endpoint);
841: }
842:
843: /**
844: * The _upgrade API is no longer useful and will be removed.
845: *
846: * $params['index'] = (array) Comma-separated list of indexes; use `_all` or empty string to perform the operation on all indexes.
847: * $params['allow_no_indices'] = (boolean) Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have been specified).
848: * $params['expand_wildcards'] = (any) Whether to expand wildcard expression to concrete indexes that are open, closed or both.
849: * $params['ignore_unavailable'] = (boolean) Whether specified concrete indexes should be ignored when unavailable (missing or closed).
850: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
851: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
852: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
853: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
854: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
855: *
856: * @param array $params Associative array of parameters
857: * @return array
858: */
859: public function getUpgrade(array $params = [])
860: {
861: $index = $this->extractArgument($params, 'index');
862:
863: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\GetUpgrade::class);
864: $endpoint->setParams($params);
865: $endpoint->setIndex($index);
866:
867: return $this->performRequest($endpoint);
868: }
869:
870: /**
871: * Opens an index.
872: *
873: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). By default, you must explicitly name the indexes you using to limit the request. To limit a request using `_all`, `*`, or other wildcard expressions, change the `action.destructive_requires_name` setting to false. You can update this setting in the `opensearch.yml` file or using the cluster update settings API.
874: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
875: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
876: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
877: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
878: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
879: * $params['task_execution_timeout'] = (string) Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.
880: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
881: * $params['wait_for_active_shards'] = (any) The number of shard copies that must be active before proceeding with the operation.Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
882: * $params['wait_for_completion'] = (boolean) Should this request wait until the operation has completed before returning. (Default = true)
883: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
884: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
885: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
886: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
887: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
888: *
889: * @param array $params Associative array of parameters
890: * @return array
891: */
892: public function open(array $params = [])
893: {
894: $index = $this->extractArgument($params, 'index');
895:
896: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Open::class);
897: $endpoint->setParams($params);
898: $endpoint->setIndex($index);
899:
900: return $this->performRequest($endpoint);
901: }
902:
903: /**
904: * Creates or updates an alias.
905: *
906: * $params['name'] = (string) Alias to update. If the alias doesn't exist, the request creates it. Index alias names support date math.
907: * $params['index'] = (array) Comma-separated list of data streams or indexes to add. Supports wildcards (`*`). Wildcard patterns that match both data streams and indexes return an error.
908: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
909: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
910: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
911: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
912: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
913: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
914: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
915: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
916: * $params['body'] = (array) The settings for the alias, such as `routing` or `filter`
917: *
918: * @param array $params Associative array of parameters
919: * @return array
920: */
921: public function putAlias(array $params = [])
922: {
923: $name = $this->extractArgument($params, 'name');
924: $index = $this->extractArgument($params, 'index');
925: $body = $this->extractArgument($params, 'body');
926:
927: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\PutAlias::class);
928: $endpoint->setParams($params);
929: $endpoint->setName($name);
930: $endpoint->setIndex($index);
931: $endpoint->setBody($body);
932:
933: return $this->performRequest($endpoint);
934: }
935:
936: /**
937: * Creates or updates an index template.
938: *
939: * $params['name'] = (string) Index or template name
940: * $params['cause'] = (string) User defined reason for creating/updating the index template. (Default = false)
941: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
942: * $params['create'] = (boolean) If `true`, this request cannot replace or update existing index templates. (Default = false)
943: * $params['master_timeout'] = (string) Operation timeout for connection to master node.
944: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
945: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
946: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
947: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
948: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
949: * $params['body'] = (array) The template definition (Required)
950: *
951: * @param array $params Associative array of parameters
952: * @return array
953: */
954: public function putIndexTemplate(array $params = [])
955: {
956: $name = $this->extractArgument($params, 'name');
957: $body = $this->extractArgument($params, 'body');
958:
959: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\PutIndexTemplate::class);
960: $endpoint->setParams($params);
961: $endpoint->setName($name);
962: $endpoint->setBody($body);
963:
964: return $this->performRequest($endpoint);
965: }
966:
967: /**
968: * Updates the index mappings.
969: *
970: * $params['index'] = (array) A comma-separated list of index names the mapping should be added to (supports wildcards); use `_all` or omit to add the mapping on all indexes.
971: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
972: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
973: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
974: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
975: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
976: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
977: * $params['write_index_only'] = (boolean) If `true`, the mappings are applied only to the current write index for the target. (Default = false)
978: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
979: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
980: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
981: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
982: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
983: * $params['body'] = (array) The mapping definition (Required)
984: *
985: * @param array $params Associative array of parameters
986: * @return array
987: */
988: public function putMapping(array $params = [])
989: {
990: $index = $this->extractArgument($params, 'index');
991: $body = $this->extractArgument($params, 'body');
992:
993: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\PutMapping::class);
994: $endpoint->setParams($params);
995: $endpoint->setIndex($index);
996: $endpoint->setBody($body);
997:
998: return $this->performRequest($endpoint);
999: }
1000:
1001: /**
1002: * Updates the index settings.
1003: *
1004: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
1005: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, indexalias, or `_all` value targets only missing or closed indexes. Thisbehavior applies even if the request targets other open indexes. Forexample, a request targeting `foo*,bar*` returns an error if an indexstarts with `foo` but no index starts with `bar`.
1006: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
1007: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match. If the request can targetdata streams, this argument determines whether wildcard expressions matchhidden data streams. Supports comma-separated values, such as`open,hidden`.
1008: * $params['flat_settings'] = (boolean) If `true`, returns settings in flat format. (Default = false)
1009: * $params['ignore_unavailable'] = (boolean) Whether specified concrete indexes should be ignored when unavailable (missing or closed).
1010: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response isreceived before the timeout expires, the request fails and returns anerror.
1011: * $params['preserve_existing'] = (boolean) If `true`, existing index settings remain unchanged. (Default = false)
1012: * $params['timeout'] = (string) Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
1013: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1014: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1015: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1016: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1017: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1018: *
1019: * @param array $params Associative array of parameters
1020: * @return array
1021: */
1022: public function putSettings(array $params = [])
1023: {
1024: $index = $this->extractArgument($params, 'index');
1025: $body = $this->extractArgument($params, 'body');
1026:
1027: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\PutSettings::class);
1028: $endpoint->setParams($params);
1029: $endpoint->setIndex($index);
1030: $endpoint->setBody($body);
1031:
1032: return $this->performRequest($endpoint);
1033: }
1034:
1035: /**
1036: * Creates or updates an index template.
1037: *
1038: * $params['name'] = (string) The name of the template
1039: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
1040: * $params['create'] = (boolean) If true, this request cannot replace or update existing index templates. (Default = false)
1041: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response isreceived before the timeout expires, the request fails and returns an error.
1042: * $params['order'] = (number) Order in which OpenSearch applies this template if indexmatches multiple templates.Templates with lower 'order' values are merged first. Templates with higher'order' values are merged later, overriding templates with lower values.
1043: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1044: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1045: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1046: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1047: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1048: * $params['body'] = (array) The template definition (Required)
1049: *
1050: * @param array $params Associative array of parameters
1051: * @return array
1052: */
1053: public function putTemplate(array $params = [])
1054: {
1055: $name = $this->extractArgument($params, 'name');
1056: $body = $this->extractArgument($params, 'body');
1057:
1058: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\PutTemplate::class);
1059: $endpoint->setParams($params);
1060: $endpoint->setName($name);
1061: $endpoint->setBody($body);
1062:
1063: return $this->performRequest($endpoint);
1064: }
1065:
1066: /**
1067: * Returns information about ongoing index shard recoveries.
1068: *
1069: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
1070: * $params['active_only'] = (boolean) If `true`, the response only includes ongoing shard recoveries. (Default = false)
1071: * $params['detailed'] = (boolean) If `true`, the response includes detailed information about shard recoveries. (Default = false)
1072: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1073: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1074: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1075: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1076: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1077: *
1078: * @param array $params Associative array of parameters
1079: * @return array
1080: */
1081: public function recovery(array $params = [])
1082: {
1083: $index = $this->extractArgument($params, 'index');
1084:
1085: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Recovery::class);
1086: $endpoint->setParams($params);
1087: $endpoint->setIndex($index);
1088:
1089: return $this->performRequest($endpoint);
1090: }
1091:
1092: /**
1093: * Performs the refresh operation in one or more indexes.
1094: *
1095: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
1096: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
1097: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
1098: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
1099: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1100: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1101: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1102: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1103: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1104: *
1105: * @param array $params Associative array of parameters
1106: * @return array
1107: */
1108: public function refresh(array $params = [])
1109: {
1110: $index = $this->extractArgument($params, 'index');
1111:
1112: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Refresh::class);
1113: $endpoint->setParams($params);
1114: $endpoint->setIndex($index);
1115:
1116: return $this->performRequest($endpoint);
1117: }
1118:
1119: /**
1120: * Returns information about any matching indexes, aliases, and data streams.
1121: *
1122: * $params['name'] = (array) Comma-separated name(s) or index pattern(s) of the indexes, aliases, and data streams to resolve. Resources on remote clusters can be specified using the `<cluster>`:`<name>` syntax.
1123: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
1124: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1125: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1126: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1127: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1128: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1129: *
1130: * @param array $params Associative array of parameters
1131: * @return array
1132: */
1133: public function resolveIndex(array $params = [])
1134: {
1135: $name = $this->extractArgument($params, 'name');
1136:
1137: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\ResolveIndex::class);
1138: $endpoint->setParams($params);
1139: $endpoint->setName($name);
1140:
1141: return $this->performRequest($endpoint);
1142: }
1143:
1144: /**
1145: * Updates an alias to point to a new index when the existing indexis considered to be too large or too old.
1146: *
1147: * $params['alias'] = (string) Name of the data stream or index alias to roll over. (Required)
1148: * $params['new_index'] = (string) Name of the index to create. Supports date math. Data streams do not support this parameter.
1149: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
1150: * $params['dry_run'] = (boolean) If `true`, checks whether the current index satisfies the specified conditions but does not perform a rollover. (Default = false)
1151: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
1152: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
1153: * $params['wait_for_active_shards'] = (any) The number of shard copies that must be active before proceeding with the operation.Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
1154: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1155: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1156: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1157: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1158: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1159: * $params['body'] = (array) The conditions that needs to be met for executing rollover
1160: *
1161: * @param array $params Associative array of parameters
1162: * @return array
1163: */
1164: public function rollover(array $params = [])
1165: {
1166: $alias = $this->extractArgument($params, 'alias');
1167: $new_index = $this->extractArgument($params, 'new_index');
1168: $body = $this->extractArgument($params, 'body');
1169:
1170: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Rollover::class);
1171: $endpoint->setParams($params);
1172: $endpoint->setAlias($alias);
1173: $endpoint->setNewIndex($new_index);
1174: $endpoint->setBody($body);
1175:
1176: return $this->performRequest($endpoint);
1177: }
1178:
1179: /**
1180: * Provides low-level information about segments in a Lucene index.
1181: *
1182: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`.
1183: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
1184: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
1185: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
1186: * $params['verbose'] = (boolean) If `true`, the request returns a verbose response. (Default = false)
1187: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1188: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1189: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1190: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1191: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1192: *
1193: * @param array $params Associative array of parameters
1194: * @return array
1195: */
1196: public function segments(array $params = [])
1197: {
1198: $index = $this->extractArgument($params, 'index');
1199:
1200: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Segments::class);
1201: $endpoint->setParams($params);
1202: $endpoint->setIndex($index);
1203:
1204: return $this->performRequest($endpoint);
1205: }
1206:
1207: /**
1208: * Provides store information for shard copies of indexes.
1209: *
1210: * $params['index'] = (array) List of data streams, indexes, and aliases used to limit the request.
1211: * $params['allow_no_indices'] = (boolean) If false, the request returns an error if any wildcard expression, index alias, or _allvalue targets only missing or closed indexes. This behavior applies even if the requesttargets other open indexes.
1212: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match. If the request can target data streams,this argument determines whether wildcard expressions match hidden data streams.
1213: * $params['ignore_unavailable'] = (boolean) If true, missing or closed indexes are not included in the response.
1214: * $params['status'] = (any) List of shard health statuses used to limit the request.
1215: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1216: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1217: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1218: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1219: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1220: *
1221: * @param array $params Associative array of parameters
1222: * @return array
1223: */
1224: public function shardStores(array $params = [])
1225: {
1226: $index = $this->extractArgument($params, 'index');
1227:
1228: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\ShardStores::class);
1229: $endpoint->setParams($params);
1230: $endpoint->setIndex($index);
1231:
1232: return $this->performRequest($endpoint);
1233: }
1234:
1235: /**
1236: * Allow to shrink an existing index into a new index with fewer primary shards.
1237: *
1238: * $params['index'] = (string) Name of the source index to shrink.
1239: * $params['target'] = (string) Name of the target index to create.
1240: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
1241: * $params['copy_settings'] = (boolean) whether or not to copy settings from the source index. (Default = false)
1242: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
1243: * $params['task_execution_timeout'] = (string) Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.
1244: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
1245: * $params['wait_for_active_shards'] = (any) The number of shard copies that must be active before proceeding with the operation.Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
1246: * $params['wait_for_completion'] = (boolean) Should this request wait until the operation has completed before returning. (Default = true)
1247: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1248: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1249: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1250: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1251: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1252: * $params['body'] = (array) The configuration for the target index (`settings` and `aliases`)
1253: *
1254: * @param array $params Associative array of parameters
1255: * @return array
1256: */
1257: public function shrink(array $params = [])
1258: {
1259: $index = $this->extractArgument($params, 'index');
1260: $target = $this->extractArgument($params, 'target');
1261: $body = $this->extractArgument($params, 'body');
1262:
1263: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Shrink::class);
1264: $endpoint->setParams($params);
1265: $endpoint->setIndex($index);
1266: $endpoint->setTarget($target);
1267: $endpoint->setBody($body);
1268:
1269: return $this->performRequest($endpoint);
1270: }
1271:
1272: /**
1273: * Simulate matching the given index name against the index templates in the system.
1274: *
1275: * $params['name'] = (string) Index or template name to simulate
1276: * $params['cause'] = (string) User defined reason for dry-run creating the new template for simulation purposes. (Default = false)
1277: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
1278: * $params['create'] = (boolean) If `true`, the template passed in the body is only used if no existingtemplates match the same index patterns. If `false`, the simulation usesthe template with the highest priority. Note that the template is notpermanently added or updated in either case; it is only used for thesimulation. (Default = false)
1279: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response is receivedbefore the timeout expires, the request fails and returns an error.
1280: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1281: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1282: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1283: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1284: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1285: * $params['body'] = (array) New index template definition, which will be included in the simulation, as if it already exists in the system
1286: *
1287: * @param array $params Associative array of parameters
1288: * @return array
1289: */
1290: public function simulateIndexTemplate(array $params = [])
1291: {
1292: $name = $this->extractArgument($params, 'name');
1293: $body = $this->extractArgument($params, 'body');
1294:
1295: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\SimulateIndexTemplate::class);
1296: $endpoint->setParams($params);
1297: $endpoint->setName($name);
1298: $endpoint->setBody($body);
1299:
1300: return $this->performRequest($endpoint);
1301: }
1302:
1303: /**
1304: * Simulate resolving the given template name or body.
1305: *
1306: * $params['name'] = (string) Name of the index template to simulate. To test a template configuration before you add it to the cluster, omit this parameter and specify the template configuration in the request body.
1307: * $params['cause'] = (string) User defined reason for dry-run creating the new template for simulation purposes. (Default = false)
1308: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
1309: * $params['create'] = (boolean) If true, the template passed in the body is only used if no existing templates match the same index patterns. If false, the simulation uses the template with the highest priority. Note that the template is not permanently added or updated in either case; it is only used for the simulation. (Default = false)
1310: * $params['master_timeout'] = (string) Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.
1311: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1312: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1313: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1314: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1315: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1316: *
1317: * @param array $params Associative array of parameters
1318: * @return array
1319: */
1320: public function simulateTemplate(array $params = [])
1321: {
1322: $name = $this->extractArgument($params, 'name');
1323: $body = $this->extractArgument($params, 'body');
1324:
1325: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\SimulateTemplate::class);
1326: $endpoint->setParams($params);
1327: $endpoint->setName($name);
1328: $endpoint->setBody($body);
1329:
1330: return $this->performRequest($endpoint);
1331: }
1332:
1333: /**
1334: * Allows you to split an existing index into a new index with more primary shards.
1335: *
1336: * $params['index'] = (string) Name of the source index to split.
1337: * $params['target'] = (string) Name of the target index to create.
1338: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
1339: * $params['copy_settings'] = (boolean) whether or not to copy settings from the source index. (Default = false)
1340: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
1341: * $params['task_execution_timeout'] = (string) Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.
1342: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
1343: * $params['wait_for_active_shards'] = (any) The number of shard copies that must be active before proceeding with the operation.Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).
1344: * $params['wait_for_completion'] = (boolean) Should this request wait until the operation has completed before returning. (Default = true)
1345: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1346: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1347: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1348: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1349: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1350: * $params['body'] = (array) The configuration for the target index (`settings` and `aliases`)
1351: *
1352: * @param array $params Associative array of parameters
1353: * @return array
1354: */
1355: public function split(array $params = [])
1356: {
1357: $index = $this->extractArgument($params, 'index');
1358: $target = $this->extractArgument($params, 'target');
1359: $body = $this->extractArgument($params, 'body');
1360:
1361: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Split::class);
1362: $endpoint->setParams($params);
1363: $endpoint->setIndex($index);
1364: $endpoint->setTarget($target);
1365: $endpoint->setBody($body);
1366:
1367: return $this->performRequest($endpoint);
1368: }
1369:
1370: /**
1371: * Provides statistics on operations happening in an index.
1372: *
1373: * $params['metric'] = (array) Limit the information returned the specific metrics.
1374: * $params['index'] = (array) A comma-separated list of index names; use `_all` or empty string to perform the operation on all indexes
1375: * $params['completion_fields'] = (any) Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics.
1376: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match. If the request can target data streams, this argumentdetermines whether wildcard expressions match hidden data streams. Supports comma-separated values,such as `open,hidden`.
1377: * $params['fielddata_fields'] = (any) Comma-separated list or wildcard expressions of fields to include in fielddata statistics.
1378: * $params['fields'] = (any) Comma-separated list or wildcard expressions of fields to include in the statistics.
1379: * $params['forbid_closed_indices'] = (boolean) If true, statistics are not collected from closed indexes. (Default = true)
1380: * $params['groups'] = (any) Comma-separated list of search groups to include in the search statistics.
1381: * $params['include_segment_file_sizes'] = (boolean) If true, the call reports the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested). (Default = false)
1382: * $params['include_unloaded_segments'] = (boolean) If true, the response includes information from segments that are not loaded into memory. (Default = false)
1383: * $params['level'] = (enum) Indicates whether statistics are aggregated at the cluster, index, or shard level. (Options = cluster,indices,shards)
1384: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1385: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1386: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1387: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1388: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1389: *
1390: * @param array $params Associative array of parameters
1391: * @return array
1392: */
1393: public function stats(array $params = [])
1394: {
1395: $metric = $this->extractArgument($params, 'metric');
1396: $index = $this->extractArgument($params, 'index');
1397:
1398: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Stats::class);
1399: $endpoint->setParams($params);
1400: $endpoint->setMetric($metric);
1401: $endpoint->setIndex($index);
1402:
1403: return $this->performRequest($endpoint);
1404: }
1405:
1406: /**
1407: * Updates index aliases.
1408: *
1409: * $params['cluster_manager_timeout'] = (string) Operation timeout for connection to cluster-manager node.
1410: * $params['master_timeout'] = (string) Period to wait for a connection to the master node.If no response is received before the timeout expires, the request fails and returns an error.
1411: * $params['timeout'] = (string) Period to wait for a response.If no response is received before the timeout expires, the request fails and returns an error.
1412: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1413: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1414: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1415: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1416: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1417: * $params['body'] = (array) The definition of `actions` to perform (Required)
1418: *
1419: * @param array $params Associative array of parameters
1420: * @return array
1421: */
1422: public function updateAliases(array $params = [])
1423: {
1424: $body = $this->extractArgument($params, 'body');
1425:
1426: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\UpdateAliases::class);
1427: $endpoint->setParams($params);
1428: $endpoint->setBody($body);
1429:
1430: return $this->performRequest($endpoint);
1431: }
1432:
1433: /**
1434: * The _upgrade API is no longer useful and will be removed.
1435: *
1436: * $params['index'] = (array) Comma-separated list of indexes; use `_all` or empty string to perform the operation on all indexes.
1437: * $params['allow_no_indices'] = (boolean) Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have been specified).
1438: * $params['expand_wildcards'] = (any) Whether to expand wildcard expression to concrete indexes that are open, closed or both.
1439: * $params['ignore_unavailable'] = (boolean) Whether specified concrete indexes should be ignored when unavailable (missing or closed).
1440: * $params['only_ancient_segments'] = (boolean) If true, only ancient (an older Lucene major release) segments will be upgraded.
1441: * $params['wait_for_completion'] = (boolean) Should this request wait until the operation has completed before returning. (Default = false)
1442: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1443: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1444: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1445: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1446: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1447: *
1448: * @param array $params Associative array of parameters
1449: * @return array
1450: */
1451: public function upgrade(array $params = [])
1452: {
1453: $index = $this->extractArgument($params, 'index');
1454:
1455: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\Upgrade::class);
1456: $endpoint->setParams($params);
1457: $endpoint->setIndex($index);
1458:
1459: return $this->performRequest($endpoint);
1460: }
1461:
1462: /**
1463: * Allows a user to validate a potentially expensive query without executing it.
1464: *
1465: * $params['index'] = (array) Comma-separated list of data streams, indexes, and aliases to search. Supports wildcards (`*`). To search all data streams or indexes, omit this parameter or use `*` or `_all`.
1466: * $params['all_shards'] = (boolean) If `true`, the validation is executed on all shards instead of one random shard per index.
1467: * $params['allow_no_indices'] = (boolean) If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indexes.This behavior applies even if the request targets other open indexes.
1468: * $params['analyze_wildcard'] = (boolean) If `true`, wildcard and prefix queries are analyzed. (Default = false)
1469: * $params['analyzer'] = (string) Analyzer to use for the query string.This parameter can only be used when the `q` query string parameter is specified.
1470: * $params['default_operator'] = (enum) The default operator for query string query: `AND` or `OR`. (Options = and,or)
1471: * $params['df'] = (string) Field to use as default where no field prefix is given in the query string.This parameter can only be used when the `q` query string parameter is specified.
1472: * $params['expand_wildcards'] = (any) Type of index that wildcard patterns can match.If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams.Supports comma-separated values, such as `open,hidden`.Valid values are: `all`, `open`, `closed`, `hidden`, `none`.
1473: * $params['explain'] = (boolean) If `true`, the response returns detailed information if an error has occurred.
1474: * $params['ignore_unavailable'] = (boolean) If `false`, the request returns an error if it targets a missing or closed index.
1475: * $params['lenient'] = (boolean) If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored.
1476: * $params['q'] = (string) Query in the Lucene query string syntax.
1477: * $params['rewrite'] = (boolean) If `true`, returns a more detailed explanation showing the actual Lucene query that will be executed.
1478: * $params['pretty'] = (boolean) Whether to pretty format the returned JSON response. (Default = false)
1479: * $params['human'] = (boolean) Whether to return human readable values for statistics. (Default = true)
1480: * $params['error_trace'] = (boolean) Whether to include the stack trace of returned errors. (Default = false)
1481: * $params['source'] = (string) The URL-encoded request definition. Useful for libraries that do not accept a request body for non-POST requests.
1482: * $params['filter_path'] = (any) Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-".
1483: * $params['body'] = (array) The query definition specified with the Query DSL
1484: *
1485: * @param array $params Associative array of parameters
1486: * @return array
1487: */
1488: public function validateQuery(array $params = [])
1489: {
1490: $index = $this->extractArgument($params, 'index');
1491: $body = $this->extractArgument($params, 'body');
1492:
1493: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\ValidateQuery::class);
1494: $endpoint->setParams($params);
1495: $endpoint->setIndex($index);
1496: $endpoint->setBody($body);
1497:
1498: return $this->performRequest($endpoint);
1499: }
1500:
1501: /**
1502: * Alias function to getAlias()
1503: *
1504: * @deprecated added to prevent BC break introduced in 7.2.0
1505: * @see https://github.com/elastic/elasticsearch-php/issues/940
1506: */
1507: public function getAliases(array $params = [])
1508: {
1509: return $this->getAlias($params);
1510: }
1511: /**
1512: * $params['index'] = (list) A comma-separated list of index names to refresh analyzers for
1513: *
1514: * @param array $params Associative array of parameters
1515: * @return array
1516: */
1517: public function refreshSearchAnalyzers(array $params = [])
1518: {
1519: $index = $this->extractArgument($params, 'index');
1520:
1521: $endpoint = $this->endpointFactory->getEndpoint(\OpenSearch\Endpoints\Indices\RefreshSearchAnalyzers::class);
1522: $endpoint->setParams($params);
1523: $endpoint->setIndex($index);
1524:
1525: return $this->performRequest($endpoint);
1526: }
1527: }
1528: