Get ML Task API

원문 보기 위키 갱신 2026.10.14

출처: 문서

본문

ML 태스크 API 조회

task_id를 사용하여 머신러닝(ML) 태스크(모델 훈련, 배포, 예측 태스크 등)에 대한 정보를 조회할 수 있습니다.

이 API는 일반 OpenSearch 작업을 추적하고 응답 형식이 다른 일반 태스크 API와 다릅니다. {: .important }

엔드포인트

GET /_plugins/_ml/tasks/{task_id}

예제 요청

GET /_plugins/_ml/tasks/MsBi1YsB0jLkkocYjD5f

{% include copy-curl.html %}

예제 응답

응답 형식은 태스크 상태에 따라 다릅니다. 다양한 ML 작업(예: 모델 훈련, 배포, 등록)은 현재 상태에 따라 다른 응답 형식을 반환합니다.

진행 중인 태스크

태스크가 아직 실행 중인 경우 응답에는 태스크 세부 정보가 포함되지만 model_id는 제외됩니다:

{
  "task_type": "DEPLOY_MODEL",
  "function_name": "TEXT_EMBEDDING",
  "state": "CREATED",
  "worker_node": ["KfEEGG7_SsKZVFqI4ko2FA"],
  "create_time": 1767030135146,
  "last_update_time": 1767030135771,
  "is_async": true
}

완료된 태스크

태스크가 성공적으로 완료되면 응답에 model_id와 전체 태스크 세부 정보가 포함됩니다:

모델 배포 태스크:

{
  "model_id": "Qr1YbogBYOqeeqR7sI9L",
  "task_type": "DEPLOY_MODEL",
  "function_name": "TEXT_EMBEDDING",
  "state": "COMPLETED",
  "worker_node": [
    "N77RInqjTSq_UaLh1k0BUg"
  ],
  "create_time": 1685478486057,
  "last_update_time": 1685478491090,
  "is_async": true
}

모델 등록 태스크:

{
  "model_id": "aVeif4oB5Vm0Tdw8zYO2",
  "task_type": "REGISTER_MODEL",
  "function_name": "TEXT_EMBEDDING",
  "state": "COMPLETED",
  "worker_node": [
    "4p6FVOmJRtu3wehDD74hzQ"
  ],
  "create_time": 1694358489722,
  "last_update_time": 1694358499139,
  "is_async": true
}

모델 훈련 태스크:

{
  "model_id" : "l7lamX8BO5w8y8Ra2oty",
  "task_type" : "TRAINING",
  "function_name" : "KMEANS",
  "state" : "COMPLETED",
  "input_type" : "SEARCH_QUERY",
  "worker_node" : "54xOe0w8Qjyze00UuLDfdA",
  "create_time" : 1647545342556,
  "last_update_time" : 1647545342587,
  "is_async" : true
}

응답 필드

다음 표는 모든 응답 본문 필드를 나열합니다.

필드	데이터 타입	설명
`model_id`	String	ML 모델의 고유 식별자입니다. 태스크가 완료되면 사용할 수 있습니다.
`task_type`	String	ML 작업 유형입니다(예: `REGISTER_MODEL`, `DEPLOY_MODEL`, `TRAINING`).
`function_name`	String	ML 함수 유형입니다(예: `TEXT_EMBEDDING`, `KMEANS`).
`state`	String	현재 태스크 상태입니다. 유효한 값은 `CREATED`(태스크 생성됨), `RUNNING`(태스크 활성 실행 중), `COMPLETED`(태스크 성공적으로 완료됨), `FAILED`(태스크 오류 발생), `CANCELLED`(태스크 취소됨), `COMPLETED_WITH_ERROR`(태스크 오류와 함께 완료됨), `CANCELLING`(태스크 취소 중), `EXPIRED`(태스크 만료됨), `UNREACHABLE`(태스크 노드에 연결할 수 없음)입니다.
`worker_node`	Array	태스크가 실행 중인 노드의 노드 ID 배열입니다.
`create_time`	Long	태스크가 생성된 타임스탬프(에포크 이후 밀리초)입니다.
`last_update_time`	Long	마지막 상태 업데이트의 타임스탬프(에포크 이후 밀리초)입니다.
`is_async`	Boolean	태스크가 비동기적으로 실행되는지 여부입니다. 일반적으로 ML 태스크의 경우 `true`입니다.
`input_type`	String	훈련 태스크의 입력 유형입니다(예: `SEARCH_QUERY`).

더 알아보기 (Learn more)

원문 전체: https://docs.opensearch.org/latest/ml-commons-plugin/api/tasks-apis/get-task/