elasticsearch 9.1.1__py3-none-any.whl → 9.1.2__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- elasticsearch/_async/client/__init__.py +2 -0
- elasticsearch/_async/client/cat.py +481 -25
- elasticsearch/_async/client/connector.py +3 -3
- elasticsearch/_async/client/indices.py +23 -9
- elasticsearch/_async/client/inference.py +11 -1
- elasticsearch/_async/client/logstash.py +3 -1
- elasticsearch/_async/client/nodes.py +2 -2
- elasticsearch/_async/client/shutdown.py +5 -15
- elasticsearch/_async/client/streams.py +186 -0
- elasticsearch/_async/client/watcher.py +1 -5
- elasticsearch/_async/helpers.py +58 -9
- elasticsearch/_sync/client/__init__.py +2 -0
- elasticsearch/_sync/client/cat.py +481 -25
- elasticsearch/_sync/client/connector.py +3 -3
- elasticsearch/_sync/client/indices.py +23 -9
- elasticsearch/_sync/client/inference.py +11 -1
- elasticsearch/_sync/client/logstash.py +3 -1
- elasticsearch/_sync/client/nodes.py +2 -2
- elasticsearch/_sync/client/shutdown.py +5 -15
- elasticsearch/_sync/client/streams.py +186 -0
- elasticsearch/_sync/client/watcher.py +1 -5
- elasticsearch/_version.py +2 -1
- elasticsearch/client.py +2 -0
- elasticsearch/compat.py +43 -1
- elasticsearch/dsl/__init__.py +28 -0
- elasticsearch/dsl/aggs.py +97 -0
- elasticsearch/dsl/document_base.py +15 -0
- elasticsearch/dsl/field.py +21 -2
- elasticsearch/dsl/query.py +5 -1
- elasticsearch/dsl/response/__init__.py +3 -0
- elasticsearch/dsl/types.py +226 -14
- elasticsearch/helpers/__init__.py +10 -1
- elasticsearch/helpers/actions.py +106 -33
- {elasticsearch-9.1.1.dist-info → elasticsearch-9.1.2.dist-info}/METADATA +2 -2
- {elasticsearch-9.1.1.dist-info → elasticsearch-9.1.2.dist-info}/RECORD +38 -36
- {elasticsearch-9.1.1.dist-info → elasticsearch-9.1.2.dist-info}/WHEEL +0 -0
- {elasticsearch-9.1.1.dist-info → elasticsearch-9.1.2.dist-info}/licenses/LICENSE +0 -0
- {elasticsearch-9.1.1.dist-info → elasticsearch-9.1.2.dist-info}/licenses/NOTICE +0 -0
|
@@ -103,7 +103,7 @@ class ConnectorClient(NamespacedClient):
|
|
|
103
103
|
|
|
104
104
|
:param connector_id: The unique identifier of the connector to be deleted
|
|
105
105
|
:param delete_sync_jobs: A flag indicating if associated sync jobs should be
|
|
106
|
-
also removed.
|
|
106
|
+
also removed.
|
|
107
107
|
:param hard: A flag indicating if the connector should be hard deleted.
|
|
108
108
|
"""
|
|
109
109
|
if connector_id in SKIP_IN_PATH:
|
|
@@ -360,7 +360,7 @@ class ConnectorClient(NamespacedClient):
|
|
|
360
360
|
|
|
361
361
|
:param connector_name: A comma-separated list of connector names to fetch connector
|
|
362
362
|
documents for
|
|
363
|
-
:param from_: Starting offset
|
|
363
|
+
:param from_: Starting offset
|
|
364
364
|
:param include_deleted: A flag to indicate if the desired connector should be
|
|
365
365
|
fetched, even if it was soft-deleted.
|
|
366
366
|
:param index_name: A comma-separated list of connector index names to fetch connector
|
|
@@ -955,7 +955,7 @@ class ConnectorClient(NamespacedClient):
|
|
|
955
955
|
`<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-connector-sync-job-list>`_
|
|
956
956
|
|
|
957
957
|
:param connector_id: A connector id to fetch connector sync jobs for
|
|
958
|
-
:param from_: Starting offset
|
|
958
|
+
:param from_: Starting offset
|
|
959
959
|
:param job_type: A comma-separated list of job types to fetch the sync jobs for
|
|
960
960
|
:param size: Specifies a max number of results to get
|
|
961
961
|
:param status: A sync job status to fetch connector sync jobs for
|
|
@@ -812,11 +812,7 @@ class IndicesClient(NamespacedClient):
|
|
|
812
812
|
raise ValueError("Empty value passed for parameter 'source'")
|
|
813
813
|
if dest in SKIP_IN_PATH:
|
|
814
814
|
raise ValueError("Empty value passed for parameter 'dest'")
|
|
815
|
-
if create_from is None and body is None:
|
|
816
|
-
raise ValueError(
|
|
817
|
-
"Empty value passed for parameters 'create_from' and 'body', one of them should be set."
|
|
818
|
-
)
|
|
819
|
-
elif create_from is not None and body is not None:
|
|
815
|
+
if create_from is not None and body is not None:
|
|
820
816
|
raise ValueError("Cannot set both 'create_from' and 'body'")
|
|
821
817
|
__path_parts: t.Dict[str, str] = {
|
|
822
818
|
"source": _quote(source),
|
|
@@ -833,7 +829,11 @@ class IndicesClient(NamespacedClient):
|
|
|
833
829
|
if pretty is not None:
|
|
834
830
|
__query["pretty"] = pretty
|
|
835
831
|
__body = create_from if create_from is not None else body
|
|
836
|
-
|
|
832
|
+
if not __body:
|
|
833
|
+
__body = None
|
|
834
|
+
__headers = {"accept": "application/json"}
|
|
835
|
+
if __body is not None:
|
|
836
|
+
__headers["content-type"] = "application/json"
|
|
837
837
|
return self.perform_request( # type: ignore[return-value]
|
|
838
838
|
"PUT",
|
|
839
839
|
__path,
|
|
@@ -4549,6 +4549,7 @@ class IndicesClient(NamespacedClient):
|
|
|
4549
4549
|
For data streams, the API runs the refresh operation on the stream’s backing indices.</p>
|
|
4550
4550
|
<p>By default, Elasticsearch periodically refreshes indices every second, but only on indices that have received one search request or more in the last 30 seconds.
|
|
4551
4551
|
You can change this default interval with the <code>index.refresh_interval</code> setting.</p>
|
|
4552
|
+
<p>In Elastic Cloud Serverless, the default refresh interval is 5 seconds across all indices.</p>
|
|
4552
4553
|
<p>Refresh requests are synchronous and do not return a response until the refresh operation completes.</p>
|
|
4553
4554
|
<p>Refreshes are resource-intensive.
|
|
4554
4555
|
To ensure good cluster performance, it's recommended to wait for Elasticsearch's periodic refresh rather than performing an explicit refresh when possible.</p>
|
|
@@ -5414,7 +5415,9 @@ class IndicesClient(NamespacedClient):
|
|
|
5414
5415
|
path_parts=__path_parts,
|
|
5415
5416
|
)
|
|
5416
5417
|
|
|
5417
|
-
@_rewrite_parameters(
|
|
5418
|
+
@_rewrite_parameters(
|
|
5419
|
+
body_name="index_template",
|
|
5420
|
+
)
|
|
5418
5421
|
def simulate_index_template(
|
|
5419
5422
|
self,
|
|
5420
5423
|
*,
|
|
@@ -5425,6 +5428,8 @@ class IndicesClient(NamespacedClient):
|
|
|
5425
5428
|
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
|
|
5426
5429
|
human: t.Optional[bool] = None,
|
|
5427
5430
|
include_defaults: t.Optional[bool] = None,
|
|
5431
|
+
index_template: t.Optional[t.Mapping[str, t.Any]] = None,
|
|
5432
|
+
body: t.Optional[t.Mapping[str, t.Any]] = None,
|
|
5428
5433
|
master_timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
5429
5434
|
pretty: t.Optional[bool] = None,
|
|
5430
5435
|
) -> ObjectApiResponse[t.Any]:
|
|
@@ -5444,12 +5449,15 @@ class IndicesClient(NamespacedClient):
|
|
|
5444
5449
|
only be dry-run added if new or can also replace an existing one
|
|
5445
5450
|
:param include_defaults: If true, returns all relevant default configurations
|
|
5446
5451
|
for the index template.
|
|
5452
|
+
:param index_template:
|
|
5447
5453
|
:param master_timeout: Period to wait for a connection to the master node. If
|
|
5448
5454
|
no response is received before the timeout expires, the request fails and
|
|
5449
5455
|
returns an error.
|
|
5450
5456
|
"""
|
|
5451
5457
|
if name in SKIP_IN_PATH:
|
|
5452
5458
|
raise ValueError("Empty value passed for parameter 'name'")
|
|
5459
|
+
if index_template is not None and body is not None:
|
|
5460
|
+
raise ValueError("Cannot set both 'index_template' and 'body'")
|
|
5453
5461
|
__path_parts: t.Dict[str, str] = {"name": _quote(name)}
|
|
5454
5462
|
__path = f'/_index_template/_simulate_index/{__path_parts["name"]}'
|
|
5455
5463
|
__query: t.Dict[str, t.Any] = {}
|
|
@@ -5469,12 +5477,18 @@ class IndicesClient(NamespacedClient):
|
|
|
5469
5477
|
__query["master_timeout"] = master_timeout
|
|
5470
5478
|
if pretty is not None:
|
|
5471
5479
|
__query["pretty"] = pretty
|
|
5480
|
+
__body = index_template if index_template is not None else body
|
|
5481
|
+
if not __body:
|
|
5482
|
+
__body = None
|
|
5472
5483
|
__headers = {"accept": "application/json"}
|
|
5484
|
+
if __body is not None:
|
|
5485
|
+
__headers["content-type"] = "application/json"
|
|
5473
5486
|
return self.perform_request( # type: ignore[return-value]
|
|
5474
5487
|
"POST",
|
|
5475
5488
|
__path,
|
|
5476
5489
|
params=__query,
|
|
5477
5490
|
headers=__headers,
|
|
5491
|
+
body=__body,
|
|
5478
5492
|
endpoint_id="indices.simulate_index_template",
|
|
5479
5493
|
path_parts=__path_parts,
|
|
5480
5494
|
)
|
|
@@ -5823,8 +5837,8 @@ class IndicesClient(NamespacedClient):
|
|
|
5823
5837
|
are requested).
|
|
5824
5838
|
:param include_unloaded_segments: If true, the response includes information
|
|
5825
5839
|
from segments that are not loaded into memory.
|
|
5826
|
-
:param level: Indicates whether statistics are aggregated at the cluster,
|
|
5827
|
-
or
|
|
5840
|
+
:param level: Indicates whether statistics are aggregated at the cluster, indices,
|
|
5841
|
+
or shards level.
|
|
5828
5842
|
"""
|
|
5829
5843
|
__path_parts: t.Dict[str, str]
|
|
5830
5844
|
if index not in SKIP_IN_PATH and metric not in SKIP_IN_PATH:
|
|
@@ -2504,7 +2504,7 @@ class InferenceClient(NamespacedClient):
|
|
|
2504
2504
|
)
|
|
2505
2505
|
|
|
2506
2506
|
@_rewrite_parameters(
|
|
2507
|
-
body_fields=("input", "task_settings"),
|
|
2507
|
+
body_fields=("input", "input_type", "task_settings"),
|
|
2508
2508
|
)
|
|
2509
2509
|
def text_embedding(
|
|
2510
2510
|
self,
|
|
@@ -2514,6 +2514,7 @@ class InferenceClient(NamespacedClient):
|
|
|
2514
2514
|
error_trace: t.Optional[bool] = None,
|
|
2515
2515
|
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
|
|
2516
2516
|
human: t.Optional[bool] = None,
|
|
2517
|
+
input_type: t.Optional[str] = None,
|
|
2517
2518
|
pretty: t.Optional[bool] = None,
|
|
2518
2519
|
task_settings: t.Optional[t.Any] = None,
|
|
2519
2520
|
timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
@@ -2529,6 +2530,13 @@ class InferenceClient(NamespacedClient):
|
|
|
2529
2530
|
|
|
2530
2531
|
:param inference_id: The inference Id
|
|
2531
2532
|
:param input: Inference input. Either a string or an array of strings.
|
|
2533
|
+
:param input_type: The input data type for the text embedding model. Possible
|
|
2534
|
+
values include: * `SEARCH` * `INGEST` * `CLASSIFICATION` * `CLUSTERING` Not
|
|
2535
|
+
all services support all values. Unsupported values will trigger a validation
|
|
2536
|
+
exception. Accepted values depend on the configured inference service, refer
|
|
2537
|
+
to the relevant service-specific documentation for more info. > info > The
|
|
2538
|
+
`input_type` parameter specified on the root level of the request body will
|
|
2539
|
+
take precedence over the `input_type` parameter specified in `task_settings`.
|
|
2532
2540
|
:param task_settings: Optional task settings
|
|
2533
2541
|
:param timeout: Specifies the amount of time to wait for the inference request
|
|
2534
2542
|
to complete.
|
|
@@ -2554,6 +2562,8 @@ class InferenceClient(NamespacedClient):
|
|
|
2554
2562
|
if not __body:
|
|
2555
2563
|
if input is not None:
|
|
2556
2564
|
__body["input"] = input
|
|
2565
|
+
if input_type is not None:
|
|
2566
|
+
__body["input_type"] = input_type
|
|
2557
2567
|
if task_settings is not None:
|
|
2558
2568
|
__body["task_settings"] = task_settings
|
|
2559
2569
|
if not __body:
|
|
@@ -141,7 +141,9 @@ class LogstashClient(NamespacedClient):
|
|
|
141
141
|
|
|
142
142
|
`<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-logstash-put-pipeline>`_
|
|
143
143
|
|
|
144
|
-
:param id: An identifier for the pipeline.
|
|
144
|
+
:param id: An identifier for the pipeline. Pipeline IDs must begin with a letter
|
|
145
|
+
or underscore and contain only letters, underscores, dashes, hyphens and
|
|
146
|
+
numbers.
|
|
145
147
|
:param pipeline:
|
|
146
148
|
"""
|
|
147
149
|
if id in SKIP_IN_PATH:
|
|
@@ -404,8 +404,8 @@ class NodesClient(NamespacedClient):
|
|
|
404
404
|
are requested).
|
|
405
405
|
:param include_unloaded_segments: If `true`, the response includes information
|
|
406
406
|
from segments that are not loaded into memory.
|
|
407
|
-
:param level: Indicates whether statistics are aggregated at the
|
|
408
|
-
or
|
|
407
|
+
:param level: Indicates whether statistics are aggregated at the node, indices,
|
|
408
|
+
or shards level.
|
|
409
409
|
:param timeout: Period to wait for a response. If no response is received before
|
|
410
410
|
the timeout expires, the request fails and returns an error.
|
|
411
411
|
:param types: A comma-separated list of document types for the indexing index
|
|
@@ -33,13 +33,9 @@ class ShutdownClient(NamespacedClient):
|
|
|
33
33
|
error_trace: t.Optional[bool] = None,
|
|
34
34
|
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
|
|
35
35
|
human: t.Optional[bool] = None,
|
|
36
|
-
master_timeout: t.Optional[
|
|
37
|
-
t.Union[str, t.Literal["d", "h", "m", "micros", "ms", "nanos", "s"]]
|
|
38
|
-
] = None,
|
|
36
|
+
master_timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
39
37
|
pretty: t.Optional[bool] = None,
|
|
40
|
-
timeout: t.Optional[
|
|
41
|
-
t.Union[str, t.Literal["d", "h", "m", "micros", "ms", "nanos", "s"]]
|
|
42
|
-
] = None,
|
|
38
|
+
timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
43
39
|
) -> ObjectApiResponse[t.Any]:
|
|
44
40
|
"""
|
|
45
41
|
.. raw:: html
|
|
@@ -97,9 +93,7 @@ class ShutdownClient(NamespacedClient):
|
|
|
97
93
|
error_trace: t.Optional[bool] = None,
|
|
98
94
|
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
|
|
99
95
|
human: t.Optional[bool] = None,
|
|
100
|
-
master_timeout: t.Optional[
|
|
101
|
-
t.Union[str, t.Literal["d", "h", "m", "micros", "ms", "nanos", "s"]]
|
|
102
|
-
] = None,
|
|
96
|
+
master_timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
103
97
|
pretty: t.Optional[bool] = None,
|
|
104
98
|
) -> ObjectApiResponse[t.Any]:
|
|
105
99
|
"""
|
|
@@ -162,14 +156,10 @@ class ShutdownClient(NamespacedClient):
|
|
|
162
156
|
error_trace: t.Optional[bool] = None,
|
|
163
157
|
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
|
|
164
158
|
human: t.Optional[bool] = None,
|
|
165
|
-
master_timeout: t.Optional[
|
|
166
|
-
t.Union[str, t.Literal["d", "h", "m", "micros", "ms", "nanos", "s"]]
|
|
167
|
-
] = None,
|
|
159
|
+
master_timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
168
160
|
pretty: t.Optional[bool] = None,
|
|
169
161
|
target_node_name: t.Optional[str] = None,
|
|
170
|
-
timeout: t.Optional[
|
|
171
|
-
t.Union[str, t.Literal["d", "h", "m", "micros", "ms", "nanos", "s"]]
|
|
172
|
-
] = None,
|
|
162
|
+
timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
173
163
|
body: t.Optional[t.Dict[str, t.Any]] = None,
|
|
174
164
|
) -> ObjectApiResponse[t.Any]:
|
|
175
165
|
"""
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
# Licensed to Elasticsearch B.V. under one or more contributor
|
|
2
|
+
# license agreements. See the NOTICE file distributed with
|
|
3
|
+
# this work for additional information regarding copyright
|
|
4
|
+
# ownership. Elasticsearch B.V. licenses this file to you under
|
|
5
|
+
# the Apache License, Version 2.0 (the "License"); you may
|
|
6
|
+
# not use this file except in compliance with the License.
|
|
7
|
+
# You may obtain a copy of the License at
|
|
8
|
+
#
|
|
9
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
10
|
+
#
|
|
11
|
+
# Unless required by applicable law or agreed to in writing,
|
|
12
|
+
# software distributed under the License is distributed on an
|
|
13
|
+
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
|
|
14
|
+
# KIND, either express or implied. See the License for the
|
|
15
|
+
# specific language governing permissions and limitations
|
|
16
|
+
# under the License.
|
|
17
|
+
|
|
18
|
+
import typing as t
|
|
19
|
+
|
|
20
|
+
from elastic_transport import ObjectApiResponse, TextApiResponse
|
|
21
|
+
|
|
22
|
+
from ._base import NamespacedClient
|
|
23
|
+
from .utils import (
|
|
24
|
+
Stability,
|
|
25
|
+
_rewrite_parameters,
|
|
26
|
+
_stability_warning,
|
|
27
|
+
)
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
class StreamsClient(NamespacedClient):
|
|
31
|
+
|
|
32
|
+
@_rewrite_parameters()
|
|
33
|
+
@_stability_warning(Stability.EXPERIMENTAL)
|
|
34
|
+
def logs_disable(
|
|
35
|
+
self,
|
|
36
|
+
*,
|
|
37
|
+
error_trace: t.Optional[bool] = None,
|
|
38
|
+
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
|
|
39
|
+
human: t.Optional[bool] = None,
|
|
40
|
+
master_timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
41
|
+
pretty: t.Optional[bool] = None,
|
|
42
|
+
timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
43
|
+
) -> t.Union[ObjectApiResponse[t.Any], TextApiResponse]:
|
|
44
|
+
"""
|
|
45
|
+
.. raw:: html
|
|
46
|
+
|
|
47
|
+
<p>Disable logs stream.</p>
|
|
48
|
+
<p>Turn off the logs stream feature for this cluster.</p>
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
`<https://www.elastic.co/docs/api/doc/elasticsearch#TODO>`_
|
|
52
|
+
|
|
53
|
+
:param master_timeout: The period to wait for a connection to the master node.
|
|
54
|
+
If no response is received before the timeout expires, the request fails
|
|
55
|
+
and returns an error.
|
|
56
|
+
:param timeout: The period to wait for a response. If no response is received
|
|
57
|
+
before the timeout expires, the request fails and returns an error.
|
|
58
|
+
"""
|
|
59
|
+
__path_parts: t.Dict[str, str] = {}
|
|
60
|
+
__path = "/_streams/logs/_disable"
|
|
61
|
+
__query: t.Dict[str, t.Any] = {}
|
|
62
|
+
if error_trace is not None:
|
|
63
|
+
__query["error_trace"] = error_trace
|
|
64
|
+
if filter_path is not None:
|
|
65
|
+
__query["filter_path"] = filter_path
|
|
66
|
+
if human is not None:
|
|
67
|
+
__query["human"] = human
|
|
68
|
+
if master_timeout is not None:
|
|
69
|
+
__query["master_timeout"] = master_timeout
|
|
70
|
+
if pretty is not None:
|
|
71
|
+
__query["pretty"] = pretty
|
|
72
|
+
if timeout is not None:
|
|
73
|
+
__query["timeout"] = timeout
|
|
74
|
+
__headers = {"accept": "application/json,text/plain"}
|
|
75
|
+
return self.perform_request( # type: ignore[return-value]
|
|
76
|
+
"POST",
|
|
77
|
+
__path,
|
|
78
|
+
params=__query,
|
|
79
|
+
headers=__headers,
|
|
80
|
+
endpoint_id="streams.logs_disable",
|
|
81
|
+
path_parts=__path_parts,
|
|
82
|
+
)
|
|
83
|
+
|
|
84
|
+
@_rewrite_parameters()
|
|
85
|
+
@_stability_warning(Stability.EXPERIMENTAL)
|
|
86
|
+
def logs_enable(
|
|
87
|
+
self,
|
|
88
|
+
*,
|
|
89
|
+
error_trace: t.Optional[bool] = None,
|
|
90
|
+
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
|
|
91
|
+
human: t.Optional[bool] = None,
|
|
92
|
+
master_timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
93
|
+
pretty: t.Optional[bool] = None,
|
|
94
|
+
timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
|
|
95
|
+
) -> t.Union[ObjectApiResponse[t.Any], TextApiResponse]:
|
|
96
|
+
"""
|
|
97
|
+
.. raw:: html
|
|
98
|
+
|
|
99
|
+
<p>Enable logs stream.</p>
|
|
100
|
+
<p>Turn on the logs stream feature for this cluster.</p>
|
|
101
|
+
<p>NOTE: To protect existing data, this feature can be turned on only if the
|
|
102
|
+
cluster does not have existing indices or data streams that match the pattern <code>logs|logs.*</code>.
|
|
103
|
+
If those indices or data streams exist, a <code>409 - Conflict</code> response and error is returned.</p>
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
`<https://www.elastic.co/docs/api/doc/elasticsearch#TODO>`_
|
|
107
|
+
|
|
108
|
+
:param master_timeout: The period to wait for a connection to the master node.
|
|
109
|
+
If no response is received before the timeout expires, the request fails
|
|
110
|
+
and returns an error.
|
|
111
|
+
:param timeout: The period to wait for a response. If no response is received
|
|
112
|
+
before the timeout expires, the request fails and returns an error.
|
|
113
|
+
"""
|
|
114
|
+
__path_parts: t.Dict[str, str] = {}
|
|
115
|
+
__path = "/_streams/logs/_enable"
|
|
116
|
+
__query: t.Dict[str, t.Any] = {}
|
|
117
|
+
if error_trace is not None:
|
|
118
|
+
__query["error_trace"] = error_trace
|
|
119
|
+
if filter_path is not None:
|
|
120
|
+
__query["filter_path"] = filter_path
|
|
121
|
+
if human is not None:
|
|
122
|
+
__query["human"] = human
|
|
123
|
+
if master_timeout is not None:
|
|
124
|
+
__query["master_timeout"] = master_timeout
|
|
125
|
+
if pretty is not None:
|
|
126
|
+
__query["pretty"] = pretty
|
|
127
|
+
if timeout is not None:
|
|
128
|
+
__query["timeout"] = timeout
|
|
129
|
+
__headers = {"accept": "application/json,text/plain"}
|
|
130
|
+
return self.perform_request( # type: ignore[return-value]
|
|
131
|
+
"POST",
|
|
132
|
+
__path,
|
|
133
|
+
params=__query,
|
|
134
|
+
headers=__headers,
|
|
135
|
+
endpoint_id="streams.logs_enable",
|
|
136
|
+
path_parts=__path_parts,
|
|
137
|
+
)
|
|
138
|
+
|
|
139
|
+
@_rewrite_parameters()
|
|
140
|
+
@_stability_warning(Stability.EXPERIMENTAL)
|
|
141
|
+
def status(
|
|
142
|
+
self,
|
|
143
|
+
*,
|
|
144
|
+
error_trace: t.Optional[bool] = None,
|
|
145
|
+
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
|
|
146
|
+
human: t.Optional[bool] = None,
|
|
147
|
+
master_timeout: t.Optional[
|
|
148
|
+
t.Union[str, t.Literal["d", "h", "m", "micros", "ms", "nanos", "s"]]
|
|
149
|
+
] = None,
|
|
150
|
+
pretty: t.Optional[bool] = None,
|
|
151
|
+
) -> ObjectApiResponse[t.Any]:
|
|
152
|
+
"""
|
|
153
|
+
.. raw:: html
|
|
154
|
+
|
|
155
|
+
<p>Get the status of streams.</p>
|
|
156
|
+
<p>Get the current status for all types of streams.</p>
|
|
157
|
+
|
|
158
|
+
|
|
159
|
+
`<https://www.elastic.co/docs/api/doc/elasticsearch#TODO>`_
|
|
160
|
+
|
|
161
|
+
:param master_timeout: Period to wait for a connection to the master node. If
|
|
162
|
+
no response is received before the timeout expires, the request fails and
|
|
163
|
+
returns an error.
|
|
164
|
+
"""
|
|
165
|
+
__path_parts: t.Dict[str, str] = {}
|
|
166
|
+
__path = "/_streams/status"
|
|
167
|
+
__query: t.Dict[str, t.Any] = {}
|
|
168
|
+
if error_trace is not None:
|
|
169
|
+
__query["error_trace"] = error_trace
|
|
170
|
+
if filter_path is not None:
|
|
171
|
+
__query["filter_path"] = filter_path
|
|
172
|
+
if human is not None:
|
|
173
|
+
__query["human"] = human
|
|
174
|
+
if master_timeout is not None:
|
|
175
|
+
__query["master_timeout"] = master_timeout
|
|
176
|
+
if pretty is not None:
|
|
177
|
+
__query["pretty"] = pretty
|
|
178
|
+
__headers = {"accept": "application/json"}
|
|
179
|
+
return self.perform_request( # type: ignore[return-value]
|
|
180
|
+
"GET",
|
|
181
|
+
__path,
|
|
182
|
+
params=__query,
|
|
183
|
+
headers=__headers,
|
|
184
|
+
endpoint_id="streams.status",
|
|
185
|
+
path_parts=__path_parts,
|
|
186
|
+
)
|
|
@@ -552,11 +552,7 @@ class WatcherClient(NamespacedClient):
|
|
|
552
552
|
__body["transform"] = transform
|
|
553
553
|
if trigger is not None:
|
|
554
554
|
__body["trigger"] = trigger
|
|
555
|
-
|
|
556
|
-
__body = None # type: ignore[assignment]
|
|
557
|
-
__headers = {"accept": "application/json"}
|
|
558
|
-
if __body is not None:
|
|
559
|
-
__headers["content-type"] = "application/json"
|
|
555
|
+
__headers = {"accept": "application/json", "content-type": "application/json"}
|
|
560
556
|
return self.perform_request( # type: ignore[return-value]
|
|
561
557
|
"PUT",
|
|
562
558
|
__path,
|
elasticsearch/_version.py
CHANGED
elasticsearch/client.py
CHANGED
|
@@ -62,6 +62,7 @@ from ._sync.client.slm import SlmClient as SlmClient # noqa: F401
|
|
|
62
62
|
from ._sync.client.snapshot import SnapshotClient as SnapshotClient # noqa: F401
|
|
63
63
|
from ._sync.client.sql import SqlClient as SqlClient # noqa: F401
|
|
64
64
|
from ._sync.client.ssl import SslClient as SslClient # noqa: F401
|
|
65
|
+
from ._sync.client.streams import StreamsClient as StreamsClient # noqa: F401
|
|
65
66
|
from ._sync.client.synonyms import SynonymsClient as SynonymsClient # noqa: F401
|
|
66
67
|
from ._sync.client.tasks import TasksClient as TasksClient # noqa: F401
|
|
67
68
|
from ._sync.client.text_structure import ( # noqa: F401
|
|
@@ -115,6 +116,7 @@ __all__ = [
|
|
|
115
116
|
"SnapshotClient",
|
|
116
117
|
"SqlClient",
|
|
117
118
|
"SslClient",
|
|
119
|
+
"StreamsClient",
|
|
118
120
|
"TasksClient",
|
|
119
121
|
"TextStructureClient",
|
|
120
122
|
"TransformClient",
|
elasticsearch/compat.py
CHANGED
|
@@ -15,11 +15,14 @@
|
|
|
15
15
|
# specific language governing permissions and limitations
|
|
16
16
|
# under the License.
|
|
17
17
|
|
|
18
|
+
import asyncio
|
|
18
19
|
import inspect
|
|
19
20
|
import os
|
|
20
21
|
import sys
|
|
22
|
+
from contextlib import asynccontextmanager, contextmanager
|
|
21
23
|
from pathlib import Path
|
|
22
|
-
from
|
|
24
|
+
from threading import Thread
|
|
25
|
+
from typing import Any, AsyncIterator, Callable, Coroutine, Iterator, Tuple, Type, Union
|
|
23
26
|
|
|
24
27
|
string_types: Tuple[Type[str], Type[bytes]] = (str, bytes)
|
|
25
28
|
|
|
@@ -76,9 +79,48 @@ def warn_stacklevel() -> int:
|
|
|
76
79
|
return 0
|
|
77
80
|
|
|
78
81
|
|
|
82
|
+
@contextmanager
|
|
83
|
+
def safe_thread(
|
|
84
|
+
target: Callable[..., Any], *args: Any, **kwargs: Any
|
|
85
|
+
) -> Iterator[Thread]:
|
|
86
|
+
"""Run a thread within a context manager block.
|
|
87
|
+
|
|
88
|
+
The thread is automatically joined when the block ends. If the thread raised
|
|
89
|
+
an exception, it is raised in the caller's context.
|
|
90
|
+
"""
|
|
91
|
+
captured_exception = None
|
|
92
|
+
|
|
93
|
+
def run() -> None:
|
|
94
|
+
try:
|
|
95
|
+
target(*args, **kwargs)
|
|
96
|
+
except BaseException as exc:
|
|
97
|
+
nonlocal captured_exception
|
|
98
|
+
captured_exception = exc
|
|
99
|
+
|
|
100
|
+
thread = Thread(target=run)
|
|
101
|
+
thread.start()
|
|
102
|
+
yield thread
|
|
103
|
+
thread.join()
|
|
104
|
+
if captured_exception:
|
|
105
|
+
raise captured_exception
|
|
106
|
+
|
|
107
|
+
|
|
108
|
+
@asynccontextmanager
|
|
109
|
+
async def safe_task(coro: Coroutine[Any, Any, Any]) -> AsyncIterator[asyncio.Task[Any]]:
|
|
110
|
+
"""Run a background task within a context manager block.
|
|
111
|
+
|
|
112
|
+
The task is awaited when the block ends.
|
|
113
|
+
"""
|
|
114
|
+
task = asyncio.create_task(coro)
|
|
115
|
+
yield task
|
|
116
|
+
await task
|
|
117
|
+
|
|
118
|
+
|
|
79
119
|
__all__ = [
|
|
80
120
|
"string_types",
|
|
81
121
|
"to_str",
|
|
82
122
|
"to_bytes",
|
|
83
123
|
"warn_stacklevel",
|
|
124
|
+
"safe_thread",
|
|
125
|
+
"safe_task",
|
|
84
126
|
]
|
elasticsearch/dsl/__init__.py
CHANGED
|
@@ -38,23 +38,30 @@ from .faceted_search import (
|
|
|
38
38
|
TermsFacet,
|
|
39
39
|
)
|
|
40
40
|
from .field import (
|
|
41
|
+
AggregateMetricDouble,
|
|
42
|
+
Alias,
|
|
41
43
|
Binary,
|
|
42
44
|
Boolean,
|
|
43
45
|
Byte,
|
|
44
46
|
Completion,
|
|
45
47
|
ConstantKeyword,
|
|
48
|
+
CountedKeyword,
|
|
46
49
|
CustomField,
|
|
47
50
|
Date,
|
|
51
|
+
DateNanos,
|
|
48
52
|
DateRange,
|
|
49
53
|
DenseVector,
|
|
50
54
|
Double,
|
|
51
55
|
DoubleRange,
|
|
52
56
|
Field,
|
|
57
|
+
Flattened,
|
|
53
58
|
Float,
|
|
54
59
|
FloatRange,
|
|
55
60
|
GeoPoint,
|
|
56
61
|
GeoShape,
|
|
57
62
|
HalfFloat,
|
|
63
|
+
Histogram,
|
|
64
|
+
IcuCollationKeyword,
|
|
58
65
|
Integer,
|
|
59
66
|
IntegerRange,
|
|
60
67
|
Ip,
|
|
@@ -63,21 +70,28 @@ from .field import (
|
|
|
63
70
|
Keyword,
|
|
64
71
|
Long,
|
|
65
72
|
LongRange,
|
|
73
|
+
MatchOnlyText,
|
|
66
74
|
Murmur3,
|
|
67
75
|
Nested,
|
|
68
76
|
Object,
|
|
77
|
+
Passthrough,
|
|
69
78
|
Percolator,
|
|
70
79
|
Point,
|
|
71
80
|
RangeField,
|
|
72
81
|
RankFeature,
|
|
73
82
|
RankFeatures,
|
|
83
|
+
RankVectors,
|
|
74
84
|
ScaledFloat,
|
|
75
85
|
SearchAsYouType,
|
|
86
|
+
SemanticText,
|
|
76
87
|
Shape,
|
|
77
88
|
Short,
|
|
78
89
|
SparseVector,
|
|
79
90
|
Text,
|
|
80
91
|
TokenCount,
|
|
92
|
+
UnsignedLong,
|
|
93
|
+
Version,
|
|
94
|
+
Wildcard,
|
|
81
95
|
construct_field,
|
|
82
96
|
)
|
|
83
97
|
from .function import SF
|
|
@@ -108,6 +122,8 @@ __all__ = [
|
|
|
108
122
|
"A",
|
|
109
123
|
"Agg",
|
|
110
124
|
"AggResponse",
|
|
125
|
+
"AggregateMetricDouble",
|
|
126
|
+
"Alias",
|
|
111
127
|
"AsyncComposableIndexTemplate",
|
|
112
128
|
"AsyncDocument",
|
|
113
129
|
"AsyncEmptySearch",
|
|
@@ -126,9 +142,11 @@ __all__ = [
|
|
|
126
142
|
"Completion",
|
|
127
143
|
"ComposableIndexTemplate",
|
|
128
144
|
"ConstantKeyword",
|
|
145
|
+
"CountedKeyword",
|
|
129
146
|
"CustomField",
|
|
130
147
|
"Date",
|
|
131
148
|
"DateHistogramFacet",
|
|
149
|
+
"DateNanos",
|
|
132
150
|
"DateRange",
|
|
133
151
|
"DenseVector",
|
|
134
152
|
"Document",
|
|
@@ -142,12 +160,15 @@ __all__ = [
|
|
|
142
160
|
"FacetedResponse",
|
|
143
161
|
"FacetedSearch",
|
|
144
162
|
"Field",
|
|
163
|
+
"Flattened",
|
|
145
164
|
"Float",
|
|
146
165
|
"FloatRange",
|
|
147
166
|
"GeoPoint",
|
|
148
167
|
"GeoShape",
|
|
149
168
|
"HalfFloat",
|
|
169
|
+
"Histogram",
|
|
150
170
|
"HistogramFacet",
|
|
171
|
+
"IcuCollationKeyword",
|
|
151
172
|
"IllegalOperation",
|
|
152
173
|
"Index",
|
|
153
174
|
"IndexTemplate",
|
|
@@ -162,12 +183,14 @@ __all__ = [
|
|
|
162
183
|
"LongRange",
|
|
163
184
|
"M",
|
|
164
185
|
"Mapping",
|
|
186
|
+
"MatchOnlyText",
|
|
165
187
|
"MetaField",
|
|
166
188
|
"MultiSearch",
|
|
167
189
|
"Murmur3",
|
|
168
190
|
"Nested",
|
|
169
191
|
"NestedFacet",
|
|
170
192
|
"Object",
|
|
193
|
+
"Passthrough",
|
|
171
194
|
"Percolator",
|
|
172
195
|
"Point",
|
|
173
196
|
"Q",
|
|
@@ -177,11 +200,13 @@ __all__ = [
|
|
|
177
200
|
"RangeField",
|
|
178
201
|
"RankFeature",
|
|
179
202
|
"RankFeatures",
|
|
203
|
+
"RankVectors",
|
|
180
204
|
"Response",
|
|
181
205
|
"SF",
|
|
182
206
|
"ScaledFloat",
|
|
183
207
|
"Search",
|
|
184
208
|
"SearchAsYouType",
|
|
209
|
+
"SemanticText",
|
|
185
210
|
"Shape",
|
|
186
211
|
"Short",
|
|
187
212
|
"SparseVector",
|
|
@@ -189,9 +214,12 @@ __all__ = [
|
|
|
189
214
|
"Text",
|
|
190
215
|
"TokenCount",
|
|
191
216
|
"UnknownDslObject",
|
|
217
|
+
"UnsignedLong",
|
|
192
218
|
"UpdateByQuery",
|
|
193
219
|
"UpdateByQueryResponse",
|
|
194
220
|
"ValidationException",
|
|
221
|
+
"Version",
|
|
222
|
+
"Wildcard",
|
|
195
223
|
"analyzer",
|
|
196
224
|
"async_connections",
|
|
197
225
|
"char_filter",
|