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

개체 - 복사 를 선택합니다

기여자
PDF

S3 PUT 오브젝트 복사 요청을 사용하여 S3에 이미 저장된 오브젝트 복사본을 생성할 수 있습니다. Put Object - Copy 작업은 GET 및 PUT를 수행하는 작업과 동일합니다.

충돌 해결

동일한 키에 쓰는 두 클라이언트 등의 충돌하는 클라이언트 요청은 "최신 성공" 기준으로 해결됩니다. "Latest-WINS" 평가 시기는 S3 클라이언트가 작업을 시작할 때가 아니라 StorageGRID 시스템이 지정된 요청을 완료하는 시점을 기준으로 합니다.

개체 크기

단일 PUT 오브젝트 작업의 maximum_recommended_size는 5GiB(5,368,709,120바이트)입니다. 5GiB보다 큰 객체가 있는 경우 대신 멀티파트 업로드를 사용합니다.

단일 PUT 객체 작업의 Maximum_supported_size는 5TiB(5,497,558,138,880바이트)입니다. 그러나 5GiB를 초과하는 개체를 업로드하려고 하면 * S3 PUT 오브젝트 크기가 너무 큼 * 경고가 트리거됩니다.

사용자 메타데이터의 UTF-8 문자

요청에 사용자 정의 메타데이터의 키 이름이나 값에 UTF-8 값이 포함되어 있으면 StorageGRID 동작이 정의되지 않습니다.

StorageGRID는 사용자 정의 메타데이터의 키 이름이나 값에 포함된 이스케이프된 UTF-8 문자를 구문 분석하거나 해석하지 않습니다. 이스케이프된 UTF-8 문자는 ASCII 문자로 처리됩니다.

  • 사용자 정의 메타데이터에 이스케이프된 UTF-8 문자가 포함된 경우 요청이 성공합니다.

  • StorageGRID는 을 반환하지 않습니다 x-amz-missing-meta 머리글 키 이름이나 값의 해석된 값에 인쇄할 수 없는 문자가 포함된 경우.

지원되는 요청 헤더입니다

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

  • Content-Type

  • x-amz-copy-source

  • x-amz-copy-source-if-match

  • x-amz-copy-source-if-none-match

  • x-amz-copy-source-if-unmodified-since

  • x-amz-copy-source-if-modified-since

  • `x-amz-meta-`사용자 정의 메타데이터를 포함하는 이름-값 쌍이 뒤에 옵니다

  • x-amz-metadata-directive`기본값은 입니다 `COPY, 개체 및 관련 메타데이터를 복사할 수 있습니다.

    지정할 수 있습니다 REPLACE 오브젝트를 복사할 때 기존 메타데이터를 덮어쓰거나 오브젝트 메타데이터를 업데이트합니다.

  • x-amz-storage-class

  • x-amz-tagging-directive`기본값은 입니다 `COPY, 개체 및 모든 태그를 복사할 수 있습니다.

    지정할 수 있습니다 REPLACE 개체를 복사할 때 기존 태그를 덮어쓰거나 태그를 업데이트합니다.

  • S3 오브젝트 잠금 요청 헤더:

  • SSE 요청 헤더:

    • x-amz-copy-source​-server-side​-encryption​-customer-algorithm

    • x-amz-copy-source​-server-side-encryption-customer-key

    • x-amz-copy-source​-server-side-encryption-customer-key-MD5

    • x-amz-server-side-encryption

    • x-amz-server-side-encryption-customer-key-MD5

    • x-amz-server-side-encryption-customer-key

    • x-amz-server-side-encryption-customer-algorithm

      을 참조하십시오 서버측 암호화에 대한 요청 헤더

지원되지 않는 요청 헤더입니다

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

  • Cache-Control

  • Content-Disposition

  • Content-Encoding

  • Content-Language

  • Expires

  • x-amz-website-redirect-location

스토리지 클래스 옵션

를 클릭합니다 x-amz-storage-class 요청 헤더가 지원되며 일치하는 ILM 규칙에서 이중 커밋 또는 균형 조정의 수집 동작을 지정하는 경우 StorageGRID에서 만드는 개체 복사본 수에 영향을 줍니다.

  • STANDARD

    (기본값) ILM 규칙이 이중 커밋 옵션을 사용하거나 균형 옵션이 중간 복사본 생성으로 돌아올 때 이중 커밋 수집 작업을 지정합니다.

  • REDUCED_REDUNDANCY

    ILM 규칙이 이중 커밋 옵션을 사용하거나 균형 옵션이 중간 복사본 생성으로 돌아올 때 단일 커밋 수집 작업을 지정합니다.

    참고 S3 오브젝트 잠금이 설정된 버킷으로 오브젝트를 밀어넣는 경우, 를 참조하십시오 REDUCED_REDUNDANCY 옵션이 무시됩니다. 오브젝트를 레거시 준수 버킷으로 인스팅하는 경우, 를 참조하십시오 REDUCED_REDUNDANCY 옵션을 사용하면 오류가 반환됩니다. StorageGRID은 규정 준수 요구 사항이 충족될 수 있도록 항상 이중 커밋 수집을 수행합니다.

Put Object - Copy에서 x-amz-copy-source 사용

소스 버킷과 키가 에 지정된 경우 x-amz-copy-source 헤더 는 대상 버킷 및 키와 다르며 소스 오브젝트 데이터의 복제본이 대상에 기록됩니다.

소스 및 대상이 일치하면, 및 입니다 x-amz-metadata-directive 머리글은 로 지정됩니다 `REPLACE`오브젝트의 메타데이터는 요청에 제공된 메타데이터 값으로 업데이트됩니다. 이 경우 StorageGRID는 오브젝트를 다시 수집하지 않습니다. 여기에는 두 가지 중요한 결과가 있습니다.

  • Put Object-Copy를 사용하여 기존 개체를 현재 위치에서 암호화하거나 기존 개체의 암호화를 변경할 수 없습니다. 를 공급하는 경우 x-amz-server-side-encryption 머리글 또는 을 선택합니다 x-amz-server-side-encryption-customer-algorithm header, StorageGRID가 요청을 거부하고 반환합니다 XNotImplemented.

  • 일치하는 ILM 규칙에 지정된 Ingest 동작 옵션은 사용되지 않습니다. ILM이 정상적인 백그라운드 ILM 프로세스에 의해 다시 평가될 때 업데이트로 인해 트리거되는 개체 배치에 대한 모든 변경 사항이 발생합니다.

    즉, ILM 규칙이 수집 동작에 Strict 옵션을 사용하는 경우 필요한 개체 배치를 만들 수 없는 경우(예: 새로 필요한 위치를 사용할 수 없음) 작업이 수행되지 않습니다. 업데이트된 오브젝트는 필요한 배치가 가능할 때까지 현재 위치를 유지합니다.

서버측 암호화에 대한 요청 헤더

서버 측 암호화를 사용하는 경우 소스 개체가 암호화되었는지 여부 및 대상 개체를 암호화할 계획인지에 따라 요청 헤더가 제공됩니다.

  • 소스 객체가 SSE-C(customer-provided key)를 사용하여 암호화된 경우, 객체를 해독한 다음 복사할 수 있도록 객체 복사 요청(Put Object-Copy request)에 다음 세 개의 헤더를 포함해야 합니다.

    • x-amz-copy-source​-server-side​-encryption​-customer-algorithm`을 지정합니다 `AES256.

    • x-amz-copy-source​-server-side-encryption-customer-key: 소스 객체를 만들 때 제공한 암호화 키를 지정합니다.

    • x-amz-copy-source​-server-side-encryption-customer-key-MD5: 소스 개체를 만들 때 제공한 MD5 다이제스트를 지정합니다.

  • 제공 및 관리하는 고유 키를 사용하여 대상 개체(복사본)를 암호화하려면 다음 세 개의 머리글을 포함합니다.

    • x-amz-server-side-encryption-customer-algorithm`을 지정합니다 `AES256.

    • x-amz-server-side-encryption-customer-key: 대상 오브젝트의 새 암호화 키를 지정합니다.

    • x-amz-server-side-encryption-customer-key-MD5: 새 암호화 키의 MD5 다이제스트를 지정합니다.

    중요함 제공한 암호화 키는 저장되지 않습니다. 암호화 키를 분실하면 해당 개체가 손실됩니다. 고객이 제공한 키를 사용하여 오브젝트 데이터를 보호하기 전에 의 고려 사항을 검토하십시오 "서버 측 암호화 사용".

  • SSE(StorageGRID)에서 관리되는 고유 키로 대상 객체(사본)를 암호화하려면 객체 복사 요청(Put Object-Copy request)에 이 헤더를 포함시킵니다.

    • x-amz-server-side-encryption

      참고 를 클릭합니다 server-side-encryption 개체의 값을 업데이트할 수 없습니다. 대신 새 로 복사본을 만듭니다 server-side-encryption 값 사용 x-amz-metadata-directive: REPLACE.

버전 관리

소스 버킷의 버전이 있는 경우 를 사용할 수 있습니다 x-amz-copy-source Header - 개체의 최신 버전을 복사합니다. 특정 버전의 개체를 복사하려면 을 사용하여 복사할 버전을 명시적으로 지정해야 합니다 versionId 하위 리소스. 대상 버킷의 버전이 지정된 경우 생성된 버전이 에서 반환됩니다 x-amz-version-id 응답 헤더. 타겟 버킷에 대한 버전 관리가 일시 중지된 경우 x-amz-version-id ""null"" 값을 반환합니다.

관련 정보

"ILM을 사용하여 개체를 관리합니다"

"S3 작업이 감사 로그에서 추적되었습니다"

"개체 를 넣습니다"