Delete Memory Container API

출처: 문서

본문

메모리 컨테이너 삭제 API

3.3에 도입됨 {: .label .label-purple }

이 API를 사용하면 ID로 메모리 컨테이너를 삭제할 수 있어요.

엔드포인트

DELETE /_plugins/_ml/memory_containers/{memory_container_id}

경로 파라미터

사용할 수 있는 경로 파라미터는 다음 표에 정리되어 있어요.

쿼리 파라미터

사용할 수 있는 쿼리 파라미터는 다음 표에 정리되어 있어요.

요청 예시: 기본 삭제 (메모리 인덱스 유지)

DELETE /_plugins/_ml/memory_containers/SdjmmpgBOh0h20Y9kWuN

요청 예시: 컨테이너와 모든 메모리 인덱스 삭제

DELETE /_plugins/_ml/memory_containers/SdjmmpgBOh0h20Y9kWuN?delete_all_memories=true

요청 예시: 컨테이너와 특정 메모리 타입 삭제

DELETE /_plugins/_ml/memory_containers/SdjmmpgBOh0h20Y9kWuN?delete_memories=sessions,working

{% include copy-curl.html %}

응답 예시

{
    "_index": ".plugins-ml-memory-container",
    "_id": "SdjmmpgBOh0h20Y9kWuN",
    "_version": 3,
    "result": "deleted",
    "forced_refresh": true,
    "_shards": {
        "total": 2,
        "successful": 2,
        "failed": 0
    },
    "_seq_no": 6,
    "_primary_term": 1
}

오류 응답

존재하지 않는 메모리 컨테이너를 삭제하려고 하면 OpenSearch가 404 Not Found 오류를 반환해요:

{
  "error": {
    "root_cause": [
      {
        "type": "status_exception",
        "reason": "Memory container not found"
      }
    ],
    "type": "status_exception",
    "reason": "Memory container not found"
  },
  "status": 404
}

응답 필드

다음 표에서 응답 본문의 모든 필드를 확인할 수 있어요.

더 알아보기 (Learn more)

• 원문 전체: https://docs.opensearch.org/latest/ml-commons-plugin/api/agentic-memory-apis/delete-memory-container/