UploadPart

최신 업데이트:2025-08-18 15:54:01

업로드 작업 설명

  1. 멀티파트 업로드 작업이 생성된 후, 사용자는 멀티파트 업로드 작업 번호를 지정해 클라이언트에서 새 데이터를 업로드할 수 있습니다. 업로드 파트 인터페이스를 통해 특정 작업에 대하여 각 파트를 업로드합니다. 동일 객체의 같은 멀티파트 업로드 작업의 파트 업로드 시 업로드 순서는 이후의 병합 작업에 영향을 미치지 않으므로, 여러 파트를 동시에 병렬로 업로드할 수 있습니다.

  2. 업로드 파트 번호는 [1,10000] 범위 내로 제한됩니다. 파트 번호는 병합 시 파트의 식별 및 위치를 결정하는 유일한 기준입니다. 중복된 파트 번호로 파트를 업로드하면 기존에 업로드된 같은 번호의 파트가 덮어쓰기됩니다. 최소 파트 크기는 5MB이며, 병합 시 마지막 파트의 크기에는 제한이 없습니다.

  3. 데이터 전송 중 손상을 방지하기 위해 Content-MD5 요청 헤더를 추가할 수 있습니다. 시스템은 MD5 값을 검사하며, MD5 값이 올바르지 않은 경우 WOS에서 오류 메시지를 반환합니다.

참고: 멀티파트 작업이 생성되고 한 개 이상의 파트가 업로드된 경우, 해당 파트들이 병합되거나 멀티파트 작업이 취소되기 전까지는 사용 중인 저장 공간이 해제되지 않습니다. 그렇지 않으면 점유된 공간은 계속 유지됩니다.

요청 문법

PUT /ObjectName?partNumber=partNum&uploadId=uploadId HTTP/1.1

Host: Bucket.Endpoint
Date: date
Content-Length: Size
Authorization: authorization
Content-MD5: md5

URI 요청 파라미터

파라미터명 설명 필수 여부
partNumber 업로드 파트 번호, 범위 [1,10000]
uploadId Initiate Multipart Upload 응답의 upload id

요청 헤더

common request headers만 사용합니다.

요청 본문

분할된 데이터

응답 문법

HTTP/1.1 status_code

x-wos-request-id: request id
Date: date
ETag: etagValue
Content-Length: length
Server: WS-web-server

응답 헤더

common response headers만 사용합니다.

응답 요소

없음

특수 에러

상황 Http 상태 에러 코드 메시지
시그니처와 URL에 각각 단일 파라미터(uploadId 또는 partNumber)만 포함된 경우 400 Bad Request InvalidArgument Invalid Argument
UploadId/partNumber가 시그니처와 URL 모두에 포함되나, 순서는 동일하지만 정상적이지 않을 때 400 Bad Request InvalidArgument Invalid Argument
partNumber > 10000 400 Bad Request InvalidArgument Part number must be an integer between 1 and 10000
단일 업로드의 partsize가 5G 초과 400 Bad Request EntityTooLarge Your proposed upload exceeds the maximum allowed object size.

예시

PUT /ObjectName?partNumber=1&uploadId=VCVsb2FkIElEIGZvciBlbZZpbmcncyBteS1tb3ZpZS5tMnRzIHVwbG9hZR HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 1048596
Authorization:WOS 14RZT432N80TGDF2Y2G2:8se2hm3YLchJhuPMDrybeITcuo0=
Content-MD5:q3q7DaS8pTI6thGbtdzSlg==


HTTP/1.1 200 OK
x-wos-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
ETag: "b54357faf0632cce46e942fa68356b38"
Content-Length: 1048596
Server: WCS-web-server

이 문서의 내용이 도움이 되었습니까?
아니오
정상적으로 제출되었습니다.피드백을 주셔서 감사합니다.앞으로도 개선을 위해 노력하겠습니다.