elasticsearch 9.2.1__py3-none-any.whl → 9.3.0__py3-none-any.whl

elasticsearch/_sync/client/project.py

@@ -38,6 +38,7 @@ class ProjectClient(NamespacedClient):
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
+        project_routing: t.Optional[str] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
         .. raw:: html
@@ -45,6 +46,11 @@ class ProjectClient(NamespacedClient):
           <p>Get tags.</p>
           <p>Get the tags that are defined for the project.</p>
 
+
+        `<https://www.elastic.co/docs/api/doc/elasticsearch-serverless/operation/operation-project-tags>`_
+
+        :param project_routing: A Lucene query using project metadata tags used to filter
+            which projects are returned in the response, such as _alias:_origin or _alias:*pr*.
         """
         __path_parts: t.Dict[str, str] = {}
         __path = "/_project/tags"
@@ -57,9 +63,11 @@ class ProjectClient(NamespacedClient):
             __query["human"] = human
         if pretty is not None:
             __query["pretty"] = pretty
+        if project_routing is not None:
+            __query["project_routing"] = project_routing
         __headers = {"accept": "application/json"}
         return self.perform_request(  # type: ignore[return-value]
-            "GET",
+            "POST",
             __path,
             params=__query,
             headers=__headers,

elasticsearch/_sync/client/project_routing.py

@@ -0,0 +1,264 @@
+#  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 (
+    SKIP_IN_PATH,
+    Stability,
+    _availability_warning,
+    _quote,
+    _rewrite_parameters,
+)
+
+
+class ProjectRoutingClient(NamespacedClient):
+
+    @_rewrite_parameters(
+        body_name="expressions",
+    )
+    @_availability_warning(Stability.EXPERIMENTAL)
+    def create(
+        self,
+        *,
+        name: str,
+        expressions: t.Optional[t.Mapping[str, t.Any]] = None,
+        body: t.Optional[t.Mapping[str, t.Any]] = 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>Create of update a single named project routing expression.</p>
+          <p>Create of update a single named project routing expression.</p>
+
+
+        :param name: The name of project routing expression
+        :param expressions:
+        """
+        if name in SKIP_IN_PATH:
+            raise ValueError("Empty value passed for parameter 'name'")
+        if expressions is None and body is None:
+            raise ValueError(
+                "Empty value passed for parameters 'expressions' and 'body', one of them should be set."
+            )
+        elif expressions is not None and body is not None:
+            raise ValueError("Cannot set both 'expressions' and 'body'")
+        __path_parts: t.Dict[str, str] = {"name": _quote(name)}
+        __path = f'/_project_routing/{__path_parts["name"]}'
+        __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 pretty is not None:
+            __query["pretty"] = pretty
+        __body = expressions if expressions is not None else body
+        __headers = {"accept": "application/json", "content-type": "application/json"}
+        return self.perform_request(  # type: ignore[return-value]
+            "PUT",
+            __path,
+            params=__query,
+            headers=__headers,
+            body=__body,
+            endpoint_id="project_routing.create",
+            path_parts=__path_parts,
+        )
+
+    @_rewrite_parameters(
+        body_name="expressions",
+    )
+    @_availability_warning(Stability.EXPERIMENTAL)
+    def create_many(
+        self,
+        *,
+        expressions: t.Optional[t.Mapping[str, t.Mapping[str, t.Any]]] = None,
+        body: t.Optional[t.Mapping[str, t.Mapping[str, t.Any]]] = 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>Create of update named project routing expressions.</p>
+          <p>Create or update named project routing expressions.</p>
+
+
+        :param expressions:
+        """
+        if expressions is None and body is None:
+            raise ValueError(
+                "Empty value passed for parameters 'expressions' and 'body', one of them should be set."
+            )
+        elif expressions is not None and body is not None:
+            raise ValueError("Cannot set both 'expressions' and 'body'")
+        __path_parts: t.Dict[str, str] = {}
+        __path = "/_project_routing"
+        __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 pretty is not None:
+            __query["pretty"] = pretty
+        __body = expressions if expressions is not None else body
+        __headers = {"accept": "application/json", "content-type": "application/json"}
+        return self.perform_request(  # type: ignore[return-value]
+            "PUT",
+            __path,
+            params=__query,
+            headers=__headers,
+            body=__body,
+            endpoint_id="project_routing.create_many",
+            path_parts=__path_parts,
+        )
+
+    @_rewrite_parameters()
+    @_availability_warning(Stability.EXPERIMENTAL)
+    def delete(
+        self,
+        *,
+        name: str,
+        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>Delete named project routing expressions.</p>
+          <p>Delete named project routing expressions.</p>
+
+
+        :param name: The name of project routing expression
+        """
+        if name in SKIP_IN_PATH:
+            raise ValueError("Empty value passed for parameter 'name'")
+        __path_parts: t.Dict[str, str] = {"name": _quote(name)}
+        __path = f'/_project_routing/{__path_parts["name"]}'
+        __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 pretty is not None:
+            __query["pretty"] = pretty
+        __headers = {"accept": "application/json"}
+        return self.perform_request(  # type: ignore[return-value]
+            "DELETE",
+            __path,
+            params=__query,
+            headers=__headers,
+            endpoint_id="project_routing.delete",
+            path_parts=__path_parts,
+        )
+
+    @_rewrite_parameters()
+    @_availability_warning(Stability.EXPERIMENTAL)
+    def get(
+        self,
+        *,
+        name: str,
+        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 named project routing expressions.</p>
+          <p>Get named project routing expressions.</p>
+
+
+        :param name: The name of project routing expression
+        """
+        if name in SKIP_IN_PATH:
+            raise ValueError("Empty value passed for parameter 'name'")
+        __path_parts: t.Dict[str, str] = {"name": _quote(name)}
+        __path = f'/_project_routing/{__path_parts["name"]}'
+        __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 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="project_routing.get",
+            path_parts=__path_parts,
+        )
+
+    @_rewrite_parameters()
+    @_availability_warning(Stability.EXPERIMENTAL)
+    def get_many(
+        self,
+        *,
+        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 named project routing expressions.</p>
+          <p>Get named project routing expressions.</p>
+
+        """
+        __path_parts: t.Dict[str, str] = {}
+        __path = "/_project_routing"
+        __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 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="project_routing.get_many",
+            path_parts=__path_parts,
+        )

elasticsearch/_sync/client/security.py

@@ -477,7 +477,7 @@ class SecurityClient(NamespacedClient):
     def clear_cached_privileges(
         self,
         *,
-        application: str,
+        application: t.Union[str, t.Sequence[str]],
         error_trace: t.Optional[bool] = None,
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
@@ -775,13 +775,20 @@ class SecurityClient(NamespacedClient):
         )
 
     @_rewrite_parameters(
-        body_fields=("access", "name", "expiration", "metadata"),
+        body_fields=(
+            "access",
+            "name",
+            "certificate_identity",
+            "expiration",
+            "metadata",
+        ),
     )
     def create_cross_cluster_api_key(
         self,
         *,
         access: t.Optional[t.Mapping[str, t.Any]] = None,
         name: t.Optional[str] = None,
+        certificate_identity: t.Optional[str] = None,
         error_trace: t.Optional[bool] = None,
         expiration: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
@@ -814,6 +821,10 @@ class SecurityClient(NamespacedClient):
             automatically converts the access specification to a role descriptor which
             has relevant privileges assigned accordingly.
         :param name: Specifies the name for this API key.
+        :param certificate_identity: The certificate identity to associate with this
+            API key. This field is used to restrict the API key to connections authenticated
+            by a specific TLS certificate. The value should match the certificate's distinguished
+            name (DN) pattern.
         :param expiration: Expiration time for the API key. By default, API keys never
             expire.
         :param metadata: Arbitrary metadata that you want to associate with the API key.
@@ -841,6 +852,8 @@ class SecurityClient(NamespacedClient):
                 __body["access"] = access
             if name is not None:
                 __body["name"] = name
+            if certificate_identity is not None:
+                __body["certificate_identity"] = certificate_identity
             if expiration is not None:
                 __body["expiration"] = expiration
             if metadata is not None:
@@ -4474,13 +4487,14 @@ class SecurityClient(NamespacedClient):
         )
 
     @_rewrite_parameters(
-        body_fields=("access", "expiration", "metadata"),
+        body_fields=("access", "certificate_identity", "expiration", "metadata"),
     )
     def update_cross_cluster_api_key(
         self,
         *,
         id: str,
         access: t.Optional[t.Mapping[str, t.Any]] = None,
+        certificate_identity: t.Optional[str] = None,
         error_trace: t.Optional[bool] = None,
         expiration: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
@@ -4513,6 +4527,13 @@ class SecurityClient(NamespacedClient):
             of permissions for cross cluster search and cross cluster replication. At
             least one of them must be specified. When specified, the new access assignment
             fully replaces the previously assigned access.
+        :param certificate_identity: The certificate identity to associate with this
+            API key. This field is used to restrict the API key to connections authenticated
+            by a specific TLS certificate. The value should match the certificate's distinguished
+            name (DN) pattern. When specified, this fully replaces any previously assigned
+            certificate identity. To clear an existing certificate identity, explicitly
+            set this field to `null`. When omitted, the existing certificate identity
+            remains unchanged.
         :param expiration: The expiration time for the API key. By default, API keys
             never expire. This property can be omitted to leave the value unchanged.
         :param metadata: Arbitrary metadata that you want to associate with the API key.
@@ -4539,6 +4560,8 @@ class SecurityClient(NamespacedClient):
         if not __body:
             if access is not None:
                 __body["access"] = access
+            if certificate_identity is not None:
+                __body["certificate_identity"] = certificate_identity
             if expiration is not None:
                 __body["expiration"] = expiration
             if metadata is not None:

elasticsearch/_sync/client/snapshot.py

@@ -397,7 +397,7 @@ class SnapshotClient(NamespacedClient):
         self,
         *,
         repository: str,
-        snapshot: str,
+        snapshot: t.Union[str, t.Sequence[str]],
         error_trace: t.Optional[bool] = None,
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,

elasticsearch/_sync/client/sql.py

@@ -253,6 +253,7 @@ class SqlClient(NamespacedClient):
             "keep_on_completion",
             "page_timeout",
             "params",
+            "project_routing",
             "query",
             "request_timeout",
             "runtime_mappings",
@@ -333,10 +334,10 @@ class SqlClient(NamespacedClient):
             is no longer available. Subsequent scroll requests prolong the lifetime of
             the scroll cursor by the duration of `page_timeout` in the scroll request.
         :param params: The values for parameters in the query.
-        :param project_routing: Specifies a subset of projects to target for the search
-            using project metadata tags in a subset of Lucene query syntax. Allowed Lucene
-            queries: the _alias tag and a single value (possibly wildcarded). Examples:
-            _alias:my-project _alias:_origin _alias:*pr* Supported in serverless only.
+        :param project_routing: Specifies a subset of projects to target using project
+            metadata tags in a subset of Lucene query syntax. Allowed Lucene queries:
+            the _alias tag and a single value (possibly wildcarded). Examples: _alias:my-project
+            _alias:_origin _alias:*pr* Supported in serverless only.
         :param query: The SQL query to run.
         :param request_timeout: The timeout before the request fails.
         :param runtime_mappings: One or more runtime fields for the search request. These
@@ -362,8 +363,6 @@ class SqlClient(NamespacedClient):
             __query["human"] = human
         if pretty is not None:
             __query["pretty"] = pretty
-        if project_routing is not None:
-            __query["project_routing"] = project_routing
         if not __body:
             if allow_partial_search_results is not None:
                 __body["allow_partial_search_results"] = allow_partial_search_results
@@ -389,6 +388,8 @@ class SqlClient(NamespacedClient):
                 __body["page_timeout"] = page_timeout
             if params is not None:
                 __body["params"] = params
+            if project_routing is not None:
+                __body["project_routing"] = project_routing
             if query is not None:
                 __body["query"] = query
             if request_timeout is not None:

elasticsearch/_sync/client/streams.py

@@ -15,7 +15,6 @@
 #  specific language governing permissions and limitations
 #  under the License.
 
-
 import typing as t
 
 from elastic_transport import ObjectApiResponse, TextApiResponse

elasticsearch/_sync/client/text_structure.py

@@ -31,7 +31,7 @@ class TextStructureClient(NamespacedClient):
         *,
         field: str,
         index: str,
-        column_names: t.Optional[str] = None,
+        column_names: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         delimiter: t.Optional[str] = None,
         documents_to_sample: t.Optional[int] = None,
         ecs_compatibility: t.Optional[t.Union[str, t.Literal["disabled", "v1"]]] = None,
@@ -217,7 +217,7 @@ class TextStructureClient(NamespacedClient):
         self,
         *,
         messages: t.Optional[t.Sequence[str]] = None,
-        column_names: t.Optional[str] = None,
+        column_names: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         delimiter: t.Optional[str] = None,
         ecs_compatibility: t.Optional[t.Union[str, t.Literal["disabled", "v1"]]] = None,
         error_trace: t.Optional[bool] = None,
@@ -398,7 +398,7 @@ class TextStructureClient(NamespacedClient):
         text_files: t.Optional[t.Sequence[t.Any]] = None,
         body: t.Optional[t.Sequence[t.Any]] = None,
         charset: t.Optional[str] = None,
-        column_names: t.Optional[str] = None,
+        column_names: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         delimiter: t.Optional[str] = None,
         ecs_compatibility: t.Optional[str] = None,
         explain: t.Optional[bool] = None,

elasticsearch/_version.py

@@ -15,5 +15,5 @@
 #  specific language governing permissions and limitations
 #  under the License.
 
-__versionstr__ = "9.2.1"
-__es_specification_commit__ = "4ab58cf013706c9104d18daafae4361cf7351a55"
+__versionstr__ = "9.3.0"
+__es_specification_commit__ = "f051200486a5a1d415cc04f07f6bd150395d7661"

elasticsearch/dsl/__init__.py

@@ -53,6 +53,7 @@ from .field import (
     DenseVector,
     Double,
     DoubleRange,
+    ExponentialHistogram,
     Field,
     Flattened,
     Float,
@@ -73,6 +74,7 @@ from .field import (
     MatchOnlyText,
     Murmur3,
     Nested,
+    NumpyDenseVector,
     Object,
     Passthrough,
     Percolator,
@@ -156,6 +158,7 @@ __all__ = [
     "E",
     "ElasticsearchDslException",
     "EmptySearch",
+    "ExponentialHistogram",
     "Facet",
     "FacetedResponse",
     "FacetedSearch",
@@ -189,6 +192,7 @@ __all__ = [
     "Murmur3",
     "Nested",
     "NestedFacet",
+    "NumpyDenseVector",
     "Object",
     "Passthrough",
     "Percolator",

elasticsearch/dsl/aggs.py

@@ -1516,9 +1516,9 @@ class GeoLine(Agg[_R]):
     ordered by the chosen sort field.
 
     :arg point: (required) The name of the geo_point field.
-    :arg sort: (required) The name of the numeric field to use as the sort
-        key for ordering the points. When the `geo_line` aggregation is
-        nested inside a `time_series` aggregation, this field defaults to
+    :arg sort: The name of the numeric field to use as the sort key for
+        ordering the points. When the `geo_line` aggregation is nested
+        inside a `time_series` aggregation, this field defaults to
         `@timestamp`, and any other value will result in error.
     :arg include_sort: When `true`, returns an additional array of the
         sort values in the feature properties.
@@ -1855,9 +1855,9 @@ class Inference(Pipeline[_R]):
 class Line(Agg[_R]):
     """
     :arg point: (required) The name of the geo_point field.
-    :arg sort: (required) The name of the numeric field to use as the sort
-        key for ordering the points. When the `geo_line` aggregation is
-        nested inside a `time_series` aggregation, this field defaults to
+    :arg sort: The name of the numeric field to use as the sort key for
+        ordering the points. When the `geo_line` aggregation is nested
+        inside a `time_series` aggregation, this field defaults to
         `@timestamp`, and any other value will result in error.
     :arg include_sort: When `true`, returns an additional array of the
         sort values in the feature properties.