Skip to main content
이 제품의 최신 릴리즈를 사용할 수 있습니다.
본 한국어 번역은 사용자 편의를 위해 제공되는 기계 번역입니다. 영어 버전과 한국어 버전이 서로 어긋나는 경우에는 언제나 영어 버전이 우선합니다.

StorageGRID S3 REST API가 멀티파트 업로드를 완료하는 방법

PDF

CompleteMultipartUpload 작업은 이전에 업로드된 부분들을 조합하여 객체의 멀티파트 업로드를 완료합니다.

참고 StorageGRID는 CompleteMultipartUpload와 함께 사용되는 partNumber 요청 매개변수에 대해 오름차순의 비연속적인 값을 지원합니다. 매개변수는 어떤 값으로든 시작할 수 있습니다.

충돌 해결

두 클라이언트가 동일한 키에 쓰기를 시도하는 등 클라이언트 요청이 충돌하는 경우 "최신 요청 우선" 원칙에 따라 처리됩니다. "최신 요청 우선" 평가 시점은 S3 클라이언트가 작업을 시작한 시점이 아니라 StorageGRID 시스템이 해당 요청을 완료한 시점을 기준으로 합니다.

지원되는 요청 헤더

다음과 같은 요청 헤더가 지원됩니다.

  • x-amz-checksum-sha256

  • x-amz-storage-class

    `x-amz-storage-class` 헤더는 일치하는 ILM 규칙이 link:../ilm/data-protection-options-for-ingest.html["이중 커밋 또는 균형 잡힌 수집 옵션"]을(를) 지정하는 경우 StorageGRID가 생성하는 객체 복사본 수에 영향을 미칩니다.

  • STANDARD

    (기본값) ILM 규칙에서 이중 커밋 옵션을 사용하거나 균형 옵션이 임시 복사본 생성으로 대체될 때 이중 커밋 수집 작업을 지정합니다.

  • REDUCED_REDUNDANCY

    ILM 규칙에서 이중 커밋 옵션을 사용하거나 균형 옵션이 임시 복사본 생성으로 대체될 때 단일 커밋 수집 작업을 지정합니다.

    참고 S3 객체 잠금이 활성화된 버킷에 객체를 수집하는 경우 REDUCED_REDUNDANCY 옵션은 무시됩니다. 레거시 규정 준수 버킷에 객체를 수집하는 경우 REDUCED_REDUNDANCY 옵션은 오류를 반환합니다. StorageGRID는 규정 준수 요구 사항을 충족하기 위해 항상 이중 커밋 수집을 수행합니다.
주의 멀티파트 업로드가 15일 이내에 완료되지 않으면 해당 작업은 비활성으로 표시되고 관련 데이터는 시스템에서 모두 삭제됩니다.
참고 반환되는 ETag 값은 데이터의 MD5 합계가 아니라, 멀티파트 객체에 대한 ETag 값의 Amazon S3 API 구현 방식을 따릅니다.

지원되지 않는 요청 헤더

다음 요청 헤더는 지원되지 않습니다.

  • If-Match

    `If-Match header`은(는) 승인되었지만 작동하지 않습니다.

  • If-None-Match

    `If-None-Match header`은(는) 승인되었지만 작동하지 않습니다.

  • x-amz-sdk-checksum-algorithm

  • x-amz-trailer

버전 관리

이 작업은 멀티파트 업로드를 완료합니다. 버킷에 버전 관리가 활성화된 경우, 멀티파트 업로드가 완료된 후 객체 버전이 생성됩니다.

버킷에 버전 관리가 활성화된 경우, 저장된 객체의 버전에 대한 고유 `versionId`가 자동으로 생성됩니다. 이 `versionId`는 `x-amz-version-id`응답 헤더를 사용하여 응답에도 반환됩니다.

버전 관리가 일시 중단되면 객체 버전은 null `versionId`으로 저장되며, 이미 null 버전이 존재하는 경우 덮어쓰여집니다.

참고 버킷에 버전 관리가 활성화된 경우, 동일한 객체 키에 대해 동시에 여러 개의 멀티파트 업로드가 완료되더라도 멀티파트 업로드가 완료되면 항상 새 버전이 생성됩니다. 버킷에 버전 관리가 활성화되지 않은 경우, 멀티파트 업로드를 시작한 후 동일한 객체 키에 대해 다른 멀티파트 업로드가 먼저 시작되어 완료될 수 있습니다. 버전 관리가 되지 않는 버킷에서는 마지막으로 완료된 멀티파트 업로드가 우선 순위를 갖습니다.

복제, 알림 또는 메타데이터 알림 실패

멀티파트 업로드가 발생하는 버킷이 플랫폼 서비스용으로 구성된 경우, 관련 복제 또는 알림 작업이 실패하더라도 멀티파트 업로드는 성공합니다.

테넌트는 객체의 메타데이터 또는 태그를 업데이트하여 복제 실패 또는 알림을 발생시킬 수 있습니다. 테넌트는 원치 않는 변경을 방지하려면 기존 값을 다시 제출할 수 있습니다.

"플랫폼 서비스 문제 해결"을 참조하십시오.