1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
# Licensed to Elasticsearch B.V. under one or more contributor
# license agreements. See the NOTICE file distributed with
# this work for additional information regarding copyright
# ownership. Elasticsearch B.V. licenses this file to you under
# the Apache License, Version 2.0 (the "License"); you may
# not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied. See the License for the
# specific language governing permissions and limitations
# under the License.
import typing as t
from elastic_transport import ObjectApiResponse
from ._base import NamespacedClient
from .utils import _rewrite_parameters
class XPackClient(NamespacedClient):
def __getattr__(self, attr_name: str) -> t.Any:
return getattr(self.client, attr_name)
# AUTO-GENERATED-API-DEFINITIONS #
@_rewrite_parameters()
def info(
self,
*,
accept_enterprise: t.Optional[bool] = None,
categories: t.Optional[
t.Sequence[t.Union[str, t.Literal["build", "features", "license"]]]
] = None,
error_trace: t.Optional[bool] = None,
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
human: t.Optional[bool] = None,
pretty: t.Optional[bool] = None,
) -> ObjectApiResponse[t.Any]:
"""
.. raw:: html
<p>Get information.
The information provided by the API includes:</p>
<ul>
<li>Build information including the build number and timestamp.</li>
<li>License information about the currently installed license.</li>
<li>Feature information for the features that are currently enabled and available under the current license.</li>
</ul>
`<https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-info>`_
:param accept_enterprise: If this param is used it must be set to true
:param categories: A comma-separated list of the information categories to include
in the response. For example, `build,license,features`.
"""
__path_parts: t.Dict[str, str] = {}
__path = "/_xpack"
__query: t.Dict[str, t.Any] = {}
if accept_enterprise is not None:
__query["accept_enterprise"] = accept_enterprise
if categories is not None:
__query["categories"] = categories
if error_trace is not None:
__query["error_trace"] = error_trace
if filter_path is not None:
__query["filter_path"] = filter_path
if human is not None:
__query["human"] = human
if pretty is not None:
__query["pretty"] = pretty
__headers = {"accept": "application/json"}
return self.perform_request( # type: ignore[return-value]
"GET",
__path,
params=__query,
headers=__headers,
endpoint_id="xpack.info",
path_parts=__path_parts,
)
@_rewrite_parameters()
def usage(
self,
*,
error_trace: t.Optional[bool] = None,
filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
human: t.Optional[bool] = None,
master_timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
pretty: t.Optional[bool] = None,
) -> ObjectApiResponse[t.Any]:
"""
.. raw:: html
<p>Get usage information.
Get information about the features that are currently enabled and available under the current license.
The API also provides some usage statistics.</p>
`<https://www.elastic.co/docs/api/doc/elasticsearch/group/endpoint-xpack>`_
:param master_timeout: The 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. To indicate that the request should never timeout,
set it to `-1`.
"""
__path_parts: t.Dict[str, str] = {}
__path = "/_xpack/usage"
__query: t.Dict[str, t.Any] = {}
if error_trace is not None:
__query["error_trace"] = error_trace
if filter_path is not None:
__query["filter_path"] = filter_path
if human is not None:
__query["human"] = human
if master_timeout is not None:
__query["master_timeout"] = master_timeout
if pretty is not None:
__query["pretty"] = pretty
__headers = {"accept": "application/json"}
return self.perform_request( # type: ignore[return-value]
"GET",
__path,
params=__query,
headers=__headers,
endpoint_id="xpack.usage",
path_parts=__path_parts,
)
|
