elasticsearch 8.17.0__py3-none-any.whl → 8.17.2__py3-none-any.whl

elasticsearch/_async/client/dangling_indices.py

@@ -39,12 +39,14 @@ class DanglingIndicesClient(NamespacedClient):
         timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Delete a dangling index. If Elasticsearch encounters index data that is absent
-        from the current cluster state, those indices are considered to be dangling.
-        For example, this can happen if you delete more than `cluster.indices.tombstones.size`
-        indices while an Elasticsearch node is offline.
+        .. raw:: html
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/modules-gateway-dangling-indices.html>`_
+          <p>Delete a dangling index.
+          If Elasticsearch encounters index data that is absent from the current cluster state, those indices are considered to be dangling.
+          For example, this can happen if you delete more than <code>cluster.indices.tombstones.size</code> indices while an Elasticsearch node is offline.</p>
+
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/dangling-index-delete.html>`_
 
         :param index_uuid: The UUID of the index to delete. Use the get dangling indices
             API to find the UUID.
@@ -98,12 +100,14 @@ class DanglingIndicesClient(NamespacedClient):
         timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Import a dangling index. If Elasticsearch encounters index data that is absent
-        from the current cluster state, those indices are considered to be dangling.
-        For example, this can happen if you delete more than `cluster.indices.tombstones.size`
-        indices while an Elasticsearch node is offline.
+        .. raw:: html
+
+          <p>Import a dangling index.</p>
+          <p>If Elasticsearch encounters index data that is absent from the current cluster state, those indices are considered to be dangling.
+          For example, this can happen if you delete more than <code>cluster.indices.tombstones.size</code> indices while an Elasticsearch node is offline.</p>
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/modules-gateway-dangling-indices.html>`_
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/dangling-index-import.html>`_
 
         :param index_uuid: The UUID of the index to import. Use the get dangling indices
             API to locate the UUID.
@@ -156,13 +160,15 @@ class DanglingIndicesClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Get the dangling indices. If Elasticsearch encounters index data that is absent
-        from the current cluster state, those indices are considered to be dangling.
-        For example, this can happen if you delete more than `cluster.indices.tombstones.size`
-        indices while an Elasticsearch node is offline. Use this API to list dangling
-        indices, which you can then import or delete.
+        .. raw:: html
+
+          <p>Get the dangling indices.</p>
+          <p>If Elasticsearch encounters index data that is absent from the current cluster state, those indices are considered to be dangling.
+          For example, this can happen if you delete more than <code>cluster.indices.tombstones.size</code> indices while an Elasticsearch node is offline.</p>
+          <p>Use this API to list dangling indices, which you can then import or delete.</p>
+
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/modules-gateway-dangling-indices.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/dangling-indices-list.html>`_
         """
         __path_parts: t.Dict[str, str] = {}
         __path = "/_dangling"

elasticsearch/_async/client/enrich.py

@@ -36,7 +36,11 @@ class EnrichClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Delete an enrich policy. Deletes an existing enrich policy and its enrich index.
+        .. raw:: html
+
+          <p>Delete an enrich policy.
+          Deletes an existing enrich policy and its enrich index.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/delete-enrich-policy-api.html>`_
 
@@ -77,7 +81,11 @@ class EnrichClient(NamespacedClient):
         wait_for_completion: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Run an enrich policy. Create the enrich index for an existing enrich policy.
+        .. raw:: html
+
+          <p>Run an enrich policy.
+          Create the enrich index for an existing enrich policy.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/execute-enrich-policy-api.html>`_
 
@@ -121,7 +129,11 @@ class EnrichClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Get an enrich policy. Returns information about an enrich policy.
+        .. raw:: html
+
+          <p>Get an enrich policy.
+          Returns information about an enrich policy.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-enrich-policy-api.html>`_
 
@@ -171,7 +183,11 @@ class EnrichClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Create an enrich policy. Creates an enrich policy.
+        .. raw:: html
+
+          <p>Create an enrich policy.
+          Creates an enrich policy.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/put-enrich-policy-api.html>`_
 
@@ -224,8 +240,11 @@ class EnrichClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Get enrich stats. Returns enrich coordinator statistics and information about
-        enrich policies that are currently executing.
+        .. raw:: html
+
+          <p>Get enrich stats.
+          Returns enrich coordinator statistics and information about enrich policies that are currently executing.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/enrich-stats-api.html>`_
         """

elasticsearch/_async/client/eql.py

@@ -36,8 +36,12 @@ class EqlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Delete an async EQL search. Delete an async EQL search or a stored synchronous
-        EQL search. The API also deletes results for the search.
+        .. raw:: html
+
+          <p>Delete an async EQL search.
+          Delete an async EQL search or a stored synchronous EQL search.
+          The API also deletes results for the search.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/eql-search-api.html>`_
 
@@ -83,8 +87,11 @@ class EqlClient(NamespacedClient):
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Get async EQL search results. Get the current status and available results for
-        an async EQL search or a stored synchronous EQL search.
+        .. raw:: html
+
+          <p>Get async EQL search results.
+          Get the current status and available results for an async EQL search or a stored synchronous EQL search.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-async-eql-search-api.html>`_
 
@@ -134,8 +141,11 @@ class EqlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Get the async EQL status. Get the current status for an async EQL search or a
-        stored synchronous EQL search without returning results.
+        .. raw:: html
+
+          <p>Get the async EQL status.
+          Get the current status for an async EQL search or a stored synchronous EQL search without returning results.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-async-eql-status-api.html>`_
 
@@ -223,9 +233,12 @@ class EqlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Get EQL search results. Returns search results for an Event Query Language (EQL)
-        query. EQL assumes each document in a data stream or index corresponds to an
-        event.
+        .. raw:: html
+
+          <p>Get EQL search results.
+          Returns search results for an Event Query Language (EQL) query.
+          EQL assumes each document in a data stream or index corresponds to an event.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/eql-search-api.html>`_
 

elasticsearch/_async/client/esql.py

@@ -20,7 +20,7 @@ import typing as t
 from elastic_transport import ObjectApiResponse
 
 from ._base import NamespacedClient
-from .utils import _rewrite_parameters
+from .utils import SKIP_IN_PATH, _quote, _rewrite_parameters
 
 
 class EsqlClient(NamespacedClient):
@@ -30,6 +30,288 @@ class EsqlClient(NamespacedClient):
             "query",
             "columnar",
             "filter",
+            "include_ccs_metadata",
+            "locale",
+            "params",
+            "profile",
+            "tables",
+        ),
+        ignore_deprecated_options={"params"},
+    )
+    async def async_query(
+        self,
+        *,
+        query: t.Optional[str] = None,
+        columnar: t.Optional[bool] = None,
+        delimiter: t.Optional[str] = None,
+        drop_null_columns: t.Optional[bool] = None,
+        error_trace: t.Optional[bool] = None,
+        filter: t.Optional[t.Mapping[str, t.Any]] = None,
+        filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
+        format: t.Optional[
+            t.Union[
+                str,
+                t.Literal[
+                    "arrow", "cbor", "csv", "json", "smile", "tsv", "txt", "yaml"
+                ],
+            ]
+        ] = None,
+        human: t.Optional[bool] = None,
+        include_ccs_metadata: t.Optional[bool] = None,
+        keep_alive: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
+        keep_on_completion: t.Optional[bool] = None,
+        locale: t.Optional[str] = None,
+        params: t.Optional[
+            t.Sequence[t.Union[None, bool, float, int, str, t.Any]]
+        ] = None,
+        pretty: t.Optional[bool] = None,
+        profile: t.Optional[bool] = None,
+        tables: t.Optional[
+            t.Mapping[str, t.Mapping[str, t.Mapping[str, t.Any]]]
+        ] = None,
+        wait_for_completion_timeout: t.Optional[
+            t.Union[str, t.Literal[-1], t.Literal[0]]
+        ] = None,
+        body: t.Optional[t.Dict[str, t.Any]] = None,
+    ) -> ObjectApiResponse[t.Any]:
+        """
+        .. raw:: html
+
+          <p>Run an async ES|QL query.
+          Asynchronously run an ES|QL (Elasticsearch query language) query, monitor its progress, and retrieve results when they become available.</p>
+          <p>The API accepts the same parameters and request body as the synchronous query API, along with additional async related properties.</p>
+
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/esql-async-query-api.html>`_
+
+        :param query: The ES|QL query API accepts an ES|QL query string in the query
+            parameter, runs it, and returns the results.
+        :param columnar: By default, ES|QL returns results as rows. For example, FROM
+            returns each individual document as one row. For the JSON, YAML, CBOR and
+            smile formats, ES|QL can return the results in a columnar fashion where one
+            row represents all the values of a certain column in the results.
+        :param delimiter: The character to use between values within a CSV row. It is
+            valid only for the CSV format.
+        :param drop_null_columns: Indicates whether columns that are entirely `null`
+            will be removed from the `columns` and `values` portion of the results. If
+            `true`, the response will include an extra section under the name `all_columns`
+            which has the name of all the columns.
+        :param filter: Specify a Query DSL query in the filter parameter to filter the
+            set of documents that an ES|QL query runs on.
+        :param format: A short version of the Accept header, for example `json` or `yaml`.
+        :param include_ccs_metadata: When set to `true` and performing a cross-cluster
+            query, the response will include an extra `_clusters` object with information
+            about the clusters that participated in the search along with info such as
+            shards count.
+        :param keep_alive: The period for which the query and its results are stored
+            in the cluster. The default period is five days. When this period expires,
+            the query and its results are deleted, even if the query is still ongoing.
+            If the `keep_on_completion` parameter is false, Elasticsearch only stores
+            async queries that do not complete within the period set by the `wait_for_completion_timeout`
+            parameter, regardless of this value.
+        :param keep_on_completion: Indicates whether the query and its results are stored
+            in the cluster. If false, the query and its results are stored in the cluster
+            only if the request does not complete during the period set by the `wait_for_completion_timeout`
+            parameter.
+        :param locale:
+        :param params: To avoid any attempts of hacking or code injection, extract the
+            values in a separate list of parameters. Use question mark placeholders (?)
+            in the query string for each of the parameters.
+        :param profile: If provided and `true` the response will include an extra `profile`
+            object with information on how the query was executed. This information is
+            for human debugging and its format can change at any time but it can give
+            some insight into the performance of each part of the query.
+        :param tables: Tables to use with the LOOKUP operation. The top level key is
+            the table name and the next level key is the column name.
+        :param wait_for_completion_timeout: The period to wait for the request to finish.
+            By default, the request waits for 1 second for the query results. If the
+            query completes during this period, results are returned Otherwise, a query
+            ID is returned that can later be used to retrieve the results.
+        """
+        if query is None and body is None:
+            raise ValueError("Empty value passed for parameter 'query'")
+        __path_parts: t.Dict[str, str] = {}
+        __path = "/_query/async"
+        __query: t.Dict[str, t.Any] = {}
+        __body: t.Dict[str, t.Any] = body if body is not None else {}
+        if delimiter is not None:
+            __query["delimiter"] = delimiter
+        if drop_null_columns is not None:
+            __query["drop_null_columns"] = drop_null_columns
+        if error_trace is not None:
+            __query["error_trace"] = error_trace
+        if filter_path is not None:
+            __query["filter_path"] = filter_path
+        if format is not None:
+            __query["format"] = format
+        if human is not None:
+            __query["human"] = human
+        if keep_alive is not None:
+            __query["keep_alive"] = keep_alive
+        if keep_on_completion is not None:
+            __query["keep_on_completion"] = keep_on_completion
+        if pretty is not None:
+            __query["pretty"] = pretty
+        if wait_for_completion_timeout is not None:
+            __query["wait_for_completion_timeout"] = wait_for_completion_timeout
+        if not __body:
+            if query is not None:
+                __body["query"] = query
+            if columnar is not None:
+                __body["columnar"] = columnar
+            if filter is not None:
+                __body["filter"] = filter
+            if include_ccs_metadata is not None:
+                __body["include_ccs_metadata"] = include_ccs_metadata
+            if locale is not None:
+                __body["locale"] = locale
+            if params is not None:
+                __body["params"] = params
+            if profile is not None:
+                __body["profile"] = profile
+            if tables is not None:
+                __body["tables"] = tables
+        __headers = {"accept": "application/json", "content-type": "application/json"}
+        return await self.perform_request(  # type: ignore[return-value]
+            "POST",
+            __path,
+            params=__query,
+            headers=__headers,
+            body=__body,
+            endpoint_id="esql.async_query",
+            path_parts=__path_parts,
+        )
+
+    @_rewrite_parameters()
+    async def async_query_delete(
+        self,
+        *,
+        id: 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 an async ES|QL query.
+          If the query is still running, it is cancelled.
+          Otherwise, the stored results are deleted.</p>
+          <p>If the Elasticsearch security features are enabled, only the following users can use this API to delete a query:</p>
+          <ul>
+          <li>The authenticated user that submitted the original query request</li>
+          <li>Users with the <code>cancel_task</code> cluster privilege</li>
+          </ul>
+
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/esql-async-query-delete-api.html>`_
+
+        :param id: The unique identifier of the query. A query ID is provided in the
+            ES|QL async query API response for a query that does not complete in the
+            designated time. A query ID is also provided when the request was submitted
+            with the `keep_on_completion` parameter set to `true`.
+        """
+        if id in SKIP_IN_PATH:
+            raise ValueError("Empty value passed for parameter 'id'")
+        __path_parts: t.Dict[str, str] = {"id": _quote(id)}
+        __path = f'/_query/async/{__path_parts["id"]}'
+        __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 await self.perform_request(  # type: ignore[return-value]
+            "DELETE",
+            __path,
+            params=__query,
+            headers=__headers,
+            endpoint_id="esql.async_query_delete",
+            path_parts=__path_parts,
+        )
+
+    @_rewrite_parameters()
+    async def async_query_get(
+        self,
+        *,
+        id: str,
+        drop_null_columns: t.Optional[bool] = None,
+        error_trace: t.Optional[bool] = None,
+        filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
+        human: t.Optional[bool] = None,
+        keep_alive: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
+        pretty: t.Optional[bool] = None,
+        wait_for_completion_timeout: t.Optional[
+            t.Union[str, t.Literal[-1], t.Literal[0]]
+        ] = None,
+    ) -> ObjectApiResponse[t.Any]:
+        """
+        .. raw:: html
+
+          <p>Get async ES|QL query results.
+          Get the current status and available results or stored results for an ES|QL asynchronous query.
+          If the Elasticsearch security features are enabled, only the user who first submitted the ES|QL query can retrieve the results using this API.</p>
+
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/esql-async-query-get-api.html>`_
+
+        :param id: The unique identifier of the query. A query ID is provided in the
+            ES|QL async query API response for a query that does not complete in the
+            designated time. A query ID is also provided when the request was submitted
+            with the `keep_on_completion` parameter set to `true`.
+        :param drop_null_columns: Indicates whether columns that are entirely `null`
+            will be removed from the `columns` and `values` portion of the results. If
+            `true`, the response will include an extra section under the name `all_columns`
+            which has the name of all the columns.
+        :param keep_alive: The period for which the query and its results are stored
+            in the cluster. When this period expires, the query and its results are deleted,
+            even if the query is still ongoing.
+        :param wait_for_completion_timeout: The period to wait for the request to finish.
+            By default, the request waits for complete query results. If the request
+            completes during the period specified in this parameter, complete query results
+            are returned. Otherwise, the response returns an `is_running` value of `true`
+            and no results.
+        """
+        if id in SKIP_IN_PATH:
+            raise ValueError("Empty value passed for parameter 'id'")
+        __path_parts: t.Dict[str, str] = {"id": _quote(id)}
+        __path = f'/_query/async/{__path_parts["id"]}'
+        __query: t.Dict[str, t.Any] = {}
+        if drop_null_columns is not None:
+            __query["drop_null_columns"] = drop_null_columns
+        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 keep_alive is not None:
+            __query["keep_alive"] = keep_alive
+        if pretty is not None:
+            __query["pretty"] = pretty
+        if wait_for_completion_timeout is not None:
+            __query["wait_for_completion_timeout"] = wait_for_completion_timeout
+        __headers = {"accept": "application/json"}
+        return await self.perform_request(  # type: ignore[return-value]
+            "GET",
+            __path,
+            params=__query,
+            headers=__headers,
+            endpoint_id="esql.async_query_get",
+            path_parts=__path_parts,
+        )
+
+    @_rewrite_parameters(
+        body_fields=(
+            "query",
+            "columnar",
+            "filter",
+            "include_ccs_metadata",
             "locale",
             "params",
             "profile",
@@ -56,6 +338,7 @@ class EsqlClient(NamespacedClient):
             ]
         ] = None,
         human: t.Optional[bool] = None,
+        include_ccs_metadata: t.Optional[bool] = None,
         locale: t.Optional[str] = None,
         params: t.Optional[
             t.Sequence[t.Union[None, bool, float, int, str, t.Any]]
@@ -68,8 +351,11 @@ class EsqlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Run an ES|QL query. Get search results for an ES|QL (Elasticsearch query language)
-        query.
+        .. raw:: html
+
+          <p>Run an ES|QL query.
+          Get search results for an ES|QL (Elasticsearch query language) query.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/esql-rest.html>`_
 
@@ -88,6 +374,10 @@ class EsqlClient(NamespacedClient):
         :param filter: Specify a Query DSL query in the filter parameter to filter the
             set of documents that an ES|QL query runs on.
         :param format: A short version of the Accept header, e.g. json, yaml.
+        :param include_ccs_metadata: When set to `true` and performing a cross-cluster
+            query, the response will include an extra `_clusters` object with information
+            about the clusters that participated in the search along with info such as
+            shards count.
         :param locale:
         :param params: To avoid any attempts of hacking or code injection, extract the
             values in a separate list of parameters. Use question mark placeholders (?)
@@ -126,6 +416,8 @@ class EsqlClient(NamespacedClient):
                 __body["columnar"] = columnar
             if filter is not None:
                 __body["filter"] = filter
+            if include_ccs_metadata is not None:
+                __body["include_ccs_metadata"] = include_ccs_metadata
             if locale is not None:
                 __body["locale"] = locale
             if params is not None:

elasticsearch/_async/client/features.py

@@ -35,17 +35,17 @@ class FeaturesClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Get the features. Get a list of features that can be included in snapshots using
-        the `feature_states` field when creating a snapshot. You can use this API to
-        determine which feature states to include when taking a snapshot. By default,
-        all feature states are included in a snapshot if that snapshot includes the global
-        state, or none if it does not. A feature state includes one or more system indices
-        necessary for a given feature to function. In order to ensure data integrity,
-        all system indices that comprise a feature state are snapshotted and restored
-        together. The features listed by this API are a combination of built-in features
-        and features defined by plugins. In order for a feature state to be listed in
-        this API and recognized as a valid feature state by the create snapshot API,
-        the plugin that defines that feature must be installed on the master node.
+        .. raw:: html
+
+          <p>Get the features.
+          Get a list of features that can be included in snapshots using the <code>feature_states</code> field when creating a snapshot.
+          You can use this API to determine which feature states to include when taking a snapshot.
+          By default, all feature states are included in a snapshot if that snapshot includes the global state, or none if it does not.</p>
+          <p>A feature state includes one or more system indices necessary for a given feature to function.
+          In order to ensure data integrity, all system indices that comprise a feature state are snapshotted and restored together.</p>
+          <p>The features listed by this API are a combination of built-in features and features defined by plugins.
+          In order for a feature state to be listed in this API and recognized as a valid feature state by the create snapshot API, the plugin that defines that feature must be installed on the master node.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-features-api.html>`_
         """
@@ -81,20 +81,20 @@ class FeaturesClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Reset the features. Clear all of the state information stored in system indices
-        by Elasticsearch features, including the security and machine learning indices.
-        WARNING: Intended for development and testing use only. Do not reset features
-        on a production cluster. Return a cluster to the same state as a new installation
-        by resetting the feature state for all Elasticsearch features. This deletes all
-        state information stored in system indices. The response code is HTTP 200 if
-        the state is successfully reset for all features. It is HTTP 500 if the reset
-        operation failed for any feature. Note that select features might provide a way
-        to reset particular system indices. Using this API resets all features, both
-        those that are built-in and implemented as plugins. To list the features that
-        will be affected, use the get features API. IMPORTANT: The features installed
-        on the node you submit this request to are the features that will be reset. Run
-        on the master node if you have any doubts about which plugins are installed on
-        individual nodes.
+        .. raw:: html
+
+          <p>Reset the features.
+          Clear all of the state information stored in system indices by Elasticsearch features, including the security and machine learning indices.</p>
+          <p>WARNING: Intended for development and testing use only. Do not reset features on a production cluster.</p>
+          <p>Return a cluster to the same state as a new installation by resetting the feature state for all Elasticsearch features.
+          This deletes all state information stored in system indices.</p>
+          <p>The response code is HTTP 200 if the state is successfully reset for all features.
+          It is HTTP 500 if the reset operation failed for any feature.</p>
+          <p>Note that select features might provide a way to reset particular system indices.
+          Using this API resets all features, both those that are built-in and implemented as plugins.</p>
+          <p>To list the features that will be affected, use the get features API.</p>
+          <p>IMPORTANT: The features installed on the node you submit this request to are the features that will be reset. Run on the master node if you have any doubts about which plugins are installed on individual nodes.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/modules-snapshots.html>`_
         """

elasticsearch/_async/client/fleet.py

@@ -46,8 +46,10 @@ class FleetClient(NamespacedClient):
         wait_for_index: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Returns the current global checkpoints for an index. This API is design for internal
-        use by the fleet server project.
+        .. raw:: html
+
+          <p>Returns the current global checkpoints for an index. This API is design for internal use by the fleet server project.</p>
+
 
         `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-global-checkpoints.html>`_
 
@@ -132,10 +134,12 @@ class FleetClient(NamespacedClient):
         wait_for_checkpoints: t.Optional[t.Sequence[int]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Executes several [fleet searches](https://www.elastic.co/guide/en/elasticsearch/reference/current/fleet-search.html)
-        with a single API request. The API follows the same structure as the [multi search](https://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html)
-        API. However, similar to the fleet search API, it supports the wait_for_checkpoints
-        parameter.
+        .. raw:: html
+
+          <p>Executes several <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/fleet-search.html">fleet searches</a> with a single API request.
+          The API follows the same structure as the <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/search-multi-search.html">multi search</a> API. However, similar to the fleet search API, it
+          supports the wait_for_checkpoints parameter.</p>
+
 
         :param searches:
         :param index: A single target to search. If the target is an index alias, it
@@ -378,9 +382,11 @@ class FleetClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        The purpose of the fleet search api is to provide a search api where the search
-        will only be executed after provided checkpoint has been processed and is visible
-        for searches inside of Elasticsearch.
+        .. raw:: html
+
+          <p>The purpose of the fleet search api is to provide a search api where the search will only be executed
+          after provided checkpoint has been processed and is visible for searches inside of Elasticsearch.</p>
+
 
         :param index: A single target to search. If the target is an index alias, it
             must resolve to a single index.