Delete Controller API
출처: 문서
본문
컨트롤러 삭제 API
2.12에 도입됨 {: .label .label-purple }
이 API를 사용하면 model_id를 기준으로 모델의 컨트롤러를 삭제할 수 있어요.
엔드포인트
DELETE /_plugins/_ml/controllers/{model_id}
경로 파라미터
사용 가능한 경로 파라미터는 다음 표에서 확인할 수 있어요.
| 파라미터 | 데이터 타입 | 설명 |
|---|---|---|
model_id |
String | 컨트롤러를 삭제하려는 모델의 모델 ID예요. |
요청 예제
DELETE /_plugins/_ml/controllers/MzcIJX8BA7mbufL6DOwl
{% include copy-curl.html %}
응답 예제
{
"_index" : ".plugins-ml-controller",
"_id" : "MzcIJX8BA7mbufL6DOwl",
"_version" : 2,
"result" : "deleted",
"_shards" : {
"total" : 2,
"successful" : 2,
"failed" : 0
},
"_seq_no" : 27,
"_primary_term" : 18
}
오류 응답
컨트롤러 인덱스가 존재하지 않는 상태에서 컨트롤러를 삭제하려고 하면 OpenSearch는 404 Not Found 오류를 반환해요:
{
"error": {
"root_cause": [
{
"type": "index_not_found_exception",
"reason": "no such index [.plugins-ml-controller]",
"index": ".plugins-ml-controller",
"resource.id": ".plugins-ml-controller",
"resource.type": "index_expression",
"index_uuid": "_na_"
}
],
"type": "index_not_found_exception",
"reason": "no such index [.plugins-ml-controller]",
"index": ".plugins-ml-controller",
"resource.id": ".plugins-ml-controller",
"resource.type": "index_expression",
"index_uuid": "_na_"
},
"status": 404
}
필수 권한
Security 플러그인을 사용한다면 적절한 권한을 갖추고 있어야 해요: cluster:admin/opensearch/ml/controllers/delete.