데이터셋 파일 API
파일(File)은 데이터셋에 저장된 개별 파일입니다. 경로는 데이터셋 내부의 상대 경로이며 맨 앞에 /를 붙이지 않습니다. API의 파일 메타데이터는 경로, 트랜잭션 RID, 크기와 갱신 시각을 표현하고, 파일 내용은 별도 바이너리 응답으로 읽습니다.
| 작업 | 기능 |
|---|---|
| List Files | 선택한 브랜치나 트랜잭션 범위의 파일을 페이지로 조회합니다. |
| Upload File | 파일 바이트를 업로드합니다. 요청의 콘텐츠 유형은 application/octet-stream입니다. |
| Get File Metadata | 파일의 메타데이터를 조회합니다. |
| Get File Content | 파일의 바이너리 내용을 읽습니다. |
| Delete File | 새 삭제 트랜잭션이나 수동으로 연 DELETE 트랜잭션에서 파일을 삭제합니다. |
기본 읽기는 기본 브랜치의 최신 뷰를 사용합니다. 특정 트랜잭션에서 바뀐 파일만 확인하려면 시작과 끝 트랜잭션을 같은 RID로 지정합니다. 과거 버전과 범위 판정, 중간 스냅샷의 영향은 각 읽기 작업의 조건을 따릅니다.