You are looking at preliminary documentation for a future release. Not what you want? See the current release documentation.
Elastic Docs ›Elasticsearch Guide [master] ›REST APIs ›Machine learning trained model APIs
« Create trained model vocabulary API Delete trained models API »

Delete trained model aliases APIedit

Deletes a trained model alias.

Requestedit

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

Prerequisitesedit

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

Descriptionedit

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 parametersedit

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

Examplesedit

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

resp = client.ml.delete_trained_model_alias(
    model_id="flight-delay-prediction-1574775339910",
    model_alias="flight_delay_model",
)
print(resp)
response = client.ml.delete_trained_model_alias(
  model_id: 'flight-delay-prediction-1574775339910',
  model_alias: 'flight_delay_model'
)
puts response
DELETE _ml/trained_models/flight-delay-prediction-1574775339910/model_aliases/flight_delay_model
« Create trained model vocabulary API Delete trained models API »