elasticsearch 8.16.0__py3-none-any.whl → 8.17.1__py3-none-any.whl

elasticsearch/_async/client/shutdown.py

@@ -42,10 +42,15 @@ class ShutdownClient(NamespacedClient):
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Removes a node from the shutdown list. Designed for indirect use by ECE/ESS and
-        ECK. Direct use is not supported.
+        Cancel node shutdown preparations. Remove a node from the shutdown list so it
+        can resume normal operations. You must explicitly clear the shutdown request
+        when a node rejoins the cluster or when a node has permanently left the cluster.
+        Shutdown requests are never removed automatically by Elasticsearch. NOTE: This
+        feature is designed for indirect use by Elastic Cloud, Elastic Cloud Enterprise,
+        and Elastic Cloud on Kubernetes. Direct use is not supported. If the operator
+        privileges feature is enabled, you must be an operator to use this API.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/current>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/delete-shutdown.html>`_
 
         :param node_id: The node id of node to be removed from the shutdown state
         :param master_timeout: Period to wait for a connection to the master node. If
@@ -98,10 +103,15 @@ class ShutdownClient(NamespacedClient):
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieve status of a node or nodes that are currently marked as shutting down.
-        Designed for indirect use by ECE/ESS and ECK. Direct use is not supported.
+        Get the shutdown status. Get information about nodes that are ready to be shut
+        down, have shut down preparations still in progress, or have stalled. The API
+        returns status information for each part of the shut down process. NOTE: This
+        feature is designed for indirect use by Elasticsearch Service, Elastic Cloud
+        Enterprise, and Elastic Cloud on Kubernetes. Direct use is not supported. If
+        the operator privileges feature is enabled, you must be an operator to use this
+        API.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/current>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/get-shutdown.html>`_
 
         :param node_id: Which node for which to retrieve the shutdown status
         :param master_timeout: Period to wait for a connection to the master node. If
@@ -166,12 +176,25 @@ class ShutdownClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Adds a node to be shut down. Designed for indirect use by ECE/ESS and ECK. Direct
-        use is not supported.
+        Prepare a node to be shut down. NOTE: This feature is designed for indirect use
+        by Elastic Cloud, Elastic Cloud Enterprise, and Elastic Cloud on Kubernetes.
+        Direct use is not supported. If you specify a node that is offline, it will be
+        prepared for shut down when it rejoins the cluster. If the operator privileges
+        feature is enabled, you must be an operator to use this API. The API migrates
+        ongoing tasks and index shards to other nodes as needed to prepare a node to
+        be restarted or shut down and removed from the cluster. This ensures that Elasticsearch
+        can be stopped safely with minimal disruption to the cluster. You must specify
+        the type of shutdown: `restart`, `remove`, or `replace`. If a node is already
+        being prepared for shutdown, you can use this API to change the shutdown type.
+        IMPORTANT: This API does NOT terminate the Elasticsearch process. Monitor the
+        node shutdown status to determine when it is safe to stop Elasticsearch.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/current>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/put-shutdown.html>`_
 
-        :param node_id: The node id of node to be shut down
+        :param node_id: The node identifier. This parameter is not validated against
+            the cluster's active nodes. This enables you to register a node for shut
+            down while it is offline. No error is thrown if you specify an invalid node
+            ID.
         :param reason: A human-readable reason that the node is being shut down. This
             field provides information for other cluster operators; it does not affect
             the shut down process.
@@ -192,17 +215,17 @@ class ShutdownClient(NamespacedClient):
             the index.unassigned.node_left.delayed_timeout setting. If you specify both
             a restart allocation delay and an index-level allocation delay, the longer
             of the two is used.
-        :param master_timeout: 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.
+        :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.
         :param target_node_name: Only valid if type is replace. Specifies the name of
             the node that is replacing the node being shut down. Shards from the shut
             down node are only allowed to be allocated to the target node, and no other
             data will be allocated to the target node. During relocation of data certain
             allocation rules are ignored, such as disk watermarks or user attribute filtering
             rules.
-        :param timeout: Period to wait for a response. If no response is received before
-            the timeout expires, the request fails and returns an error.
+        :param timeout: The period to wait for a response. If no response is received
+            before the timeout expires, the request fails and returns an error.
         """
         if node_id in SKIP_IN_PATH:
             raise ValueError("Empty value passed for parameter 'node_id'")

elasticsearch/_async/client/simulate.py

@@ -0,0 +1,151 @@
+#  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,
+    _quote,
+    _rewrite_parameters,
+    _stability_warning,
+)
+
+
+class SimulateClient(NamespacedClient):
+
+    @_rewrite_parameters(
+        body_fields=(
+            "docs",
+            "component_template_substitutions",
+            "index_template_subtitutions",
+            "mapping_addition",
+            "pipeline_substitutions",
+        ),
+    )
+    @_stability_warning(Stability.EXPERIMENTAL)
+    async def ingest(
+        self,
+        *,
+        docs: t.Optional[t.Sequence[t.Mapping[str, t.Any]]] = None,
+        index: t.Optional[str] = None,
+        component_template_substitutions: 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,
+        index_template_subtitutions: t.Optional[
+            t.Mapping[str, t.Mapping[str, t.Any]]
+        ] = None,
+        mapping_addition: t.Optional[t.Mapping[str, t.Any]] = None,
+        pipeline: t.Optional[str] = None,
+        pipeline_substitutions: t.Optional[
+            t.Mapping[str, t.Mapping[str, t.Any]]
+        ] = None,
+        pretty: t.Optional[bool] = None,
+        body: t.Optional[t.Dict[str, t.Any]] = None,
+    ) -> ObjectApiResponse[t.Any]:
+        """
+        Simulate data ingestion. Run ingest pipelines against a set of provided documents,
+        optionally with substitute pipeline definitions, to simulate ingesting data into
+        an index. This API is meant to be used for troubleshooting or pipeline development,
+        as it does not actually index any data into Elasticsearch. The API runs the default
+        and final pipeline for that index against a set of documents provided in the
+        body of the request. If a pipeline contains a reroute processor, it follows that
+        reroute processor to the new index, running that index's pipelines as well the
+        same way that a non-simulated ingest would. No data is indexed into Elasticsearch.
+        Instead, the transformed document is returned, along with the list of pipelines
+        that have been run and the name of the index where the document would have been
+        indexed if this were not a simulation. The transformed document is validated
+        against the mappings that would apply to this index, and any validation error
+        is reported in the result. This API differs from the simulate pipeline API in
+        that you specify a single pipeline for that API, and it runs only that one pipeline.
+        The simulate pipeline API is more useful for developing a single pipeline, while
+        the simulate ingest API is more useful for troubleshooting the interaction of
+        the various pipelines that get applied when ingesting into an index. By default,
+        the pipeline definitions that are currently in the system are used. However,
+        you can supply substitute pipeline definitions in the body of the request. These
+        will be used in place of the pipeline definitions that are already in the system.
+        This can be used to replace existing pipeline definitions or to create new ones.
+        The pipeline substitutions are used only within this request.
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/simulate-ingest-api.html>`_
+
+        :param docs: Sample documents to test in the pipeline.
+        :param index: The index to simulate ingesting into. This value can be overridden
+            by specifying an index on each document. If you specify this parameter in
+            the request path, it is used for any documents that do not explicitly specify
+            an index argument.
+        :param component_template_substitutions: A map of component template names to
+            substitute component template definition objects.
+        :param index_template_subtitutions: A map of index template names to substitute
+            index template definition objects.
+        :param mapping_addition:
+        :param pipeline: The pipeline to use as the default pipeline. This value can
+            be used to override the default pipeline of the index.
+        :param pipeline_substitutions: Pipelines to test. If you don’t specify the `pipeline`
+            request path parameter, this parameter is required. If you specify both this
+            and the request path parameter, the API only uses the request path parameter.
+        """
+        if docs is None and body is None:
+            raise ValueError("Empty value passed for parameter 'docs'")
+        __path_parts: t.Dict[str, str]
+        if index not in SKIP_IN_PATH:
+            __path_parts = {"index": _quote(index)}
+            __path = f'/_ingest/{__path_parts["index"]}/_simulate'
+        else:
+            __path_parts = {}
+            __path = "/_ingest/_simulate"
+        __query: t.Dict[str, t.Any] = {}
+        __body: t.Dict[str, t.Any] = body if body is not None else {}
+        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 pipeline is not None:
+            __query["pipeline"] = pipeline
+        if pretty is not None:
+            __query["pretty"] = pretty
+        if not __body:
+            if docs is not None:
+                __body["docs"] = docs
+            if component_template_substitutions is not None:
+                __body["component_template_substitutions"] = (
+                    component_template_substitutions
+                )
+            if index_template_subtitutions is not None:
+                __body["index_template_subtitutions"] = index_template_subtitutions
+            if mapping_addition is not None:
+                __body["mapping_addition"] = mapping_addition
+            if pipeline_substitutions is not None:
+                __body["pipeline_substitutions"] = pipeline_substitutions
+        __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="simulate.ingest",
+            path_parts=__path_parts,
+        )

elasticsearch/_async/client/slm.py

@@ -33,14 +33,23 @@ class SlmClient(NamespacedClient):
         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,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes an existing snapshot lifecycle policy.
+        Delete a policy. Delete a snapshot lifecycle policy definition. This operation
+        prevents any future snapshots from being taken but does not cancel in-progress
+        snapshots or remove previously-taken snapshots.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-delete-policy.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-delete-policy.html>`_
 
         :param policy_id: The id of the snapshot lifecycle policy to remove
+        :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.
+        :param timeout: The period to wait for a response. If no response is received
+            before the timeout expires, the request fails and returns an error.
         """
         if policy_id in SKIP_IN_PATH:
             raise ValueError("Empty value passed for parameter 'policy_id'")
@@ -53,8 +62,12 @@ class SlmClient(NamespacedClient):
             __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
+        if timeout is not None:
+            __query["timeout"] = timeout
         __headers = {"accept": "application/json"}
         return await self.perform_request(  # type: ignore[return-value]
             "DELETE",
@@ -73,15 +86,24 @@ class SlmClient(NamespacedClient):
         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,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Immediately creates a snapshot according to the lifecycle policy, without waiting
-        for the scheduled time.
+        Run a policy. Immediately create a snapshot according to the snapshot lifecycle
+        policy without waiting for the scheduled time. The snapshot policy is normally
+        applied according to its schedule, but you might want to manually run a policy
+        before performing an upgrade or other maintenance.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-execute-lifecycle.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-execute-lifecycle.html>`_
 
         :param policy_id: The id of the snapshot lifecycle policy to be executed
+        :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.
+        :param timeout: The period to wait for a response. If no response is received
+            before the timeout expires, the request fails and returns an error.
         """
         if policy_id in SKIP_IN_PATH:
             raise ValueError("Empty value passed for parameter 'policy_id'")
@@ -94,8 +116,12 @@ class SlmClient(NamespacedClient):
             __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
+        if timeout is not None:
+            __query["timeout"] = timeout
         __headers = {"accept": "application/json"}
         return await self.perform_request(  # type: ignore[return-value]
             "PUT",
@@ -113,12 +139,22 @@ class SlmClient(NamespacedClient):
         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,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes any snapshots that are expired according to the policy's retention rules.
+        Run a retention policy. Manually apply the retention policy to force immediate
+        removal of snapshots that are expired according to the snapshot lifecycle policy
+        retention rules. The retention policy is normally applied according to its schedule.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-execute-retention.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-execute-retention.html>`_
+
+        :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.
+        :param timeout: The period to wait for a response. If no response is received
+            before the timeout expires, the request fails and returns an error.
         """
         __path_parts: t.Dict[str, str] = {}
         __path = "/_slm/_execute_retention"
@@ -129,8 +165,12 @@ class SlmClient(NamespacedClient):
             __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
+        if timeout is not None:
+            __query["timeout"] = timeout
         __headers = {"accept": "application/json"}
         return await self.perform_request(  # type: ignore[return-value]
             "POST",
@@ -149,15 +189,22 @@ class SlmClient(NamespacedClient):
         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,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves one or more snapshot lifecycle policy definitions and information about
-        the latest snapshot attempts.
+        Get policy information. Get snapshot lifecycle policy definitions and information
+        about the latest snapshot attempts.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-get-policy.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-get-policy.html>`_
 
         :param policy_id: Comma-separated list of snapshot lifecycle policies to retrieve
+        :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.
+        :param timeout: The period to wait for a response. If no response is received
+            before the timeout expires, the request fails and returns an error.
         """
         __path_parts: t.Dict[str, str]
         if policy_id not in SKIP_IN_PATH:
@@ -173,8 +220,12 @@ class SlmClient(NamespacedClient):
             __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
+        if timeout is not None:
+            __query["timeout"] = timeout
         __headers = {"accept": "application/json"}
         return await self.perform_request(  # type: ignore[return-value]
             "GET",
@@ -192,13 +243,21 @@ class SlmClient(NamespacedClient):
         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,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Returns global and policy-level statistics about actions taken by snapshot lifecycle
-        management.
+        Get snapshot lifecycle management statistics. Get global and policy-level statistics
+        about actions taken by snapshot lifecycle management.
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-get-stats.html>`_
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-get-stats.html>`_
+        :param master_timeout: 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.
+        :param timeout: Period to wait for a response. If no response is received before
+            the timeout expires, the request fails and returns an error.
         """
         __path_parts: t.Dict[str, str] = {}
         __path = "/_slm/stats"
@@ -209,8 +268,12 @@ class SlmClient(NamespacedClient):
             __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
+        if timeout is not None:
+            __query["timeout"] = timeout
         __headers = {"accept": "application/json"}
         return await self.perform_request(  # type: ignore[return-value]
             "GET",
@@ -228,12 +291,22 @@ class SlmClient(NamespacedClient):
         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,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves the status of snapshot lifecycle management (SLM).
+        Get the snapshot lifecycle management status.
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-get-status.html>`_
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-get-status.html>`_
+        :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`.
+        :param timeout: The period to wait for a response. 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 = "/_slm/status"
@@ -244,8 +317,12 @@ class SlmClient(NamespacedClient):
             __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
+        if timeout is not None:
+            __query["timeout"] = timeout
         __headers = {"accept": "application/json"}
         return await self.perform_request(  # type: ignore[return-value]
             "GET",
@@ -277,16 +354,19 @@ class SlmClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates or updates a snapshot lifecycle policy.
+        Create or update a policy. Create or update a snapshot lifecycle policy. If the
+        policy already exists, this request increments the policy version. Only the latest
+        version of a policy is stored.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-put-policy.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-put-policy.html>`_
 
-        :param policy_id: ID for the snapshot lifecycle policy you want to create or
-            update.
+        :param policy_id: The identifier for the snapshot lifecycle policy you want to
+            create or update.
         :param config: Configuration for each snapshot created by the policy.
-        :param master_timeout: 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.
+        :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`.
         :param name: Name automatically assigned to each snapshot created by the policy.
             Date math is supported. To prevent conflicting snapshot names, a UUID is
             automatically appended to each snapshot name.
@@ -297,8 +377,9 @@ class SlmClient(NamespacedClient):
             by the policy.
         :param schedule: Periodic or absolute schedule at which the policy creates snapshots.
             SLM applies schedule changes immediately.
-        :param timeout: Period to wait for a response. If no response is received before
-            the timeout expires, the request fails and returns an error.
+        :param timeout: The period to wait for a response. 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`.
         """
         if policy_id in SKIP_IN_PATH:
             raise ValueError("Empty value passed for parameter 'policy_id'")
@@ -351,12 +432,24 @@ class SlmClient(NamespacedClient):
         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,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Turns on snapshot lifecycle management (SLM).
+        Start snapshot lifecycle management. Snapshot lifecycle management (SLM) starts
+        automatically when a cluster is formed. Manually starting SLM is necessary only
+        if it has been stopped using the stop SLM API.
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-start.html>`_
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-start.html>`_
+        :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`.
+        :param timeout: The period to wait for a response. 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 = "/_slm/start"
@@ -367,8 +460,12 @@ class SlmClient(NamespacedClient):
             __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
+        if timeout is not None:
+            __query["timeout"] = timeout
         __headers = {"accept": "application/json"}
         return await self.perform_request(  # type: ignore[return-value]
             "POST",
@@ -386,12 +483,30 @@ class SlmClient(NamespacedClient):
         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,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Turns off snapshot lifecycle management (SLM).
+        Stop snapshot lifecycle management. Stop all snapshot lifecycle management (SLM)
+        operations and the SLM plugin. This API is useful when you are performing maintenance
+        on a cluster and need to prevent SLM from performing any actions on your data
+        streams or indices. Stopping SLM does not stop any snapshots that are in progress.
+        You can manually trigger snapshots with the run snapshot lifecycle policy API
+        even if SLM is stopped. The API returns a response as soon as the request is
+        acknowledged, but the plugin might continue to run until in-progress operations
+        complete and it can be safely stopped. Use the get snapshot lifecycle management
+        status API to see if SLM is running.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/slm-api-stop.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.17/slm-api-stop.html>`_
+
+        :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`.
+        :param timeout: The period to wait for a response. 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 = "/_slm/stop"
@@ -402,8 +517,12 @@ class SlmClient(NamespacedClient):
             __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
+        if timeout is not None:
+            __query["timeout"] = timeout
         __headers = {"accept": "application/json"}
         return await self.perform_request(  # type: ignore[return-value]
             "POST",