English

datasets

datasets API, 엔드포인트 20개 (자동 생성)

데이터셋 매니페스트: 카탈로그, 샘플 미리보기, 계보(lineage) 사용 현황 및 수집(ingest).

GET /api/v1/datasets

GET/api/v1/datasets

데이터셋 목록

호출자 테넌트의 카탈로그 데이터셋을 조회합니다 (화면 9).

필요 권한: VIEW

파라미터

이름위치형식필수설명
sourcequerystring?
statusquerystring?
external_sourcequerystring?이 외부 소스에 연결된 데이터셋만 (소스 id)
pagequeryinteger
page_sizequeryinteger?
qquerystring?이름 부분 일치 검색
sortquerystring?정렬 키
orderquerystringasc | desc

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets

POST/api/v1/datasets

데이터셋 수집

DataOps가 넘겨준 데이터셋 매니페스트를 수집합니다.

필요 권한: DATASET_WRITE

요청 본문: application/json, DatasetCreate

필드형식필수설명
idstring✓Id
namestring✓Name
sourcestring?Source
schema_versionstring?Schema Version
record_countinteger?Record Count
size_bytesinteger?Size Bytes
formatstring?Format
key_fieldsobject[]Key Fields
storage_uristring?Storage Uri
validation_statusstringValidation Status
validationValidationBody?
variablesVariableBody[]Variables

응답

상태설명
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}

GET/api/v1/datasets/{dataset_id}

데이터셋 매니페스트 상세

단일 데이터셋의 전체 매니페스트 상세를 반환합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
dataset_idpathstring✓

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

PATCH /api/v1/datasets/{dataset_id}

PATCH/api/v1/datasets/{dataset_id}

데이터셋 정보 수정

데이터셋의 이름·소스·모달리티를 고칩니다 (D-9).

필요 권한: DATASET_WRITE

파라미터

이름위치형식필수설명
dataset_idpathstring✓

요청 본문: application/json, DatasetUpdate

필드형식필수설명
namestring?Name
sourcestring?Source
modalitystring?Modality

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/datasets/{dataset_id}

DELETE/api/v1/datasets/{dataset_id}

데이터셋 삭제

데이터셋과 업로드된 파일 전체를 삭제합니다.

필요 권한: DATASET_WRITE

파라미터

이름위치형식필수설명
dataset_idpathstring✓
forcequeryboolean

응답

상태설명
204Successful Response
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/sample

GET/api/v1/datasets/{dataset_id}/sample

샘플 미리보기

오브젝트 스토리지에서 데이터셋 행의 샘플 미리보기를 온디맨드로 제공합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
dataset_idpathstring✓
limitqueryinteger

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/usage

GET/api/v1/datasets/{dataset_id}/usage

데이터셋 사용 이력

이 데이터셋을 사용한 학습 실행(run)을 조회합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
dataset_idpathstring✓

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/drafts

POST/api/v1/datasets/drafts

데이터셋 생성

정보(이름/모달리티/소스)만으로 데이터셋을 즉시 생성합니다.

필요 권한: DATASET_WRITE

요청 본문: application/json, DraftCreate

필드형식필수설명
namestring✓Name
modalitystring?Modality
sourcestring?Source

응답

상태설명
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/files

GET/api/v1/datasets/{dataset_id}/files

파일 목록

데이터셋의 업로드 파일 목록을 반환합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
dataset_idpathstring✓
statusquerystring?
kindquerystring?파일 종류 (image 등)
originquerystring?upload | sync
pagequeryinteger
page_sizequeryinteger?
qquerystring?이름 부분 일치 검색
sortquerystring?정렬 키
orderquerystringasc | desc

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/files

POST/api/v1/datasets/{dataset_id}/files

파일 업로드

데이터셋에 파일 1개를 multipart로 업로드합니다.

필요 권한: DATASET_WRITE

파라미터

이름위치형식필수설명
dataset_idpathstring✓

요청 본문: multipart/form-data, Body_upload_file_api_v1_datasets__dataset_id__files_post

필드형식필수설명
filestring✓File

응답

상태설명
201Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/archive

POST/api/v1/datasets/{dataset_id}/archive

ZIP 아카이브 업로드

데이터셋에 ZIP 아카이브 1개를 올려 멤버별 파일로 풀어 넣습니다.

필요 권한: DATASET_WRITE

파라미터

이름위치형식필수설명
dataset_idpathstring✓

요청 본문: multipart/form-data, Body_upload_archive_api_v1_datasets__dataset_id__archive_post

필드형식필수설명
filestring✓File

응답

상태설명
201Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/uploads

POST/api/v1/datasets/{dataset_id}/uploads

청크 업로드 세션 시작

파일 1개 또는 ZIP 1개를 청크로 나눠 올리는 세션을 엽니다.

필요 권한: DATASET_WRITE

파라미터

이름위치형식필수설명
dataset_idpathstring✓

요청 본문: application/json, DatasetUploadInit

필드형식필수설명
filenamestring✓Filename
sizeinteger✓Size
sha256string?Sha256
chunk_sizeinteger?Chunk Size

응답

상태설명
201Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/uploads/{upload_id}

GET/api/v1/datasets/{dataset_id}/uploads/{upload_id}

청크 업로드 상태(재개 지점)

받은 청크 인덱스 목록과 상태를 돌려줍니다.

파라미터

이름위치형식필수설명
dataset_idpathstring✓
upload_idpathstring✓

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

PUT /api/v1/datasets/{dataset_id}/uploads/{upload_id}/chunks/{index}

PUT/api/v1/datasets/{dataset_id}/uploads/{upload_id}/chunks/{index}

청크 전송

청크 하나를 보냅니다(application/octet-stream).

파라미터

이름위치형식필수설명
dataset_idpathstring✓
upload_idpathstring✓
indexpathinteger✓

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/uploads/{upload_id}:complete

POST/api/v1/datasets/{dataset_id}/uploads/{upload_id}:complete

청크 업로드 마감

모든 청크가 도착했음을 알리고 즉시 돌아옵니다(202).

파라미터

이름위치형식필수설명
dataset_idpathstring✓
upload_idpathstring✓

응답

상태설명
202Successful Response (object)
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/files/{file_id}

GET/api/v1/datasets/{dataset_id}/files/{file_id}

파일 상세

단일 업로드 파일의 상태/메타데이터를 반환합니다 (VIEW 권한).

파라미터

이름위치형식필수설명
dataset_idpathstring✓
file_idpathstring✓

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

DELETE /api/v1/datasets/{dataset_id}/files/{file_id}

DELETE/api/v1/datasets/{dataset_id}/files/{file_id}

파일 삭제

데이터셋에서 파일을 삭제합니다.

필요 권한: DATASET_WRITE

파라미터

이름위치형식필수설명
dataset_idpathstring✓
file_idpathstring✓
forcequeryboolean

응답

상태설명
204Successful Response
422Validation Error (HTTPValidationError)

GET /api/v1/datasets/{dataset_id}/files/{file_id}/content

GET/api/v1/datasets/{dataset_id}/files/{file_id}/content

파일 내용

파일 원본 또는 다운샘플 프리뷰 바이트를 스트리밍합니다.

필요 권한: VIEW

파라미터

이름위치형식필수설명
dataset_idpathstring✓
file_idpathstring✓
variantquerystring
downloadqueryboolean

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/revalidate-annotations

POST/api/v1/datasets/{dataset_id}/revalidate-annotations

어노테이션 매칭 재계산

어노테이션 파일들의 이미지 매칭률을 재계산합니다.

필요 권한: DATASET_WRITE

파라미터

이름위치형식필수설명
dataset_idpathstring✓

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

POST /api/v1/datasets/{dataset_id}/revalidate

POST/api/v1/datasets/{dataset_id}/revalidate

데이터셋 파일 재검증

데이터셋의 모든 파일을 저장소에서 다시 읽어 검증합니다.

필요 권한: DATASET_WRITE

파라미터

이름위치형식필수설명
dataset_idpathstring✓

응답

상태설명
200Successful Response (object)
422Validation Error (HTTPValidationError)

2026-09-21 기준 플랫폼에 맞춰 작성했습니다.

© Geo-MLOps