V2 데이터셋 파일 API
파일(File)은 데이터셋 안의 상대 경로로 식별합니다. 경로 앞에는 /를 붙이지 않으며 요청 URL에서는 공백이나 경로 구분자를 해당 매개변수에 맞게 인코딩합니다.
| 작업 | 기능 |
|---|---|
| List Files | 브랜치 또는 트랜잭션 범위의 파일 목록을 조회합니다. pathPrefix로 경로를 제한할 수 있습니다. |
| Get File | 파일 경로, 트랜잭션, 크기와 갱신 시각 등의 메타데이터를 조회합니다. |
| Get File Content | 파일 바이트를 다운로드합니다. 설정된 최대 다운로드 크기를 넘으면 오류가 발생합니다. |
| Upload File | application/octet-stream 바이너리 본문으로 파일을 업로드합니다. |
| Delete File | 파일을 삭제합니다. 과거 뷰에서는 이전 파일을 계속 볼 수 있습니다. |
V2 업로드는 파일 경로를 /files/{filePath}/upload의 경로 매개변수로 받습니다. 브랜치를 지정하여 자동으로 트랜잭션을 생성하고 커밋하거나, 직접 연 트랜잭션을 지정하여 여러 파일 변경을 묶을 수 있습니다. 수동 삭제 트랜잭션은 DELETE 유형이어야 합니다.