InitiateMultipartUpload

Classic/VPC 환경에서 이용 가능합니다.

오브젝트를 파트로 나누어 업로드하는 멀티파트 업로드를 실행할 때 참조할 업로드 ID를 받을 수 있습니다. 반환된 ID는 업로드된 파트들을 하나로 묶을 수 있는 식별자입니다.
멀티파트 업로드를 수행하기 전에 먼저 업로드 ID를 받아야 합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드	URI
POST	/{bucket-name}/{object-name}

요청 구문

요청 구문은 다음과 같습니다.

POST https://{endpoint}/{bucket-name}/{object-name}?uploads= # path style
POST https://{bucket-name}.{endpoint}/{object-name}?uploads= # virtual host style

요청 헤더

Object Storage API에서 공통으로 사용하는 헤더에 대한 자세한 내용은 Object Storage 공통 헤더를 참조해 주십시오.

요청 경로 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`bucket-name`	String	Required	오브젝트가 저장된 버킷 이름
`object-name`	String	Required	멀티파트 업로드를 실행할 오브젝트 이름

요청 쿼리 파라미터

파라미터에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`uploads`	String	Required	응답에 업로드 ID 포함 선언 값 없이 키만 입력

요청 예시

요청 예시는 다음과 같습니다.

POST /some-bucket/multipart-object-123?uploads= HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20170303T203411Z
Host: kr.object.gov-ncloudstorage.com

응답

응답 형식을 설명합니다.

응답 헤더

Object Storage API에서 공통으로 사용하는 응답 헤더에 대한 자세한 내용은 Object Storage 공통 응답 헤더를 참조해 주십시오.

응답 상태 코드

Object Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 자세한 내용은 Object Storage 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

HTTP/1.1 200 OK
Date: Fri, 03 Mar 2017 20:34:12 GMT
Accept-Ranges: bytes
Content-Type: application/xml
Content-Length: 276

<InitiateMultipartUploadResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>some-bucket</Bucket>
  <Key>multipart-object-123</Key>
  <UploadId>0000015a-95e1-4326-654e-a1b57887784f</UploadId>
</InitiateMultipartUploadResult>