InitiateMultipartUpload
최신 업데이트：2025-08-18 15:53:59
멀티파트 업로드를 사용할 때는 먼저 Initiate Multipart Upload 인터페이스를 호출하여 작업을 생성해야 하며, 시스템은 사용자가 태스크 식별자로 사용할 수 있는 전역 고유 멀티파트 업로드 태스크 번호(uploadId)를 반환합니다. 이후 사용자는 이 식별자를 기반으로 분할 업로드, 분할 병합, 분할 나열 등 관련 요청을 할 수 있습니다. 동일 객체에 대해 여러 개의 멀티파트 업로드 태스크가 동시에 존재할 수 있으며, 각 멀티파트 업로드 태스크는 추가적인 메시지 헤더 정보를 통해 초기화할 수 있습니다.
IAM wos:PutObject 권한이 필요합니다.
요청 문법
POST /ObjectName?uploads HTTP/1.1
Host: Bucket.Endpoint
Date: date
Authorization: authorization
Cache-Control: CacheControl
Content-Disposition: ContentDisposition
Content-Encoding: ContentEncoding
Content-Language: ContentLanguage
Content-Length: ContentLength
Content-MD5: ContentMD5
Content-Type: ContentType
Expires: Expires
URI 요청 파라미터
없음
요청 헤더
common request headers 외에 아래 헤더도 지원합니다.
| 파라미터 | 설명 | 필수 여부 |
|---|---|---|
| Content-MD5 | 원본 데이터의 MD5 값. 전송 중 데이터가 손상되어 MD5가 일치하지 않는 경우 403 SignatureDoesNotMatch로 응답합니다. | 아니오 |
| x-wos-storage-class | 파일의 스토리지 유형. Standard-표준 스토리지, IA-저빈도 스토리지, Archive-아카이브 스토리지. 기본값은 같은 공간의 기본 스토리지 유형입니다. | 아니오 |
| x-wos-meta-* | 사용자 정의 메타데이터로, headObject와 getObject 시 그대로 반환됩니다. | 아니오 |
요청 본문
없음
응답 문법
HTTP/1.1 status_code
x-wos-request-id: request id
Date: date
Content-Length: length
Connection: status
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InitiateMultipartUploadResult xmlns="https://www.wangsu.com/document">
<Bucket>BucketName</Bucket>
<Key>ObjectName</Key>
<UploadId>uploadID</UploadId>
</InitiateMultipartUploadResult>
응답 헤더
common response headers 만 사용합니다.
응답 요소
| 요소명 | 설명 |
|---|---|
| InitiateMultipartUploadResult | 멀티파트 업로드 태스크를 기술하는 컨테이너 타입: XML 자식 노드: Bucket, Key, UploadId 부모 노드: 없음 |
| Bucket | 멀티파트 업로드 객체가 속한 공간명 타입: string 부모 노드: InitiateMultipartUploadResult |
| Key | 멀티파트 업로드 객체의 키 타입: string 부모 노드: InitiateMultipartUploadResult |
| UploadId | 멀티파트 업로드 ID, 이 ID를 사용해 이후 멀티파트 업로드 작업을 지정합니다. 타입: string 부모 노드: InitiateMultipartUploadResult |
특수 에러
| 상황 | Http 상태 | 에러 코드 | 메시지 |
|---|---|---|---|
| 시그니처는 uploads를 포함하지만 URL에 uploads가 없음; 또는 URL에 uploads가 있는데 시그니처에 uploads가 없음 | 403 Foribidden | SignatureDoesNotMatch | The request signature we calculated does not match the signature |
| 시그니처에 uploads가 존재하나, URL의 uploads가 잘못되었거나(오타 등); 혹은 URL에는 uploads가 있지만, 시그니처의 uploads가 잘못됨(오타 등) | 403 Foribidden | SignatureDoesNotMatch | The request signature we calculated does not match the signature you provided. |
| 시그니처와 URL 모두 uploads가 있지만 오타가 달라 불일치시 | 403 Foribidden | SignatureDoesNotMatch | The request signature we calculated does not match the signature you provided. |
예시
POST /objectkey?uploads HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Apr 2017 20:34:56 GMT
Authorization: WOS AKIAIOSFODNN7EXAMPLE:VGhpcyBtZXNzYWdlIHNpZ25lZGGieSRlbHZpbmc=
HTTP/1.1 200 OK
x-wos-request-id: 996c76696e6727732072657175657374
Date: Mon, 1 Apr 2017 20:34:56 GMT
Content-Length: 146
Connection: keep-alive
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<InitiateMultipartUploadResult xmlns="https://www.wangsu.com/document">
<Bucket>bucket01</Bucket>
<Key>objectkey</Key>
<UploadId>DCD2FC98B4F70000013DF578ACA318E7</UploadId>
</InitiateMultipartUploadResult>
이 문서의 내용이 도움이 되었습니까?
예
아니오