You're viewing version 2.16 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Delete a controller
Introduced 2.12
Use this API to delete a controller for a model based on the model_id
.
Path and HTTP methods
DELETE /_plugins/_ml/controllers/<model_id>
Path parameters
The following table lists the available path parameters.
Parameter | Data type | Description |
---|---|---|
model_id | String | The model ID of the model for which to delete the controller. |
Example request
DELETE /_plugins/_ml/controllers/MzcIJX8BA7mbufL6DOwl
Example response
{
"_index" : ".plugins-ml-controller",
"_id" : "MzcIJX8BA7mbufL6DOwl",
"_version" : 2,
"result" : "deleted",
"_shards" : {
"total" : 2,
"successful" : 2,
"failed" : 0
},
"_seq_no" : 27,
"_primary_term" : 18
}
Required permissions
If you use the Security plugin, make sure you have the appropriate permissions: cluster:admin/opensearch/ml/controllers/delete
.