elasticsearch 8.14.0__py3-none-any.whl → 8.15.0__py3-none-any.whl

elasticsearch/_async/client/ml.py

@@ -36,9 +36,13 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Clear the cached results from a trained model deployment
+        Clears a trained model deployment cache on all nodes where the trained model
+        is assigned. A trained model deployment may have an inference cache enabled.
+        As requests are handled by each allocated node, their responses may be cached
+        on that individual node. Calling this API clears the caches without restarting
+        the deployment.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/clear-trained-model-deployment-cache.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/clear-trained-model-deployment-cache.html>`_
 
         :param model_id: The unique identifier of the trained model.
         """
@@ -80,14 +84,25 @@ class MlClient(NamespacedClient):
         force: t.Optional[bool] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        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]:
         """
-        Closes one or more anomaly detection jobs. A job can be opened and closed multiple
-        times throughout its lifecycle.
-
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-close-job.html>`_
+        Close anomaly detection jobs A job can be opened and closed multiple times throughout
+        its lifecycle. A closed job cannot receive data or perform analysis operations,
+        but you can still explore and navigate results. When you close a job, it runs
+        housekeeping tasks such as pruning the model history, flushing buffers, calculating
+        final results and persisting the model snapshots. Depending upon the size of
+        the job, it could take several minutes to close and the equivalent time to re-open.
+        After it is closed, the job has a minimal overhead on the cluster except for
+        maintaining its meta data. Therefore it is a best practice to close jobs that
+        are no longer required to process data. If you close an anomaly detection job
+        whose datafeed is running, the request first tries to stop the datafeed. This
+        behavior is equivalent to calling stop datafeed API with the same timeout and
+        force parameters as the close job request. When a datafeed that has a specified
+        end date stops, it automatically closes its associated job.
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-close-job.html>`_
 
         :param job_id: Identifier for the anomaly detection job. It can be a job identifier,
             a group name, or a wildcard expression. You can close multiple anomaly detection
@@ -146,9 +161,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes a calendar.
+        Removes all scheduled events from a calendar, then deletes it.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-calendar.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-calendar.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar.
         """
@@ -189,7 +204,7 @@ class MlClient(NamespacedClient):
         """
         Deletes scheduled events from a calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-calendar-event.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-calendar-event.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar.
         :param event_id: Identifier for the scheduled event. You can obtain this identifier
@@ -237,7 +252,7 @@ class MlClient(NamespacedClient):
         """
         Deletes anomaly detection jobs from a calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-calendar-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-calendar-job.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar.
         :param job_id: An identifier for the anomaly detection jobs. It can be a job
@@ -281,12 +296,12 @@ class MlClient(NamespacedClient):
         force: t.Optional[bool] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes an existing data frame analytics job.
+        Deletes a data frame analytics job.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/delete-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/delete-dfanalytics.html>`_
 
         :param id: Identifier for the data frame analytics job.
         :param force: If `true`, it deletes a job that is not stopped; this method is
@@ -334,7 +349,7 @@ class MlClient(NamespacedClient):
         """
         Deletes an existing datafeed.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-datafeed.html>`_
 
         :param datafeed_id: A numerical character string that uniquely identifies the
             datafeed. This identifier can contain lowercase alphanumeric characters (a-z
@@ -380,13 +395,19 @@ class MlClient(NamespacedClient):
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
         requests_per_second: t.Optional[float] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        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]:
         """
-        Deletes expired and unused machine learning data.
+        Deletes expired and unused machine learning data. Deletes all job results, model
+        snapshots and forecast data that have exceeded their retention days period. Machine
+        learning state documents that are not associated with any job are also deleted.
+        You can limit the request to a single or set of anomaly detection jobs by using
+        a job identifier, a group name, a comma-separated list of jobs, or a wildcard
+        expression. You can delete expired data for all anomaly detection jobs by using
+        _all, by specifying * as the <job_id>, or by omitting the <job_id>.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-expired-data.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-expired-data.html>`_
 
         :param job_id: Identifier for an anomaly detection job. It can be a job identifier,
             a group name, or a wildcard expression.
@@ -443,9 +464,11 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes a filter.
+        Deletes a filter. If an anomaly detection job references the filter, you cannot
+        delete the filter. You must update or delete the job before you can delete the
+        filter.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-filter.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-filter.html>`_
 
         :param filter_id: A string that uniquely identifies a filter.
         """
@@ -483,12 +506,15 @@ class MlClient(NamespacedClient):
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes forecasts from a machine learning job.
+        Deletes forecasts from a machine learning job. By default, forecasts are retained
+        for 14 days. You can specify a different retention period with the `expires_in`
+        parameter in the forecast jobs API. The delete forecast API enables you to delete
+        one or more forecasts before they expire.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-forecast.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-forecast.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param forecast_id: A comma-separated list of forecast identifiers. If you do
@@ -553,9 +579,14 @@ class MlClient(NamespacedClient):
         wait_for_completion: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes an existing anomaly detection job.
+        Deletes an anomaly detection job. All job configuration, model state and results
+        are deleted. It is not currently possible to delete multiple jobs using wildcards
+        or a comma separated list. If you delete a job that has a datafeed, the request
+        first tries to delete the datafeed. This behavior is equivalent to calling the
+        delete datafeed API with the same timeout and force parameters as the delete
+        job request.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-job.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param delete_user_annotations: Specifies whether annotations that have been
@@ -607,9 +638,12 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes an existing model snapshot.
+        Deletes an existing model snapshot. You cannot delete the active model snapshot.
+        To delete that snapshot, first revert to a different one. To identify the active
+        model snapshot, refer to the `model_snapshot_id` in the results from the get
+        jobs API.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-delete-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-snapshot.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: Identifier for the model snapshot.
@@ -657,7 +691,7 @@ class MlClient(NamespacedClient):
         Deletes an existing trained inference model that is currently not referenced
         by an ingest pipeline.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/delete-trained-models.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/delete-trained-models.html>`_
 
         :param model_id: The unique identifier of the trained model.
         :param force: Forcefully deletes a trained model that is referenced by ingest
@@ -700,9 +734,11 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes a model alias that refers to the trained model
+        Deletes a trained model alias. This API deletes an existing model alias that
+        refers to a trained model. If the model alias is missing or refers to a model
+        other than the one identified by the `model_id`, this API returns an error.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/delete-trained-models-aliases.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/delete-trained-models-aliases.html>`_
 
         :param model_id: The trained model ID to which the model alias refers.
         :param model_alias: The model alias to delete.
@@ -755,9 +791,11 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Estimates the model memory
+        Makes an estimation of the memory usage for an anomaly detection job model. It
+        is based on analysis configuration details for the job and cardinality estimates
+        for the fields it references.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-apis.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-apis.html>`_
 
         :param analysis_config: For a list of the properties that you can specify in
             the `analysis_config` component of the body of this API.
@@ -820,9 +858,12 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Evaluates the data frame analytics for an annotated index.
+        Evaluates the data frame analytics for an annotated index. The API packages together
+        commonly used evaluation metrics for various types of machine learning features.
+        This has been designed for use on indexes created by data frame analytics. Evaluation
+        requires both a ground truth field and an analytics result field to be present.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/evaluate-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/evaluate-dfanalytics.html>`_
 
         :param evaluation: Defines the type of evaluation you want to perform.
         :param index: Defines the `index` in which the evaluation will be performed.
@@ -894,9 +935,15 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Explains a data frame analytics config.
+        Explains a data frame analytics config. This API provides explanations for a
+        data frame analytics config that either exists already or one that has not been
+        created yet. The following explanations are provided: * which fields are included
+        or not in the analysis and why, * how much memory is estimated to be required.
+        The estimate can be used when deciding the appropriate value for model_memory_limit
+        setting later on. If you have object fields or fields that are excluded via source
+        filtering, they are not included in the explanation.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/explain-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/explain-dfanalytics.html>`_
 
         :param id: Identifier for the data frame analytics job. This identifier can contain
             lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores.
@@ -994,9 +1041,16 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Forces any buffered data to be processed by the job.
+        Forces any buffered data to be processed by the job. The flush jobs API is only
+        applicable when sending data for analysis using the post data API. Depending
+        on the content of the buffer, then it might additionally calculate new results.
+        Both flush and close operations are similar, however the flush is more efficient
+        if you are expecting to send more data for analysis. When flushing, the job remains
+        open and is available to continue analyzing data. A close operation additionally
+        prunes and persists the model state to disk and the job must be opened again
+        before analyzing further data.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-flush-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-flush-job.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param advance_time: Refer to the description for the `advance_time` query parameter.
@@ -1052,9 +1106,9 @@ class MlClient(NamespacedClient):
         self,
         *,
         job_id: str,
-        duration: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        duration: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         error_trace: t.Optional[bool] = None,
-        expires_in: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        expires_in: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
         max_model_memory: t.Optional[str] = None,
@@ -1063,8 +1117,11 @@ class MlClient(NamespacedClient):
     ) -> ObjectApiResponse[t.Any]:
         """
         Predicts the future behavior of a time series by using its historical behavior.
+        Forecasts are not supported for jobs that perform population analysis; an error
+        occurs if you try to create a forecast for a job that has an `over_field_name`
+        in its configuration.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-forecast.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-forecast.html>`_
 
         :param job_id: Identifier for the anomaly detection job. The job must be open
             when you create a forecast; otherwise, an error occurs.
@@ -1144,9 +1201,10 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves anomaly detection job results for one or more buckets.
+        Retrieves anomaly detection job results for one or more buckets. The API presents
+        a chronological view of the records, grouped by bucket.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-bucket.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-bucket.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param timestamp: The timestamp of a single bucket result. If you do not specify
@@ -1241,7 +1299,7 @@ class MlClient(NamespacedClient):
         """
         Retrieves information about the scheduled events in calendars.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-calendar-event.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-calendar-event.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar. You can get
             information for multiple calendars by using a comma-separated list of ids
@@ -1307,7 +1365,7 @@ class MlClient(NamespacedClient):
         """
         Retrieves configuration information for calendars.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-calendar.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-calendar.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar. You can get
             information for multiple calendars by using a comma-separated list of ids
@@ -1380,7 +1438,7 @@ class MlClient(NamespacedClient):
         """
         Retrieves anomaly detection job results for one or more categories.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-category.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-category.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param category_id: Identifier for the category, which is unique in the job.
@@ -1460,9 +1518,11 @@ class MlClient(NamespacedClient):
         size: t.Optional[int] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves configuration information for data frame analytics jobs.
+        Retrieves configuration information for data frame analytics jobs. You can get
+        information for multiple data frame analytics jobs in a single API request by
+        using a comma-separated list of data frame analytics jobs or a wildcard expression.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/get-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/get-dfanalytics.html>`_
 
         :param id: Identifier for the data frame analytics job. If you do not specify
             this option, the API returns information for the first hundred data frame
@@ -1534,7 +1594,7 @@ class MlClient(NamespacedClient):
         """
         Retrieves usage information for data frame analytics jobs.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/get-dfanalytics-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/get-dfanalytics-stats.html>`_
 
         :param id: Identifier for the data frame analytics job. If you do not specify
             this option, the API returns information for the first hundred data frame
@@ -1597,9 +1657,14 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves usage information for datafeeds.
+        Retrieves usage information for datafeeds. You can get statistics for multiple
+        datafeeds in a single API request by using a comma-separated list of datafeeds
+        or a wildcard expression. You can get statistics for all datafeeds by using `_all`,
+        by specifying `*` as the `<feed_id>`, or by omitting the `<feed_id>`. If the
+        datafeed is stopped, the only information you receive is the `datafeed_id` and
+        the `state`. This API returns a maximum of 10,000 datafeeds.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-datafeed-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-datafeed-stats.html>`_
 
         :param datafeed_id: Identifier for the datafeed. It can be a datafeed identifier
             or a wildcard expression. If you do not specify one of these options, the
@@ -1653,9 +1718,13 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves configuration information for datafeeds.
+        Retrieves configuration information for datafeeds. You can get information for
+        multiple datafeeds in a single API request by using a comma-separated list of
+        datafeeds or a wildcard expression. You can get information for all datafeeds
+        by using `_all`, by specifying `*` as the `<feed_id>`, or by omitting the `<feed_id>`.
+        This API returns a maximum of 10,000 datafeeds.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-datafeed.html>`_
 
         :param datafeed_id: Identifier for the datafeed. It can be a datafeed identifier
             or a wildcard expression. If you do not specify one of these options, the
@@ -1716,9 +1785,9 @@ class MlClient(NamespacedClient):
         size: t.Optional[int] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves filters.
+        Retrieves filters. You can get a single filter or all filters.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-filter.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-filter.html>`_
 
         :param filter_id: A string that uniquely identifies a filter.
         :param from_: Skips the specified number of filters.
@@ -1778,9 +1847,12 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves anomaly detection job results for one or more influencers.
+        Retrieves anomaly detection job results for one or more influencers. Influencers
+        are the entities that have contributed to, or are to blame for, the anomalies.
+        Influencer results are available only if an `influencer_field_name` is specified
+        in the job configuration.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-influencer.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-influencer.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param desc: If true, the results are sorted in descending order.
@@ -1861,7 +1933,7 @@ class MlClient(NamespacedClient):
         """
         Retrieves usage information for anomaly detection jobs.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-job-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-job-stats.html>`_
 
         :param job_id: Identifier for the anomaly detection job. It can be a job identifier,
             a group name, a comma-separated list of jobs, or a wildcard expression. If
@@ -1916,9 +1988,13 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves configuration information for anomaly detection jobs.
+        Retrieves configuration information for anomaly detection jobs. You can get information
+        for multiple anomaly detection jobs in a single API request by using a group
+        name, a comma-separated list of jobs, or a wildcard expression. You can get information
+        for all anomaly detection jobs by using `_all`, by specifying `*` as the `<job_id>`,
+        or by omitting the `<job_id>`.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-job.html>`_
 
         :param job_id: Identifier for the anomaly detection job. It can be a job identifier,
             a group name, or a wildcard expression. If you do not specify one of these
@@ -1972,16 +2048,16 @@ class MlClient(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["t.Literal[-1]", "t.Literal[0]", str]
-        ] = 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["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Returns information on how ML is using memory.
+        Get information about how machine learning jobs and trained models are using
+        memory, on each node, both within the JVM heap, and natively, outside of the
+        JVM.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/get-ml-memory.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/get-ml-memory.html>`_
 
         :param node_id: The names of particular nodes in the cluster to target. For example,
             `nodeId1,nodeId2` or `ml:true`
@@ -2034,9 +2110,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Gets stats for anomaly detection job model snapshot upgrades that are in progress.
+        Retrieves usage information for anomaly detection job model snapshot upgrades.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-job-model-snapshot-upgrade-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-job-model-snapshot-upgrade-stats.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: A numerical character string that uniquely identifies the
@@ -2107,7 +2183,7 @@ class MlClient(NamespacedClient):
         """
         Retrieves information about model snapshots.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-snapshot.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: A numerical character string that uniquely identifies the
@@ -2193,7 +2269,7 @@ class MlClient(NamespacedClient):
         *,
         job_id: str,
         allow_no_match: t.Optional[bool] = None,
-        bucket_span: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        bucket_span: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         end: t.Optional[t.Union[str, t.Any]] = None,
         error_trace: t.Optional[bool] = None,
         exclude_interim: t.Optional[bool] = None,
@@ -2207,9 +2283,20 @@ class MlClient(NamespacedClient):
     ) -> ObjectApiResponse[t.Any]:
         """
         Retrieves overall bucket results that summarize the bucket results of multiple
-        anomaly detection jobs.
-
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-overall-buckets.html>`_
+        anomaly detection jobs. The `overall_score` is calculated by combining the scores
+        of all the buckets within the overall bucket span. First, the maximum `anomaly_score`
+        per anomaly detection job in the overall bucket is calculated. Then the `top_n`
+        of those scores are averaged to result in the `overall_score`. This means that
+        you can fine-tune the `overall_score` so that it is more or less sensitive to
+        the number of jobs that detect an anomaly at the same time. For example, if you
+        set `top_n` to `1`, the `overall_score` is the maximum bucket score in the overall
+        bucket. Alternatively, if you set `top_n` to the number of jobs, the `overall_score`
+        is high only when all jobs detect anomalies in that overall bucket. If you set
+        the `bucket_span` parameter (to a value greater than its default), the `overall_score`
+        is the maximum `overall_score` of the overall buckets that have a span equal
+        to the jobs' largest bucket span.
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-overall-buckets.html>`_
 
         :param job_id: Identifier for the anomaly detection job. It can be a job identifier,
             a group name, a comma-separated list of jobs or groups, or a wildcard expression.
@@ -2304,9 +2391,17 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves anomaly records for an anomaly detection job.
+        Retrieves anomaly records for an anomaly detection job. Records contain the detailed
+        analytical results. They describe the anomalous activity that has been identified
+        in the input data based on the detector configuration. There can be many anomaly
+        records depending on the characteristics and size of the input data. In practice,
+        there are often too many to be able to manually process them. The machine learning
+        features therefore perform a sophisticated aggregation of the anomaly records
+        into buckets. The number of record results depends on the number of anomalies
+        found in each bucket, which relates to the number of time series being modeled
+        and the number of detectors.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-get-record.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-record.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param desc: Refer to the description for the `desc` query parameter.
@@ -2374,7 +2469,7 @@ class MlClient(NamespacedClient):
     async def get_trained_models(
         self,
         *,
-        model_id: t.Optional[str] = None,
+        model_id: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         allow_no_match: t.Optional[bool] = None,
         decompress_definition: t.Optional[bool] = None,
         error_trace: t.Optional[bool] = None,
@@ -2384,20 +2479,28 @@ class MlClient(NamespacedClient):
         human: t.Optional[bool] = None,
         include: t.Optional[
             t.Union[
-                "t.Literal['definition', 'definition_status', 'feature_importance_baseline', 'hyperparameters', 'total_feature_importance']",
                 str,
+                t.Literal[
+                    "definition",
+                    "definition_status",
+                    "feature_importance_baseline",
+                    "hyperparameters",
+                    "total_feature_importance",
+                ],
             ]
         ] = None,
         pretty: t.Optional[bool] = None,
         size: t.Optional[int] = None,
-        tags: t.Optional[str] = None,
+        tags: t.Optional[t.Union[str, t.Sequence[str]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves configuration information for a trained inference model.
+        Retrieves configuration information for a trained model.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/get-trained-models.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/get-trained-models.html>`_
 
-        :param model_id: The unique identifier of the trained model.
+        :param model_id: The unique identifier of the trained model or a model alias.
+            You can get information for multiple trained models in a single API request
+            by using a comma-separated list of model IDs or a wildcard expression.
         :param allow_no_match: Specifies what to do when the request: - Contains wildcard
             expressions and there are no models that match. - Contains the _all string
             or no identifiers and there are no matches. - Contains wildcard expressions
@@ -2473,9 +2576,11 @@ class MlClient(NamespacedClient):
         size: t.Optional[int] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves usage information for trained inference models.
+        Retrieves usage information for trained models. You can get usage information
+        for multiple trained models in a single API request by using a comma-separated
+        list of model IDs or a wildcard expression.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/get-trained-models-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/get-trained-models-stats.html>`_
 
         :param model_id: The unique identifier of the trained model or a model alias.
             It can be a comma-separated list or a wildcard expression.
@@ -2532,13 +2637,13 @@ class MlClient(NamespacedClient):
         human: t.Optional[bool] = None,
         inference_config: t.Optional[t.Mapping[str, t.Any]] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        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]:
         """
-        Evaluate a trained model.
+        Evaluates a trained model.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/infer-trained-model.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/infer-trained-model.html>`_
 
         :param model_id: The unique identifier of the trained model.
         :param docs: An array of objects to pass to the model for inference. The objects
@@ -2593,9 +2698,14 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Returns defaults and limits used by machine learning.
+        Returns defaults and limits used by machine learning. This endpoint is designed
+        to be used by a user interface that needs to fully understand machine learning
+        configurations where some options are not specified, meaning that the defaults
+        should be used. This endpoint may be used to find out what those defaults are.
+        It also provides information about the maximum size of machine learning jobs
+        that could run in the current cluster configuration.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/get-ml-info.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/get-ml-info.html>`_
         """
         __path_parts: t.Dict[str, str] = {}
         __path = "/_ml/info"
@@ -2629,13 +2739,18 @@ class MlClient(NamespacedClient):
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        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]:
         """
-        Opens one or more anomaly detection jobs.
+        Opens one or more anomaly detection jobs. An anomaly detection job must be opened
+        in order for it to be ready to receive and analyze data. It can be opened and
+        closed multiple times throughout its lifecycle. When you open a new job, it starts
+        with an empty model. When you open an existing job, the most recent model state
+        is automatically loaded. The job is ready to resume its analysis from where it
+        left off, once new data is received.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-open-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-open-job.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param timeout: Refer to the description for the `timeout` query parameter.
@@ -2687,9 +2802,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Posts scheduled events in a calendar.
+        Adds scheduled events to a calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-post-calendar-event.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-post-calendar-event.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar.
         :param events: A list of one of more scheduled events. The event’s start and
@@ -2743,9 +2858,11 @@ class MlClient(NamespacedClient):
         reset_start: t.Optional[t.Union[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Sends data to an anomaly detection job for analysis.
+        Sends data to an anomaly detection job for analysis. IMPORTANT: For each job,
+        data can be accepted from only a single connection at a time. It is not currently
+        possible to post data to multiple jobs using wildcards or a comma-separated list.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-post-data.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-post-data.html>`_
 
         :param job_id: Identifier for the anomaly detection job. The job must have a
             state of open to receive and process the data.
@@ -2806,9 +2923,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Previews that will be analyzed given a data frame analytics config.
+        Previews the extracted features used by a data frame analytics config.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/preview-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/preview-dfanalytics.html>`_
 
         :param id: Identifier for the data frame analytics job.
         :param config: A data frame analytics config as described in create data frame
@@ -2868,9 +2985,17 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Previews a datafeed.
+        Previews a datafeed. This API returns the first "page" of search results from
+        a datafeed. You can preview an existing datafeed or provide configuration details
+        for a datafeed and anomaly detection job in the API. The preview shows the structure
+        of the data that will be passed to the anomaly detection engine. IMPORTANT: When
+        Elasticsearch security features are enabled, the preview uses the credentials
+        of the user that called the API. However, when the datafeed starts it uses the
+        roles of the last user that created or updated the datafeed. To get a preview
+        that accurately reflects the behavior of the datafeed, use the appropriate credentials.
+        You can also use secondary authorization headers to supply the credentials.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-preview-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-preview-datafeed.html>`_
 
         :param datafeed_id: A numerical character string that uniquely identifies the
             datafeed. This identifier can contain lowercase alphanumeric characters (a-z
@@ -2944,9 +3069,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Instantiates a calendar.
+        Creates a calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-put-calendar.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-put-calendar.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar.
         :param description: A description of the calendar.
@@ -2991,7 +3116,7 @@ class MlClient(NamespacedClient):
         self,
         *,
         calendar_id: str,
-        job_id: str,
+        job_id: 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,
@@ -3000,7 +3125,7 @@ class MlClient(NamespacedClient):
         """
         Adds an anomaly detection job to a calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-put-calendar-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-put-calendar-job.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar.
         :param job_id: An identifier for the anomaly detection jobs. It can be a job
@@ -3070,9 +3195,11 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Instantiates a data frame analytics job.
+        Instantiates a data frame analytics job. This API creates a data frame analytics
+        job that performs an analysis on the source indices and stores the outcome in
+        a destination index.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/put-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/put-dfanalytics.html>`_
 
         :param id: Identifier for the data frame analytics job. This identifier can contain
             lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores.
@@ -3213,13 +3340,13 @@ class MlClient(NamespacedClient):
         expand_wildcards: t.Optional[
             t.Union[
                 t.Sequence[
-                    t.Union["t.Literal['all', 'closed', 'hidden', 'none', 'open']", str]
+                    t.Union[str, t.Literal["all", "closed", "hidden", "none", "open"]]
                 ],
-                t.Union["t.Literal['all', 'closed', 'hidden', 'none', 'open']", str],
+                t.Union[str, t.Literal["all", "closed", "hidden", "none", "open"]],
             ]
         ] = None,
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
-        frequency: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        frequency: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         headers: t.Optional[t.Mapping[str, t.Union[str, t.Sequence[str]]]] = None,
         human: t.Optional[bool] = None,
         ignore_throttled: t.Optional[bool] = None,
@@ -3231,16 +3358,26 @@ class MlClient(NamespacedClient):
         max_empty_searches: t.Optional[int] = None,
         pretty: t.Optional[bool] = None,
         query: t.Optional[t.Mapping[str, t.Any]] = None,
-        query_delay: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        query_delay: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = 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,
         scroll_size: t.Optional[int] = None,
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Instantiates a datafeed.
+        Instantiates a datafeed. Datafeeds retrieve data from Elasticsearch for analysis
+        by an anomaly detection job. You can associate only one datafeed with each anomaly
+        detection job. The datafeed contains a query that runs at a defined interval
+        (`frequency`). If you are concerned about delayed data, you can add a delay (`query_delay')
+        at each interval. When Elasticsearch security features are enabled, your datafeed
+        remembers which roles the user who created it had at the time of creation and
+        runs the query using those same roles. If you provide secondary authorization
+        headers, those credentials are used instead. You must use Kibana, this API, or
+        the create anomaly detection jobs API to create a datafeed. Do not add a datafeed
+        directly to the `.ml-config` index. Do not give users `write` privileges on the
+        `.ml-config` index.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-put-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-put-datafeed.html>`_
 
         :param datafeed_id: A numerical character string that uniquely identifies the
             datafeed. This identifier can contain lowercase alphanumeric characters (a-z
@@ -3391,9 +3528,11 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Instantiates a filter.
+        Instantiates a filter. A filter contains a list of strings. It can be used by
+        one or more anomaly detection jobs. Specifically, filters are referenced in the
+        `custom_rules` property of detector configuration objects.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-put-filter.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-put-filter.html>`_
 
         :param filter_id: A string that uniquely identifies a filter.
         :param description: A description of the filter.
@@ -3458,7 +3597,7 @@ class MlClient(NamespacedClient):
         allow_lazy_open: t.Optional[bool] = None,
         analysis_limits: t.Optional[t.Mapping[str, t.Any]] = None,
         background_persist_interval: t.Optional[
-            t.Union["t.Literal[-1]", "t.Literal[0]", str]
+            t.Union[str, t.Literal[-1], t.Literal[0]]
         ] = None,
         custom_settings: t.Optional[t.Any] = None,
         daily_model_snapshot_retention_after_days: t.Optional[int] = None,
@@ -3477,9 +3616,10 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Instantiates an anomaly detection job.
+        Instantiates an anomaly detection job. If you include a `datafeed_config`, you
+        must have read index privileges on the source index.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-put-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-put-job.html>`_
 
         :param job_id: The identifier for the anomaly detection job. This identifier
             can contain lowercase alphanumeric characters (a-z and 0-9), hyphens, and
@@ -3647,7 +3787,7 @@ class MlClient(NamespacedClient):
         metadata: t.Optional[t.Any] = None,
         model_size_bytes: t.Optional[int] = None,
         model_type: t.Optional[
-            t.Union["t.Literal['lang_ident', 'pytorch', 'tree_ensemble']", str]
+            t.Union[str, t.Literal["lang_ident", "pytorch", "tree_ensemble"]]
         ] = None,
         platform_architecture: t.Optional[str] = None,
         prefix_strings: t.Optional[t.Mapping[str, t.Any]] = None,
@@ -3657,9 +3797,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates an inference trained model.
+        Enables you to supply a trained model that is not created by data frame analytics.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/put-trained-models.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/put-trained-models.html>`_
 
         :param model_id: The unique identifier of the trained model.
         :param compressed_definition: The compressed (GZipped and Base64 encoded) inference
@@ -3759,10 +3899,21 @@ class MlClient(NamespacedClient):
         reassign: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates a new model alias (or reassigns an existing one) to refer to the trained
-        model
-
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/put-trained-models-aliases.html>`_
+        Creates or updates a trained model alias. A trained model alias is a logical
+        name used to reference a single trained model. You can use aliases instead of
+        trained model identifiers to make it easier to reference your models. For example,
+        you can use aliases in inference aggregations and processors. An alias must be
+        unique and refer to only a single trained model. However, you can have multiple
+        aliases for each trained model. If you use this API to update an alias such that
+        it references a different trained model ID and the model uses a different type
+        of data frame analytics, an error occurs. For example, this situation occurs
+        if you have a trained model for regression analysis and a trained model for classification
+        analysis; you cannot reassign an alias from one type of trained model to another.
+        If you use this API to update an alias and there are very few input fields in
+        common between the old and new trained models for the model alias, the API returns
+        a warning.
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/put-trained-models-aliases.html>`_
 
         :param model_id: The identifier for the trained model that the alias refers to.
         :param model_alias: The alias to create or update. This value cannot end in numbers.
@@ -3818,9 +3969,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates part of a trained model definition
+        Creates part of a trained model definition.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/put-trained-model-definition-part.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/put-trained-model-definition-part.html>`_
 
         :param model_id: The unique identifier of the trained model.
         :param part: The definition part number. When the definition is loaded for inference
@@ -3895,9 +4046,11 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates a trained model vocabulary
+        Creates a trained model vocabulary. This API is supported only for natural language
+        processing (NLP) models. The vocabulary is stored in the index as described in
+        `inference_config.*.vocabulary` of the trained model definition.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/put-trained-model-vocabulary.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/put-trained-model-vocabulary.html>`_
 
         :param model_id: The unique identifier of the trained model.
         :param vocabulary: The model vocabulary, which must not be empty.
@@ -3951,9 +4104,11 @@ class MlClient(NamespacedClient):
         wait_for_completion: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Resets an existing anomaly detection job.
+        Resets an anomaly detection job. All model state and results are deleted. The
+        job is ready to start over as if it had just been created. It is not currently
+        possible to reset multiple jobs using wildcards or a comma separated list.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-reset-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-reset-job.html>`_
 
         :param job_id: The ID of the job to reset.
         :param delete_user_annotations: Specifies whether annotations that have been
@@ -4005,9 +4160,15 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Reverts to a specific snapshot.
+        Reverts to a specific snapshot. The machine learning features react quickly to
+        anomalous input, learning new behaviors in data. Highly anomalous input increases
+        the variance in the models whilst the system learns whether this is a new step-change
+        in behavior or a one-off event. In the case where this anomalous input is known
+        to be a one-off, then it might be appropriate to reset the model state to a time
+        before this event. For example, you might consider reverting to a saved snapshot
+        after Black Friday or a critical system failure.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-revert-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-revert-snapshot.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: You can specify `empty` as the <snapshot_id>. Reverting to
@@ -4062,13 +4223,21 @@ class MlClient(NamespacedClient):
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
         Sets a cluster wide upgrade_mode setting that prepares machine learning indices
-        for an upgrade.
-
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-set-upgrade-mode.html>`_
+        for an upgrade. When upgrading your cluster, in some circumstances you must restart
+        your nodes and reindex your machine learning indices. In those circumstances,
+        there must be no machine learning jobs running. You can close the machine learning
+        jobs, do the upgrade, then open all the jobs again. Alternatively, you can use
+        this API to temporarily halt tasks associated with the jobs and datafeeds and
+        prevent new jobs from opening. You can also use this API during upgrades that
+        do not require you to reindex your machine learning indices, though stopping
+        jobs is not a requirement in that case. You can see the current value for the
+        upgrade_mode setting by using the get machine learning info API.
+
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-set-upgrade-mode.html>`_
 
         :param enabled: When `true`, it enables `upgrade_mode` which temporarily halts
             all job and datafeed tasks and prohibits new job and datafeed tasks from
@@ -4109,12 +4278,21 @@ class MlClient(NamespacedClient):
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Starts a data frame analytics job.
+        Starts a data frame analytics job. A data frame analytics job can be started
+        and stopped multiple times throughout its lifecycle. If the destination index
+        does not exist, it is created automatically the first time you start the data
+        frame analytics job. The `index.number_of_shards` and `index.number_of_replicas`
+        settings for the destination index are copied from the source index. If there
+        are multiple source indices, the destination index copies the highest setting
+        values. The mappings for the destination index are also copied from the source
+        indices. If there are any mapping conflicts, the job fails to start. If the destination
+        index exists, it is used as is. You can therefore set up the destination index
+        in advance with custom settings and mappings.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/start-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/start-dfanalytics.html>`_
 
         :param id: Identifier for the data frame analytics job. This identifier can contain
             lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores.
@@ -4160,13 +4338,23 @@ class MlClient(NamespacedClient):
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
         start: t.Optional[t.Union[str, t.Any]] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        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]:
         """
-        Starts one or more datafeeds.
+        Starts one or more datafeeds. A datafeed must be started in order to retrieve
+        data from Elasticsearch. A datafeed can be started and stopped multiple times
+        throughout its lifecycle. Before you can start a datafeed, the anomaly detection
+        job must be open. Otherwise, an error occurs. If you restart a stopped datafeed,
+        it continues processing input data from the next millisecond after it was stopped.
+        If new data was indexed for that exact millisecond between stopping and starting,
+        it will be ignored. When Elasticsearch security features are enabled, your datafeed
+        remembers which roles the last user to create or update it had at the time of
+        creation or update and runs the query using those same roles. If you provided
+        secondary authorization headers when you created or updated the datafeed, those
+        credentials are used instead.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-start-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-start-datafeed.html>`_
 
         :param datafeed_id: A numerical character string that uniquely identifies the
             datafeed. This identifier can contain lowercase alphanumeric characters (a-z
@@ -4224,18 +4412,19 @@ class MlClient(NamespacedClient):
         human: t.Optional[bool] = None,
         number_of_allocations: t.Optional[int] = None,
         pretty: t.Optional[bool] = None,
-        priority: t.Optional[t.Union["t.Literal['low', 'normal']", str]] = None,
+        priority: t.Optional[t.Union[str, t.Literal["low", "normal"]]] = None,
         queue_capacity: t.Optional[int] = None,
         threads_per_allocation: t.Optional[int] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         wait_for: t.Optional[
-            t.Union["t.Literal['fully_allocated', 'started', 'starting']", str]
+            t.Union[str, t.Literal["fully_allocated", "started", "starting"]]
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Start a trained model deployment.
+        Starts a trained model deployment, which allocates the model to every machine
+        learning node.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/start-trained-model-deployment.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/start-trained-model-deployment.html>`_
 
         :param model_id: The unique identifier of the trained model. Currently, only
             PyTorch models are supported.
@@ -4313,12 +4502,13 @@ class MlClient(NamespacedClient):
         force: t.Optional[bool] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Stops one or more data frame analytics jobs.
+        Stops one or more data frame analytics jobs. A data frame analytics job can be
+        started and stopped multiple times throughout its lifecycle.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/stop-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/stop-dfanalytics.html>`_
 
         :param id: Identifier for the data frame analytics job. This identifier can contain
             lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores.
@@ -4377,13 +4567,15 @@ class MlClient(NamespacedClient):
         force: t.Optional[bool] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        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]:
         """
-        Stops one or more datafeeds.
+        Stops one or more datafeeds. A datafeed that is stopped ceases to retrieve data
+        from Elasticsearch. A datafeed can be started and stopped multiple times throughout
+        its lifecycle.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-stop-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-stop-datafeed.html>`_
 
         :param datafeed_id: Identifier for the datafeed. You can stop multiple datafeeds
             in a single API request by using a comma-separated list of datafeeds or a
@@ -4443,9 +4635,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Stop a trained model deployment.
+        Stops a trained model deployment.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/stop-trained-model-deployment.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/stop-trained-model-deployment.html>`_
 
         :param model_id: The unique identifier of the trained model.
         :param allow_no_match: Specifies what to do when the request: contains wildcard
@@ -4508,9 +4700,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Updates certain properties of a data frame analytics job.
+        Updates an existing data frame analytics job.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/update-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/update-dfanalytics.html>`_
 
         :param id: Identifier for the data frame analytics job. This identifier can contain
             lowercase alphanumeric characters (a-z and 0-9), hyphens, and underscores.
@@ -4592,13 +4784,13 @@ class MlClient(NamespacedClient):
         expand_wildcards: t.Optional[
             t.Union[
                 t.Sequence[
-                    t.Union["t.Literal['all', 'closed', 'hidden', 'none', 'open']", str]
+                    t.Union[str, t.Literal["all", "closed", "hidden", "none", "open"]]
                 ],
-                t.Union["t.Literal['all', 'closed', 'hidden', 'none', 'open']", str],
+                t.Union[str, t.Literal["all", "closed", "hidden", "none", "open"]],
             ]
         ] = None,
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
-        frequency: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        frequency: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         human: t.Optional[bool] = None,
         ignore_throttled: t.Optional[bool] = None,
         ignore_unavailable: t.Optional[bool] = None,
@@ -4609,16 +4801,20 @@ class MlClient(NamespacedClient):
         max_empty_searches: t.Optional[int] = None,
         pretty: t.Optional[bool] = None,
         query: t.Optional[t.Mapping[str, t.Any]] = None,
-        query_delay: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        query_delay: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = 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,
         scroll_size: t.Optional[int] = None,
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Updates certain properties of a datafeed.
+        Updates the properties of a datafeed. You must stop and start the datafeed for
+        the changes to be applied. When Elasticsearch security features are enabled,
+        your datafeed remembers which roles the user who updated it had at the time of
+        the update and runs the query using those same roles. If you provide secondary
+        authorization headers, those credentials are used instead.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-update-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-update-datafeed.html>`_
 
         :param datafeed_id: A numerical character string that uniquely identifies the
             datafeed. This identifier can contain lowercase alphanumeric characters (a-z
@@ -4779,9 +4975,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Updates the description of a filter, adds items, or removes items.
+        Updates the description of a filter, adds items, or removes items from the list.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-update-filter.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-update-filter.html>`_
 
         :param filter_id: A string that uniquely identifies a filter.
         :param add_items: The items to add to the filter.
@@ -4846,7 +5042,7 @@ class MlClient(NamespacedClient):
         allow_lazy_open: t.Optional[bool] = None,
         analysis_limits: t.Optional[t.Mapping[str, t.Any]] = None,
         background_persist_interval: t.Optional[
-            t.Union["t.Literal[-1]", "t.Literal[0]", str]
+            t.Union[str, t.Literal[-1], t.Literal[0]]
         ] = None,
         categorization_filters: t.Optional[t.Sequence[str]] = None,
         custom_settings: t.Optional[t.Mapping[str, t.Any]] = None,
@@ -4859,7 +5055,7 @@ class MlClient(NamespacedClient):
         human: t.Optional[bool] = None,
         model_plot_config: t.Optional[t.Mapping[str, t.Any]] = None,
         model_prune_window: t.Optional[
-            t.Union["t.Literal[-1]", "t.Literal[0]", str]
+            t.Union[str, t.Literal[-1], t.Literal[0]]
         ] = None,
         model_snapshot_retention_days: t.Optional[int] = None,
         per_partition_categorization: t.Optional[t.Mapping[str, t.Any]] = None,
@@ -4871,7 +5067,7 @@ class MlClient(NamespacedClient):
         """
         Updates certain properties of an anomaly detection job.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-update-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-update-job.html>`_
 
         :param job_id: Identifier for the job.
         :param allow_lazy_open: Advanced configuration option. Specifies whether this
@@ -4999,7 +5195,7 @@ class MlClient(NamespacedClient):
         """
         Updates certain properties of a snapshot.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-update-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-update-snapshot.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: Identifier for the model snapshot.
@@ -5058,9 +5254,10 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Updates certain properties of trained model deployment.
+        Starts a trained model deployment, which allocates the model to every machine
+        learning node.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/update-trained-model-deployment.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/update-trained-model-deployment.html>`_
 
         :param model_id: The unique identifier of the trained model. Currently, only
             PyTorch models are supported.
@@ -5088,7 +5285,11 @@ class MlClient(NamespacedClient):
         if not __body:
             if number_of_allocations is not None:
                 __body["number_of_allocations"] = number_of_allocations
-        __headers = {"accept": "application/json", "content-type": "application/json"}
+        if not __body:
+            __body = None  # type: ignore[assignment]
+        __headers = {"accept": "application/json"}
+        if __body is not None:
+            __headers["content-type"] = "application/json"
         return await self.perform_request(  # type: ignore[return-value]
             "POST",
             __path,
@@ -5109,13 +5310,19 @@ class MlClient(NamespacedClient):
         filter_path: t.Optional[t.Union[str, t.Sequence[str]]] = None,
         human: t.Optional[bool] = None,
         pretty: t.Optional[bool] = None,
-        timeout: t.Optional[t.Union["t.Literal[-1]", "t.Literal[0]", str]] = None,
+        timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
         wait_for_completion: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Upgrades a given job snapshot to the current major version.
+        Upgrades an anomaly detection model snapshot to the latest major version. Over
+        time, older snapshot formats are deprecated and removed. Anomaly detection jobs
+        support only snapshots that are from the current or previous major version. This
+        API provides a means to upgrade a snapshot to the current major version. This
+        aids in preparing the cluster for an upgrade to the next major version. Only
+        one snapshot per anomaly detection job can be upgraded at a time and the upgraded
+        snapshot cannot be the current snapshot of the anomaly detection job.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.14/ml-upgrade-job-model-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-upgrade-job-model-snapshot.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: A numerical character string that uniquely identifies the
@@ -5191,7 +5398,7 @@ class MlClient(NamespacedClient):
         """
         Validates an anomaly detection job.
 
-        `<https://www.elastic.co/guide/en/machine-learning/8.14/ml-jobs.html>`_
+        `<https://www.elastic.co/guide/en/machine-learning/8.15/ml-jobs.html>`_
 
         :param analysis_config:
         :param analysis_limits:
@@ -5261,7 +5468,7 @@ class MlClient(NamespacedClient):
         """
         Validates an anomaly detection detector.
 
-        `<https://www.elastic.co/guide/en/machine-learning/8.14/ml-jobs.html>`_
+        `<https://www.elastic.co/guide/en/machine-learning/8.15/ml-jobs.html>`_
 
         :param detector:
         """