Delete Model API
출처: 문서
본문
모델 삭제 API
model_id를 기준으로 모델을 삭제해요.
모델 그룹에서 마지막 모델 버전을 삭제하면 해당 모델 그룹은 인덱스에서 자동으로 삭제돼요. {: .important}
이 API의 사용자 접근에 대한 내용은 Model access control considerations을 참고하세요.
엔드포인트
DELETE /_plugins/_ml/models/{model_id}
요청 예제
DELETE /_plugins/_ml/models/MzcIJX8BA7mbufL6DOwl
{% include copy-curl.html %}
응답 예제
{
"_index" : ".plugins-ml-model",
"_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": "status_exception",
"reason": "Failed to find model"
}
],
"type": "status_exception",
"reason": "Failed to find model"
},
"status": 404
}
모델을 안전하게 삭제하기
Introduced 2.19 {: .label .label-purple }
에이전트, 검색 파이프라인, 인제스트 파이프라인 또는 기타 컴포넌트에서 활발히 사용 중인 모델이 실수로 삭제되는 것을 방지하려면 안전 검사를 활성화할 수 있어요. 안전 검사가 활성화된 상태에서 현재 사용 중인 모델을 삭제하려고 하면 OpenSearch가 오류 메시지를 반환해요. 삭제를 계속 진행하려면:
- 모델을 사용 중인 컴포넌트를 파악해서, 해당 컴포넌트를 삭제하거나 다른 모델을 사용하도록 수정해요.
- 모든 의존성이 정리되면 모델을 삭제해요.
이 기능을 활성화하는 방법은 Feature settings을 참고하세요.