CreateMultipartUpload

Prev Next

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

5GB 이상의 대용량 객체를 업로드할 수 있도록 멀티파트 업로드를 시작하고 업로드 아이디를 생성합니다.

참고

생성한 업로드 아이디는 특정 멀티파트 업로드의 모든 파트를 연결하여 조합 시 사용합니다.

요청

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

메서드 URI
POST /{Key}

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

참고

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 요청 헤더를 참조해 주십시오.

필드 타입 필수 여부 설명
Cache-Control String Optional 캐싱 동작
Content-Disposition Optional 요청 데이터의 표시 방식
Content-Encoding Optional 요청 데이터의 인코딩 방식
Content-Language Optional 요청 데이터의 언어
Content-Type Optional 요청 데이터의 형식
x-amz-storage-class Optional 스토리지 클래스
  • STANDARD (기본값) | DEEP_ARCHIVE
    • STANDARD: Standard Class
    • DEEP_ARCHIVE: Archive Class
x-amz-server-side-encryption-customer-algorithm Optional 사용자 암호화 알고리즘 (AES256)
x-amz-server-side-encryption-customer-key Optional 사용자 제공 암호화 키
x-amz-server-side-encryption-customer-key-MD5 Optional 사용자 제공 암호화 키의 MD5 값

요청 경로 파라미터

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

필드 타입 필수 여부 설명
Key String Required 객체 이름
  • 버킷 내 폴더에 저장할 경우, {폴더 이름}/{파일 이름} 형태로 입력

요청 쿼리 파라미터

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

필드 타입 필수 여부 설명
uploads String Required 멀티파트 업로드 시작 요청
  • 값 없이 키만 입력

요청 예시

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

POST /object.xlsx?uploads HTTP/1.1
Host: bucket.kr.ncloudstorage.com
x-amz-storage-class: DEEP_ARCHIVE

응답

응답 형식을 설명합니다.

응답 헤더

Ncloud Storage API에서 공통으로 사용하는 헤더에 대한 정보는 Ncloud Storage 응답 헤더를 참조해 주십시오.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
InitiateMultipartUploadResult Object - 멀티파트 업로드 시작 결과
InitiateMultipartUploadResult.Bucket String - 버킷 이름
InitiateMultipartUploadResult.Key String - 객체 이름
InitiateMultipartUploadResult.UploadId String - 멀티파트 업로드 아이디
  • 이후 단계의 API 호출 시 필요하므로 저장

응답 상태 코드

Ncloud Storage API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud Storage 응답 상태 코드를 참조해 주십시오.

응답 예시

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

HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult>
    <Bucket>bucket</Bucket>
    <Key>object.xlsx</Key>
    <UploadId>7880da58-****-****-****-9cc2c468d0e9</UploadId>
</InitiateMultipartUploadResult>