XML API 멀티파트 업로드

이 페이지에서는 Cloud Storage의 XML API 멀티파트 업로드에 대해 설명합니다. 이 업로드 메서드는 파일을 여러 부분으로 업로드한 후 최종 요청을 사용해서 이를 단일 객체로 조합합니다. XML API 멀티파트 업로드는 Amazon S3 멀티파트 업로드와 호환됩니다.

개요

XML API 멀티파트 업로드를 사용하면 데이터를 여러 부분으로 업로드한 후 이를 최종 객체로 조합할 수 있습니다. 이 동작은 특히 대용량 파일에서 여러 이점이 있습니다.

  • 여러 부분을 동시에 업로드할 수 있으므로 데이터 전체를 업로드하는 데 걸리는 시간이 단축됩니다.

  • 업로드 작업 중 하나가 실패하면 처음부터 다시 시작할 필요 없이 전체 객체의 일부만 다시 업로드하면 됩니다.

  • 전체 파일 크기가 미리 지정되지 않았으므로 스트리밍 이전 또는 업로드하는 동안 데이터를 즉시 압축하기 위해 XML API 멀티파트 업로드를 사용할 수 있습니다.

XML API 멀티파트 업로드에는 다음 세 가지 필수 단계가 있습니다.

  1. 완료된 객체에 포함되어야 하는 메타데이터 지정이 포함된 POST 요청을 사용하여 업로드를 시작합니다. 업로드와 연관된 모든 이후 요청에 사용하는 UploadId가 응답으로 반환됩니다.

  2. 하나 이상의 PUT 요청을 사용하여 데이터를 업로드합니다. 여러 부분의 갯수 및 크기에는 한도가 있습니다.

  3. POST 요청을 사용하여 업로드를 완료합니다. 이 요청은 동일한 이름의 버킷에 있는 기존 객체를 덮어씁니다.

멀티파트 업로드 및 업로드된 부분이 버킷에서 완료되지 않거나 유휴 상태로 유지되는 기간에는 제한이 없지만 성공적으로 업로드된 부분은 월별 저장용량 사용량으로 계산됩니다.

고려사항

XML API 멀티파트 업로드를 사용할 때 다음 제한사항이 적용됩니다.

  • 복사 또는 다시 작성하기 전 객체를 구성하지 않는 한 이 메서드를 사용하여 업로드된 객체를 복사하거나 다시 작성할 수 없습니다.
  • 전제조건은 이 요청에서 지원되지 않습니다.
  • 이 메서드를 사용하여 업로드된 객체에 대해서는 MD5 해시가 존재하지 않습니다.
  • 이 업로드 메서드는 Google Cloud Console, gsutil, Cloud Storage 클라이언트 라이브러리에서 지원되지 않습니다.

XML API 멀티파트 업로드로 작업할 때는 다음 사항에 유의하세요.

  • 부분 업로드를 시작하고 업로드할 수는 있지만 보존 조치가 적용된 객체 또는 처리되지 않은 보관 기간이 있는 객체를 덮어쓰는 경우 업로드 완료 요청이 실패합니다.

  • 버킷에서 진행 중인 업로드를 나열할 수 있지만 완료된 업로드만 버킷의 정상 객체 목록에 표시됩니다.

  • 업로드된 스토리지가 관련 스토리지 클래스를 사용할 경우 해당 부분이 해당 스토리지의 최소 저장 기간에 도달하기 전에 다음 중 하나가 발생하면 조기 삭제 요금이 적용됩니다.

    • 업로드가 완료되었지만 해당 부분이 완료 요청에 사용되지 않았습니다.
    • 해당 부분이 다른 업로드된 부분에 의해 덮어쓰여졌습니다.
    • 전체 멀티파트 업로드가 중단되었습니다.

    멀티파트 업로드에서 각 부분에 대한 스토리지 기간은 파트 업로드가 완료된 시간에 시작됩니다.

다음 단계