파일 청크 업로드

아티클
07/19/2023

이미지 저장소 상대 경로에 파일 청크를 업로드합니다.

지정된 업로드 세션 ID 및 이미지 저장소 상대 경로를 사용하여 이미지 저장소에 파일 청크를 업로드합니다. 이 API를 사용하면 사용자가 파일 업로드 작업을 다시 시작할 수 있습니다. 사용자는 네트워크 중단이 있을 때마다 파일 업로드를 처음부터 다시 시작할 필요가 없습니다. 파일 크기가 큰 경우 이 옵션을 사용합니다.

다시 실행 가능한 파일 업로드를 수행하려면 사용자가 파일을 여러 청크로 분할하고 이러한 청크를 이미지 저장소에 하나씩 업로드해야 합니다. 청크는 순서대로 업로드할 필요가 없습니다. 이미지 저장소 상대 경로로 표시되는 파일이 이미 있는 경우 업로드 세션이 커밋될 때 덮어씁니다.

요청

메서드	요청 URI
PUT	`/ImageStore/{contentPath}/$/UploadChunk?api-version=6.0&session-id={session-id}&timeout={timeout}`

매개 변수

속성	형식	필수	위치
`contentPath`	문자열	예	경로
`Content-Range`	문자열	예	헤더
`api-version`	문자열	예	쿼리
`session-id`	string(uuid)	예	쿼리
`timeout`	정수(int64)	아니요	쿼리

`contentPath`

형식: 문자열
필수: 예

루트에서 이미지 저장소의 파일 또는 폴더에 대한 상대 경로입니다.

`Content-Range`

형식: 문자열
필수: 예

이미지 저장소에 파일 청크를 업로드할 때 Content-Range 헤더 필드를 구성하고 요청과 함께 보내야 합니다. 형식은 "바이트 {First-Byte-Position}-{Last-Byte-Position}/{File-Length}"와 같습니다. 예를 들어 Content-Range:bytes 300-5000/20000은 사용자가 바이트 300~5,000을 보내고 총 파일 길이가 20,000바이트임을 나타냅니다.

`api-version`

형식: 문자열
필수: 예
기본: 6.0

API 버전입니다. 이 매개 변수는 필수이며 해당 값은 '6.0'이어야 합니다.

Service Fabric REST API 버전은 API가 도입되었거나 변경된 런타임 버전을 기반으로 합니다. Service Fabric 런타임은 둘 이상의 API 버전을 지원합니다. 지원되는 최신 버전의 API입니다. 더 낮은 API 버전이 전달되면 반환된 응답이 이 사양에 설명된 응답과 다를 수 있습니다.

또한 런타임은 런타임의 현재 버전까지 지원되는 최신 버전보다 높은 모든 버전을 허용합니다. 따라서 최신 API 버전이 6.0이지만 런타임이 6.1인 경우 클라이언트를 더 쉽게 작성하기 위해 런타임은 해당 API에 대해 버전 6.1을 수락합니다. 그러나 API의 동작은 문서화된 6.0 버전에 따라 다릅니다.

`session-id`

형식: string(uuid)
필수: 예

사용자가 파일 업로드를 위해 생성한 GUID입니다. 커밋될 때까지 모든 파일 청크를 추적하는 이미지 저장소 업로드 세션을 식별합니다.

`timeout`

형식: 정수(int64)
필수: 아니요
기본: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

작업을 수행하기 위한 서버 제한 시간(초)입니다. 이 시간 제한은 요청된 작업이 완료될 때까지 클라이언트가 기다릴 시간을 지정합니다. 이 매개 변수의 기본값은 60초입니다.

응답

HTTP 상태 코드	설명	응답 스키마
200(확인)	작업이 성공하면 HTTP 200 OK 상태 코드가 반환됩니다.
다른 모든 상태 코드	자세한 오류 응답입니다.	FabricError

Share via