MLflow:Rest
MLflow REST API를 사용하면 실험 및 실행을 생성, 나열 및 조회하고, 매개변수, 메트릭 및 아티팩트를 로깅할 수 있습니다.
API Path
이 API는 MLflow 추적 서버의 /api 경로에서 호스팅됩니다.
예를 들어, http://localhost:5000 에서 호스팅되는 추적 서버에서 실험을 검색하려면 http://localhost:5000/api/2.0/mlflow/experiments/search 로 POST 요청을 보냅니다.
| INFORMATION |
| MLflow REST API는 모든 POST 요청에 대해 |
API List
- #Create Experiment - 이름으로 실험을 생성하고 새 실험 ID를 반환합니다.
- #Search Experiments - 실험을 검색합니다. 필터, 정렬, 페이지네이션을 지원합니다.
- #Get Experiment - 실험의 메타데이터를 조회합니다. 삭제된 실험에서도 동작합니다.
- #Get Experiment By Name - 이름으로 실험의 메타데이터를 조회합니다.
- #Delete Experiment - 실험과 관련 메타데이터, 실행, 메트릭, 파라미터, 태그를 삭제 표시합니다.
- #Restore Experiment - 삭제 표시된 실험과 관련 메타데이터를 복원합니다.
- #Update Experiment - 실험 메타데이터를 업데이트합니다.
- #Set Experiment Tag - 실험에 태그를 설정합니다. 태그는 실행과 무관한 메타데이터입니다.
- #Delete Experiment Tag - 실험의 태그를 삭제합니다.
- #Create Run - 실험 내에 새 실행을 생성합니다. ML 또는 ETL 파이프라인의 단일 실행 단위입니다.
- #Update Run - 실행 메타데이터를 업데이트합니다.
- #Delete Run - 실행을 삭제 표시합니다.
- #Restore Run - 삭제된 실행을 복원합니다.
- #Get Run - 실행의 메타데이터, 메트릭, 파라미터, 태그를 조회합니다.
- #Search Runs - 메트릭/파라미터 조건으로 실행을 검색합니다.
- #Log Metric - 실행에 메트릭(문자열 키, 실수 값, 타임스탬프)을 기록합니다.
- #Log Param - 실행에 파라미터(문자열 키-값 쌍)를 기록합니다. 실행당 한 번만 기록 가능합니다.
- #Log Batch - 실행에 메트릭, 파라미터, 태그를 일괄 기록합니다.
- #Log Model - [실험적] 실행에 모델을 기록합니다.
- #Log Inputs - 실행에 데이터셋 입력을 기록합니다.
- #Set Tag - 실행에 태그를 설정합니다. 실행 중/완료 후 업데이트 가능합니다.
- #Delete Tag - 실행의 태그를 삭제합니다.
- #Get Metric History - 특정 실행의 지정된 메트릭에 대한 모든 값 목록을 조회합니다.
- #List Artifacts - 실행의 아티팩트를 나열합니다. 경로 접두사로 필터링 가능합니다.
- #Register Scorer - 실험에 스코어러를 등록합니다.
- #List Scorers - 실험의 모든 스코어러를 나열합니다.
- #List Scorer Versions - 특정 스코어러의 모든 버전을 나열합니다.
- #Get Scorer - 실험의 특정 스코어러를 조회합니다.
- #Delete Scorer - 실험의 스코어러를 삭제합니다.
- #Create Gateway Secret - LLM 공급자 인증을 위한 암호화된 시크릿을 생성합니다.
- #Get Gateway Secret Info - 시크릿의 메타데이터를 조회합니다 (암호화된 값 제외).
- #Update Gateway Secret - 기존 시크릿의 값 또는 인증 설정을 업데이트합니다.
- #Delete Gateway Secret - 시크릿을 삭제합니다.
- #List Gateway Secrets - 모든 시크릿을 나열합니다. 공급자별 필터링을 지원합니다.
- #Create Gateway Model Definition - 재사용 가능한 모델 정의를 생성합니다.
- #Get Gateway Model Definition - ID로 모델 정의를 조회합니다.
- #List Gateway Model Definitions - 모든 모델 정의를 나열합니다. 필터 옵션을 지원합니다.
- #Update Gateway Model Definition - 모델 정의를 업데이트합니다.
- #Delete Gateway Model Definition - 모델 정의를 삭제합니다 (엔드포인트에서 사용 중이면 실패).
- #Create Gateway Endpoint - 모델 설정이 포함된 새 엔드포인트를 생성합니다.
- #Get Gateway Endpoint - 모든 모델 설정을 포함한 엔드포인트 상세 정보를 조회합니다.
- #Update Gateway Endpoint - 엔드포인트의 이름을 업데이트합니다.
- #Delete Gateway Endpoint - 엔드포인트와 모든 모델 설정을 삭제합니다.
- #List Gateway Endpoints - 엔드포인트를 나열합니다. 공급자/시크릿별 필터링을 지원합니다.
- #Attach Model to Endpoint - 기존 모델 정의를 엔드포인트에 연결합니다.
- #Detach Model from Endpoint - 엔드포인트에서 모델 정의를 분리합니다 (모델 정의는 삭제되지 않음).
- #Create Endpoint Binding - 엔드포인트와 MLflow 리소스 간 바인딩을 생성합니다.
- #Delete Endpoint Binding - 엔드포인트와 리소스 간 바인딩을 삭제합니다.
- #List Endpoint Bindings - 엔드포인트의 모든 바인딩을 나열합니다.
- #Gateway Set Endpoint Tag - 엔드포인트에 태그를 설정합니다.
- #Gateway Delete Endpoint Tag - 엔드포인트의 태그를 삭제합니다.
- #Create Prompt Optimization Job - 새 프롬프트 최적화 작업을 생성하고 최적화 실행을 시작합니다.
- #Get Prompt Optimization Job - 프롬프트 최적화 작업의 상세 정보와 상태를 조회합니다.
- #Search Prompt Optimization Jobs - 필터 조건에 맞는 프롬프트 최적화 작업을 검색합니다.
- #Cancel Prompt Optimization Job - 진행 중인 프롬프트 최적화 작업을 취소합니다.
- #Delete Prompt Optimization Job - 프롬프트 최적화 작업과 관련 데이터를 영구 삭제합니다.
- #Create Budget Policy - 새 예산 정책을 생성합니다.
- #Get Budget Policy - ID로 예산 정책을 조회합니다.
- #Update Budget Policy - 예산 정책을 업데이트합니다.
- #Delete Budget Policy - 예산 정책을 삭제합니다.
- #List Budget Policies - 예산 정책을 나열합니다.
- #List Budget Windows - 현재 지출 정보와 함께 예산 윈도우를 나열합니다.
- #Create RegisteredModel - 등록 모델을 생성합니다. 동일 이름이 이미 있으면 실패합니다.
- #Get RegisteredModel - 등록 모델의 상세 정보를 조회합니다.
- #Rename RegisteredModel - 등록 모델의 이름을 변경합니다.
- #Update RegisteredModel - 등록 모델의 설명 등 메타데이터를 업데이트합니다.
- #Delete RegisteredModel - 등록 모델을 삭제합니다.
- #Search RegisteredModels - 등록 모델을 검색합니다. 필터, 정렬, 페이지네이션을 지원합니다.
- #Get Latest ModelVersions - 등록 모델의 최신 모델 버전을 조회합니다. 스테이지별 필터링을 지원합니다.
- #Create ModelVersion - 새 모델 버전을 생성합니다.
- #Get ModelVersion - 모델 버전의 상세 정보를 조회합니다.
- #Update ModelVersion - 모델 버전의 설명을 업데이트합니다.
- #Delete ModelVersion - 모델 버전을 삭제합니다.
- #Search ModelVersions - 모델 버전을 검색합니다. 필터, 정렬, 페이지네이션을 지원합니다.
- #Get Download URI For ModelVersion Artifacts - 모델 버전 아티팩트의 다운로드 URI를 조회합니다.
- #Transition ModelVersion Stage - 모델 버전의 스테이지를 전환합니다 (예: Staging → Production).
- #Set Registered Model Tag - 등록 모델에 태그를 설정합니다.
- #Set Model Version Tag - 모델 버전에 태그를 설정합니다.
- #Delete Registered Model Tag - 등록 모델의 태그를 삭제합니다.
- #Delete Model Version Tag - 모델 버전의 태그를 삭제합니다.
- #Set Registered Model Alias - 등록 모델에 별칭을 설정합니다.
- #Delete Registered Model Alias - 등록 모델의 별칭을 삭제합니다.
- #Get Model Version by Alias - 별칭으로 모델 버전을 조회합니다.
- #Create Webhook - 웹훅을 생성합니다.
- #List Webhooks - 웹훅 목록을 조회합니다.
- #Get Webhook - 웹훅의 상세 정보를 조회합니다.
- #Update Webhook - 웹훅을 업데이트합니다.
- #Delete Webhook - 웹훅을 삭제합니다.
- #Test Webhook - 웹훅을 테스트합니다.
- #Download Artifact - 아티팩트를 다운로드합니다.
- #Upload Artifact - 아티팩트를 업로드합니다.
- #List Artifacts - 아티팩트를 나열합니다.
- #Delete Artifacts - 아티팩트를 삭제합니다.
- #Create an Artifact Multipart Upload - 아티팩트 멀티파트 업로드를 생성합니다.
- #Complete an Artifact Multipart Upload - 아티팩트 멀티파트 업로드를 완료합니다.
- #Abort an Artifact Multipart Upload - 아티팩트 멀티파트 업로드를 중단합니다.
- #Get Presigned URL for Multipart Download - 멀티파트 다운로드용 사전 서명 URL을 조회합니다.
- #Data Structures - API에서 사용되는 데이터 구조 정의 (Experiment, Run, Metric, Param, ModelVersion 등).