IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Create trained models API Delete trained models API »
Elastic Docs ›Elasticsearch Guide [7.16] ›REST APIs ›Machine learning trained model APIs

Delete trained model aliases API

edit

Delete trained model aliases API

edit

Deletes a trained model alias.

Request

edit

DELETE _ml/trained_models/<model_id>/model_aliases/<model_alias>

Prerequisites

edit

Requires the manage_ml cluster privilege. This privilege is included in the machine_learning_admin built-in role.

Description

edit

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.

Path parameters

edit
model_alias
(Required, string) The model alias to delete.
model_id
(Required, string) The trained model ID to which the model alias refers.

Examples

edit

The following example shows how to delete a model alias (flight_delay_model) for a trained model ID (flight-delay-prediction-1574775339910):

DELETE _ml/trained_models/flight-delay-prediction-1574775339910/model_aliases/flight_delay_model
« Create trained models API Delete trained models API »