Run code generation (#66)

Author: pquentin

elasticsearch_serverless/_async/client/__init__.py

@@ -466,7 +466,8 @@ async def bulk(
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Allows to perform multiple index/update/delete operations in a single request.
+        Performs multiple indexing or delete operations in a single API call. This reduces
+        overhead and can greatly increase indexing speed.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-bulk.html>`_
 
@@ -556,7 +557,7 @@ async def clear_scroll(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Explicitly clears the search context for a scroll.
+        Clears the search context and results for a scrolling search.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/clear-scroll-api.html>`_
 
@@ -599,7 +600,7 @@ async def close_point_in_time(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Close a point in time
+        Closes a point-in-time.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/point-in-time-api.html>`_
 
@@ -790,8 +791,9 @@ async def create(
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates a new document in the index. Returns a 409 response when a document with
-        a same ID already exists in the index.
+        Adds a JSON document to the specified data stream or index and makes it searchable.
+        If the target is an index and the document already exists, the request updates
+        the document and increments its version.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-index_.html>`_
 
@@ -888,7 +890,7 @@ async def delete(
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Removes a document from the index.
+        Removes a JSON document from the specified index.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-delete.html>`_
 
@@ -1006,7 +1008,7 @@ async def delete_by_query(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes documents matching the provided query.
+        Deletes documents that match the specified query.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-delete-by-query.html>`_
 
@@ -1180,7 +1182,7 @@ async def delete_script(
         timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes a script.
+        Deletes a stored script or search template.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html>`_
 
@@ -1242,7 +1244,7 @@ async def exists(
         ] = None,
     ) -> HeadApiResponse:
         """
-        Returns information about whether a document exists in an index.
+        Checks if a document in an index exists.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-get.html>`_
 
@@ -1337,7 +1339,7 @@ async def exists_source(
         ] = None,
     ) -> HeadApiResponse:
         """
-        Returns information about whether a document source exists in an index.
+        Checks if a document's `_source` is stored.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-get.html>`_
 
@@ -1431,7 +1433,8 @@ async def explain(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Returns information about why a specific matches (or doesn't match) a query.
+        Returns information about why a specific document matches (or doesn’t match)
+        a query.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/search-explain.html>`_
 
@@ -1543,7 +1546,10 @@ async def field_caps(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Returns the information about the capabilities of fields among multiple indices.
+        The field capabilities API returns the information about the capabilities of
+        fields among multiple indices. The field capabilities API returns runtime fields
+        like any other field. For example, a runtime field with a type of keyword is
+        returned as any other field that belongs to the `keyword` family.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/search-field-caps.html>`_
 
@@ -1735,7 +1741,7 @@ async def get_script(
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Returns a script.
+        Retrieves a stored script or search template.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html>`_
 
@@ -1887,7 +1893,9 @@ async def index(
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates or updates a document in an index.
+        Adds a JSON document to the specified data stream or index and makes it searchable.
+        If the target is an index and the document already exists, the request updates
+        the document and increments its version.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-index_.html>`_
 
@@ -2261,7 +2269,7 @@ async def msearch_template(
         typed_keys: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Allows to execute several search template operations in one request.
+        Runs multiple templated searches with a single request.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/search-multi-search.html>`_
 
@@ -2445,7 +2453,13 @@ async def open_point_in_time(
         routing: t.Optional[str] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Open a point in time that can be used in subsequent searches
+        A search request by default executes against the most recent visible data of
+        the target indices, which is called point in time. Elasticsearch pit (point in
+        time) is a lightweight view into the state of the data as it existed when initiated.
+        In some cases, it’s preferred to perform multiple search requests using the same
+        point in time. For example, if refreshes happen between `search_after` requests,
+        then the results of those requests might not be consistent as changes happening
+        between searches are only visible to the more recent point in time.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/point-in-time-api.html>`_
 
@@ -2511,7 +2525,7 @@ async def put_script(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates or updates a script.
+        Creates or updates a stored script or search template.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/modules-scripting.html>`_
 
@@ -2587,8 +2601,8 @@ async def rank_eval(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Allows to evaluate the quality of ranked search results over a set of typical
-        search queries
+        Enables you to evaluate the quality of ranked search results over a set of typical
+        search queries.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/search-rank-eval.html>`_
 
@@ -2770,7 +2784,7 @@ async def render_search_template(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Allows to use the Mustache language to pre-render a search definition.
+        Renders a search template as a search request body.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/render-search-template-api.html>`_
 
@@ -2829,7 +2843,7 @@ async def scripts_painless_execute(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Allows an arbitrary script to be executed and a result to be returned
+        Runs a script and returns a result.
 
         `<https://www.elastic.co/guide/en/elasticsearch/painless/master/painless-execute-api.html>`_
 
@@ -2939,6 +2953,7 @@ async def scroll(
             "query",
             "rank",
             "rescore",
+            "retriever",
             "runtime_mappings",
             "script_fields",
             "search_after",
@@ -3020,6 +3035,7 @@ async def search(
             t.Union[t.Mapping[str, t.Any], t.Sequence[t.Mapping[str, t.Any]]]
         ] = None,
         rest_total_hits_as_int: t.Optional[bool] = None,
+        retriever: t.Optional[t.Mapping[str, t.Any]] = None,
         routing: t.Optional[str] = None,
         runtime_mappings: t.Optional[t.Mapping[str, t.Mapping[str, t.Any]]] = None,
         script_fields: t.Optional[t.Mapping[str, t.Mapping[str, t.Any]]] = None,
@@ -3060,7 +3076,9 @@ async def search(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Returns results matching a query.
+        Returns search hits that match the query defined in the request. You can provide
+        search queries using the `q` query string parameter or the request body. If both
+        are specified, only the query parameter is used.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/search-search.html>`_
 
@@ -3179,6 +3197,9 @@ async def search(
             example 100 - 500) documents returned by the `query` and `post_filter` phases.
         :param rest_total_hits_as_int: Indicates whether `hits.total` should be rendered
             as an integer or an object in the rest search response.
+        :param retriever: A retriever is a specification to describe top documents returned
+            from a search. A retriever replaces other elements of the search API that
+            also return top documents such as query and knn.
         :param routing: Custom value used to route operations to a specific shard.
         :param runtime_mappings: Defines one or more runtime fields in the search request.
             These fields take precedence over mapped fields with the same name.
@@ -3372,6 +3393,8 @@ async def search(
                 __body["rank"] = rank
             if rescore is not None:
                 __body["rescore"] = rescore
+            if retriever is not None:
+                __body["retriever"] = retriever
             if runtime_mappings is not None:
                 __body["runtime_mappings"] = runtime_mappings
             if script_fields is not None:
@@ -3625,7 +3648,7 @@ async def search_template(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Allows to use the Mustache language to pre-render a search definition.
+        Runs a search with a search template.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/search-template.html>`_
 
@@ -4134,8 +4157,8 @@ async def update_by_query(
     ) -> ObjectApiResponse[t.Any]:
         """
         Updates documents that match the specified query. If no query is specified, performs
-        an update on every document in the index without changing the source, for example
-        to pick up a mapping change.
+        an update on every document in the data stream or index without modifying the
+        source, which is useful for picking up mapping changes.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/docs-update-by-query.html>`_
 

elasticsearch_serverless/_async/client/async_search.py

@@ -36,8 +36,11 @@ async def delete(
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes an async search by ID. If the search is still running, the search request
-        will be cancelled. Otherwise, the saved search results are deleted.
+        Deletes an async search by identifier. If the search is still running, the search
+        request will be cancelled. Otherwise, the saved search results are deleted. If
+        the Elasticsearch security features are enabled, the deletion of a specific async
+        search is restricted to: the authenticated user that submitted the original search
+        request; users that have the `cancel_task` cluster privilege.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/async-search.html>`_
 
@@ -77,7 +80,9 @@ async def get(
     ) -> ObjectApiResponse[t.Any]:
         """
         Retrieves the results of a previously submitted async search request given its
-        ID.
+        identifier. If the Elasticsearch security features are enabled, access to the
+        results of a specific async search is restricted to the user or API key that
+        submitted it.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/async-search.html>`_
 
@@ -131,8 +136,10 @@ async def status(
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves the status of a previously submitted async search request given its
-        ID.
+        Get async search status Retrieves the status of a previously submitted async
+        search request given its identifier, without retrieving search results. If the
+        Elasticsearch security features are enabled, use of this API is restricted to
+        the `monitoring_user` role.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/async-search.html>`_
 
@@ -298,7 +305,15 @@ async def submit(
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Executes a search request asynchronously.
+        Runs a search request asynchronously. When the primary sort of the results is
+        an indexed field, shards get sorted based on minimum and maximum value that they
+        hold for that field, hence partial results become available following the sort
+        criteria that was requested. Warning: Async search does not support scroll nor
+        search requests that only include the suggest section. By default, Elasticsearch
+        doesn’t allow you to store an async search response larger than 10Mb and an attempt
+        to do this results in an error. The maximum allowed size for a stored async search
+        response can be set by changing the `search.max_async_search_response_size` cluster
+        level setting.
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/master/async-search.html>`_