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

elasticsearch/_sync/client/ml.py

@@ -36,13 +36,13 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Clear trained model deployment cache. Cache will be cleared 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.15/clear-trained-model-deployment-cache.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/clear-trained-model-deployment-cache.html>`_
 
         :param model_id: The unique identifier of the trained model.
         """
@@ -88,7 +88,7 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Close anomaly detection jobs A job can be opened and closed multiple times throughout
+        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
@@ -102,7 +102,7 @@ class MlClient(NamespacedClient):
         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>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -161,9 +161,10 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Removes all scheduled events from a calendar, then deletes it.
+        Delete a calendar. Removes all scheduled events from a calendar, then deletes
+        it.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-calendar.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-delete-calendar.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar.
         """
@@ -202,9 +203,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes scheduled events from a calendar.
+        Delete events from a calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-calendar-event.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -250,9 +251,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes anomaly detection jobs from a calendar.
+        Delete anomaly jobs from a calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-calendar-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -299,9 +300,9 @@ class MlClient(NamespacedClient):
         timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes a data frame analytics job.
+        Delete a data frame analytics job.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/delete-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -347,9 +348,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes an existing datafeed.
+        Delete a datafeed.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-delete-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -399,15 +400,15 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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>.
+        Delete expired ML 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.15/ml-delete-expired-data.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -464,11 +465,11 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes a filter. If an anomaly detection job references the filter, you cannot
+        Delete 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.15/ml-delete-filter.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-delete-filter.html>`_
 
         :param filter_id: A string that uniquely identifies a filter.
         """
@@ -509,12 +510,12 @@ class MlClient(NamespacedClient):
         timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Delete forecasts from a 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.15/ml-delete-forecast.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -579,14 +580,14 @@ class MlClient(NamespacedClient):
         wait_for_completion: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes an anomaly detection job. All job configuration, model state and results
+        Delete 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.15/ml-delete-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-delete-job.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param delete_user_annotations: Specifies whether annotations that have been
@@ -638,12 +639,11 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Delete a 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.15/ml-delete-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-delete-snapshot.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: Identifier for the model snapshot.
@@ -688,10 +688,10 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Deletes an existing trained inference model that is currently not referenced
-        by an ingest pipeline.
+        Delete an unreferenced trained model. The request deletes a trained inference
+        model that is not referenced by an ingest pipeline.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/delete-trained-models.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -734,11 +734,11 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Delete 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.15/delete-trained-models-aliases.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -791,11 +791,11 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Estimate job model memory usage. 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.15/ml-apis.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -858,12 +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. 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.
+        Evaluate data frame analytics. 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.15/evaluate-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -935,15 +935,15 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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
+        Explain 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.15/explain-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -1041,16 +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. 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.
+        Force buffered data to be processed. 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.15/ml-flush-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -1116,12 +1116,12 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> 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.
+        Predict future behavior of a time series. 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. Forcasts predict
+        future behavior based on historical data.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-forecast.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -1201,10 +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. The API presents
-        a chronological view of the records, grouped by bucket.
+        Get anomaly detection job results for buckets. The API presents a chronological
+        view of the records, grouped by bucket.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-bucket.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -1297,9 +1297,9 @@ class MlClient(NamespacedClient):
         start: t.Optional[t.Union[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves information about the scheduled events in calendars.
+        Get info about events in calendars.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-calendar-event.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -1363,9 +1363,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves configuration information for calendars.
+        Get calendar configuration info.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-calendar.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -1436,9 +1436,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves anomaly detection job results for one or more categories.
+        Get anomaly detection job results for categories.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-category.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -1518,11 +1518,11 @@ class MlClient(NamespacedClient):
         size: t.Optional[int] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Get data frame analytics job configuration info. 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.15/get-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -1592,9 +1592,9 @@ class MlClient(NamespacedClient):
         verbose: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves usage information for data frame analytics jobs.
+        Get data frame analytics jobs usage info.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/get-dfanalytics-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -1657,14 +1657,14 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Get datafeeds usage info. 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.15/ml-get-datafeed-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -1718,13 +1718,13 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Get datafeeds configuration info. 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.15/ml-get-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -1785,9 +1785,9 @@ class MlClient(NamespacedClient):
         size: t.Optional[int] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves filters. You can get a single filter or all filters.
+        Get filters. You can get a single filter or all filters.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-filter.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-get-filter.html>`_
 
         :param filter_id: A string that uniquely identifies a filter.
         :param from_: Skips the specified number of filters.
@@ -1847,12 +1847,11 @@ 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. 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.
+        Get anomaly detection job results for 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.15/ml-get-influencer.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-get-influencer.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param desc: If true, the results are sorted in descending order.
@@ -1931,9 +1930,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves usage information for anomaly detection jobs.
+        Get anomaly detection jobs usage info.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-job-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -1988,13 +1987,13 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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>`.
+        Get anomaly detection jobs configuration info. 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.15/ml-get-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -2053,11 +2052,11 @@ class MlClient(NamespacedClient):
         timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Get machine learning memory usage info. 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.15/get-ml-memory.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/get-ml-memory.html>`_
 
         :param node_id: The names of particular nodes in the cluster to target. For example,
             `nodeId1,nodeId2` or `ml:true`
@@ -2110,9 +2109,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves usage information for anomaly detection job model snapshot upgrades.
+        Get anomaly detection job model snapshot upgrade usage info.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-job-model-snapshot-upgrade-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -2181,9 +2180,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves information about model snapshots.
+        Get model snapshots info.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-get-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-get-snapshot.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: A numerical character string that uniquely identifies the
@@ -2282,21 +2281,21 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves overall bucket results that summarize the bucket results of multiple
-        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>`_
+        Get overall bucket results. Retrievs overall bucket results that summarize the
+        bucket results of multiple 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.16/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.
@@ -2391,7 +2390,7 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves anomaly records for an anomaly detection job. Records contain the detailed
+        Get 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,
@@ -2401,7 +2400,7 @@ class MlClient(NamespacedClient):
         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.15/ml-get-record.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-get-record.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param desc: Refer to the description for the `desc` query parameter.
@@ -2494,9 +2493,9 @@ class MlClient(NamespacedClient):
         tags: t.Optional[t.Union[str, t.Sequence[str]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Retrieves configuration information for a trained model.
+        Get trained model configuration info.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/get-trained-models.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/get-trained-models.html>`_
 
         :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
@@ -2576,11 +2575,11 @@ class MlClient(NamespacedClient):
         size: t.Optional[int] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Get trained models usage info. 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.15/get-trained-models-stats.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -2641,9 +2640,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Evaluates a trained model.
+        Evaluate a trained model.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/infer-trained-model.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -2698,14 +2697,14 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Return ML defaults and limits. 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.15/get-ml-info.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/get-ml-info.html>`_
         """
         __path_parts: t.Dict[str, str] = {}
         __path = "/_ml/info"
@@ -2743,14 +2742,14 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Open anomaly detection jobs. An anomaly detection job must be opened 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.15/ml-open-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-open-job.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param timeout: Refer to the description for the `timeout` query parameter.
@@ -2802,9 +2801,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Adds scheduled events to a calendar.
+        Add scheduled events to the calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-post-calendar-event.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -2858,11 +2857,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. IMPORTANT: For each job,
+        Send 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.15/ml-post-data.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -2923,9 +2922,10 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Previews the extracted features used by a data frame analytics config.
+        Preview features used by data frame analytics. Previews the extracted features
+        used by a data frame analytics config.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/preview-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -2985,7 +2985,7 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Previews a datafeed. This API returns the first "page" of search results from
+        Preview 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
@@ -2995,7 +2995,7 @@ class MlClient(NamespacedClient):
         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.15/ml-preview-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -3069,9 +3069,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates a calendar.
+        Create a calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-put-calendar.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-put-calendar.html>`_
 
         :param calendar_id: A string that uniquely identifies a calendar.
         :param description: A description of the calendar.
@@ -3123,9 +3123,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Adds an anomaly detection job to a calendar.
+        Add anomaly detection job to calendar.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-put-calendar-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -3195,11 +3195,11 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Create 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.15/put-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -3365,8 +3365,8 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Instantiates a datafeed. Datafeeds retrieve data from Elasticsearch for analysis
-        by an anomaly detection job. You can associate only one datafeed with each anomaly
+        Create 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
@@ -3377,7 +3377,7 @@ class MlClient(NamespacedClient):
         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.15/ml-put-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -3528,11 +3528,11 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Create 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.15/ml-put-filter.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-put-filter.html>`_
 
         :param filter_id: A string that uniquely identifies a filter.
         :param description: A description of the filter.
@@ -3616,10 +3616,10 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Instantiates an anomaly detection job. If you include a `datafeed_config`, you
-        must have read index privileges on the source index.
+        Create 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.15/ml-put-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -3797,9 +3797,10 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Enables you to supply a trained model that is not created by data frame analytics.
+        Create a trained model. Enable you to supply a trained model that is not created
+        by data frame analytics.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/put-trained-models.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/put-trained-models.html>`_
 
         :param model_id: The unique identifier of the trained model.
         :param compressed_definition: The compressed (GZipped and Base64 encoded) inference
@@ -3899,21 +3900,21 @@ class MlClient(NamespacedClient):
         reassign: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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
+        Create or update 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>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -3969,9 +3970,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates part of a trained model definition.
+        Create part of a trained model definition.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/put-trained-model-definition-part.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -4046,11 +4047,11 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Creates a trained model vocabulary. This API is supported only for natural language
+        Create 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.15/put-trained-model-vocabulary.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -4104,11 +4105,11 @@ class MlClient(NamespacedClient):
         wait_for_completion: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Resets an anomaly detection job. All model state and results are deleted. The
+        Reset 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.15/ml-reset-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-reset-job.html>`_
 
         :param job_id: The ID of the job to reset.
         :param delete_user_annotations: Specifies whether annotations that have been
@@ -4160,15 +4161,15 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Revert to a 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.15/ml-revert-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -4226,18 +4227,19 @@ class MlClient(NamespacedClient):
         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. 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.
+        Set upgrade_mode for ML indices. Sets a cluster wide upgrade_mode setting that
+        prepares machine learning indices 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>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -4281,18 +4283,18 @@ class MlClient(NamespacedClient):
         timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Start 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.15/start-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -4342,19 +4344,19 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Start 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.15/ml-start-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -4421,10 +4423,10 @@ class MlClient(NamespacedClient):
         ] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Starts a trained model deployment, which allocates the model to every machine
-        learning node.
+        Start a trained model deployment. It allocates the model to every machine learning
+        node.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/start-trained-model-deployment.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/start-trained-model-deployment.html>`_
 
         :param model_id: The unique identifier of the trained model. Currently, only
             PyTorch models are supported.
@@ -4505,10 +4507,10 @@ class MlClient(NamespacedClient):
         timeout: t.Optional[t.Union[str, t.Literal[-1], t.Literal[0]]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Stops one or more data frame analytics jobs. A data frame analytics job can be
-        started and stopped multiple times throughout its lifecycle.
+        Stop 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.15/stop-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -4571,11 +4573,10 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Stop 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.15/ml-stop-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -4635,9 +4636,9 @@ class MlClient(NamespacedClient):
         pretty: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Stops a trained model deployment.
+        Stop a trained model deployment.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/stop-trained-model-deployment.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -4700,9 +4701,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Updates an existing data frame analytics job.
+        Update a data frame analytics job.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/update-dfanalytics.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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.
@@ -4808,13 +4809,13 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Update 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.15/ml-update-datafeed.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -4975,9 +4976,10 @@ 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 from the list.
+        Update a filter. Updates the description of a filter, adds items, or removes
+        items from the list.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-update-filter.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-update-filter.html>`_
 
         :param filter_id: A string that uniquely identifies a filter.
         :param add_items: The items to add to the filter.
@@ -5065,9 +5067,10 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Updates certain properties of an anomaly detection job.
+        Update an anomaly detection job. Updates certain properties of an anomaly detection
+        job.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-update-job.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-update-job.html>`_
 
         :param job_id: Identifier for the job.
         :param allow_lazy_open: Advanced configuration option. Specifies whether this
@@ -5193,9 +5196,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Updates certain properties of a snapshot.
+        Update a snapshot. Updates certain properties of a snapshot.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/ml-update-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/ml-update-snapshot.html>`_
 
         :param job_id: Identifier for the anomaly detection job.
         :param snapshot_id: Identifier for the model snapshot.
@@ -5254,10 +5257,9 @@ class MlClient(NamespacedClient):
         body: t.Optional[t.Dict[str, t.Any]] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        Starts a trained model deployment, which allocates the model to every machine
-        learning node.
+        Update a trained model deployment.
 
-        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.15/update-trained-model-deployment.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/update-trained-model-deployment.html>`_
 
         :param model_id: The unique identifier of the trained model. Currently, only
             PyTorch models are supported.
@@ -5314,15 +5316,16 @@ class MlClient(NamespacedClient):
         wait_for_completion: t.Optional[bool] = None,
     ) -> ObjectApiResponse[t.Any]:
         """
-        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.
+        Upgrade a snapshot. 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.15/ml-upgrade-job-model-snapshot.html>`_
+        `<https://www.elastic.co/guide/en/elasticsearch/reference/8.16/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
@@ -5398,7 +5401,7 @@ class MlClient(NamespacedClient):
         """
         Validates an anomaly detection job.
 
-        `<https://www.elastic.co/guide/en/machine-learning/8.15/ml-jobs.html>`_
+        `<https://www.elastic.co/guide/en/machine-learning/8.16/ml-jobs.html>`_
 
         :param analysis_config:
         :param analysis_limits:
@@ -5468,7 +5471,7 @@ class MlClient(NamespacedClient):
         """
         Validates an anomaly detection detector.
 
-        `<https://www.elastic.co/guide/en/machine-learning/8.15/ml-jobs.html>`_
+        `<https://www.elastic.co/guide/en/machine-learning/8.16/ml-jobs.html>`_
 
         :param detector:
         """