SourceMap 분할 업로드 관련 API 사용 안내¶
분할 업로드 절차¶
- 분할 업로드 초기화: 애플리케이션, 환경, 버전을 지정하고 업로드 작업 식별자
uploadId를 획득합니다. - 단일 청크 업로드: SourceMap 압축 파일을 청크로 분할하고, 동일한
uploadId와 각 청크의chunkIndex로 업로드합니다. 각 청크의 크기는 10MB 이내로 유지해야 합니다. - 업로드된 청크 목록 조회: 해당 작업의
chunkIndexs를 읽어 작업 유효 기간 내에 누락된 청크를 보충 업로드합니다. - 청크 병합 및 파일 생성: 모든 청크가 업로드되었는지 확인한 후 호출합니다. 서버가 청크 번호 순서대로 압축 파일을 병합하고 비동기 압축 해제 작업을 제출합니다.
병합 API가 성공하면 파일이 병합되고 압축 해제 작업이 제출되었음을 의미하며, 압축 해제가 완료되었거나 SourceMap을 해석에 사용할 수 있다는 의미는 아닙니다.
초기화 결과와 유효 기간¶
uploadId의 기본 유효 기간은 3600초입니다. 이후 업로드, 청크 목록 조회, 병합은 모두 동일한 유효 작업 ID를 사용해야 합니다.- 초기화 시
existsSameFile=true가 반환되고needCover=true가 설정되지 않은 경우 빈uploadId가 반환될 수 있습니다. 동일한 애플리케이션, 환경, 버전의 파일을 덮어써야 하는지 먼저 확인한 후 다시 초기화할지 결정해야 합니다. ft.InvalidUploadId를 수신하면 작업을 다시 초기화하고 필요한 청크를 다시 업로드해야 합니다. 유효하지 않은 ID를 계속 재사용하지 마십시오.
업로드 취소¶
분할 업로드 취소를 통해 uploadId에 해당하는 전체 유효 작업을 취소하고 작업 캐시와 해당 작업의 청크 디렉터리를 삭제합니다. 이 API는 특정 청크 하나만 삭제하는 데 사용할 수 없습니다.
작업이 이미 만료된 경우 취소 API는 기존 청크 디렉터리 정리를 보장하지 않습니다. 다시 업로드하려면 새로 초기화된 uploadId를 사용해야 합니다.
단일 파일 콘텐츠 업로드¶
단일 파일 콘텐츠 업로드는 SourceMap 압축 해제 후의 단일 소스 파일 콘텐츠를 직접 업로드하는 데 사용합니다. API 요구 사항에 따라 애플리케이션, 환경, 버전, 파일 이름, 콘텐츠를 전달하면 되며, 분할 초기화 및 병합 절차는 필요하지 않습니다. 위의 10MB 제한은 분할 업로드 API에 해당합니다.