최신 업데이트:2025-08-18 15:54:01
멀티파트 업로드 작업이 생성된 후, 사용자는 멀티파트 업로드 작업 번호를 지정해 클라이언트에서 새 데이터를 업로드할 수 있습니다. 업로드 파트 인터페이스를 통해 특정 작업에 대하여 각 파트를 업로드합니다. 동일 객체의 같은 멀티파트 업로드 작업의 파트 업로드 시 업로드 순서는 이후의 병합 작업에 영향을 미치지 않으므로, 여러 파트를 동시에 병렬로 업로드할 수 있습니다.
업로드 파트 번호는 [1,10000] 범위 내로 제한됩니다. 파트 번호는 병합 시 파트의 식별 및 위치를 결정하는 유일한 기준입니다. 중복된 파트 번호로 파트를 업로드하면 기존에 업로드된 같은 번호의 파트가 덮어쓰기됩니다. 최소 파트 크기는 5MB이며, 병합 시 마지막 파트의 크기에는 제한이 없습니다.
데이터 전송 중 손상을 방지하기 위해 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
| 파라미터명 | 설명 | 필수 여부 |
|---|---|---|
| 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