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

객체에 대한 작업

기여자

이 섹션에서는 StorageGRID 시스템이 객체에 대해 S3 REST API 작업을 구축하는 방법에 대해 설명합니다.

다음 조건은 모든 개체 작업에 적용됩니다.

  • StorageGRID "일관성 값" 는 다음과 같은 경우를 제외하고 모든 개체 작업에서 지원됩니다.

    • GetObjectAcl

    • OPTIONS /

    • PutObjectLegalHold를 선택합니다

    • PutObjectRetention

    • SelectObjectContent 를 선택합니다

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

  • StorageGRID 버킷의 모든 오브젝트는 익명 사용자 또는 다른 계정에서 만든 오브젝트를 포함하여 버킷 소유자가 소유합니다.

  • Swift를 통해 StorageGRID 시스템으로 수집된 데이터 오브젝트는 S3를 통해 액세스할 수 없습니다.

다음 표에서는 StorageGRID에서 S3 REST API 오브젝트 작업을 구현하는 방법을 설명합니다.

작동 구축

DeleteObject 를 클릭합니다

MFA(Multi-Factor Authentication) 및 응답 헤더입니다 x-amz-mfa 지원되지 않습니다.

DeleteObject 요청을 처리할 때 StorageGRID는 저장된 모든 위치에서 개체의 모든 복사본을 즉시 제거하려고 시도합니다. 성공하면 StorageGRID는 즉시 클라이언트에 응답을 반환합니다. 위치를 일시적으로 사용할 수 없기 때문에 30초 이내에 모든 복사본을 제거할 수 없는 경우 StorageGRID는 제거할 복사본을 대기시킨 다음 클라이언트에 성공 여부를 표시합니다.

버전 관리

특정 버전을 제거하려면 요청자가 버킷 소유자여야 하며 를 사용해야 합니다 versionId 하위 리소스. 이 하위 리소스를 사용하면 버전이 영구적으로 삭제됩니다. 를 누릅니다 versionId 삭제 마커인 응답 헤더에 해당합니다 x-amz-delete-marker 가 로 설정된 상태로 반환됩니다 true.

  • 를 사용하지 않고 개체를 삭제한 경우 versionId 버전 지원 버킷의 하위 리소스에서는 삭제 마커가 생성됩니다. 를 클릭합니다 versionId 삭제 마커는 를 사용하여 반환됩니다 x-amz-version-id 응답 헤더 및 x-amz-delete-marker 로 설정된 응답 헤더가 반환됩니다 true.

  • 를 사용하지 않고 개체를 삭제한 경우 versionId 버전 일시 중지된 버킷의 하위 리소스는 기존 'null' 버전 또는 'null' 삭제 표식을 영구적으로 삭제하고 새 'null' 삭제 표식을 생성합니다. 를 클릭합니다 x-amz-delete-marker 로 설정된 응답 헤더가 반환됩니다 true.

  • 참고 *: 경우에 따라 객체에 대해 여러 개의 삭제 마커가 존재할 수 있습니다.

을 참조하십시오 "S3 REST API를 사용하여 S3 오브젝트 잠금을 구성합니다" 거버넌스 모드에서 오브젝트 버전을 삭제하는 방법을 알아보십시오.

DeleteObjects 를 클릭합니다

(이전에 이름이 여러 개체 삭제)

MFA(Multi-Factor Authentication) 및 응답 헤더입니다 x-amz-mfa 지원되지 않습니다.

동일한 요청 메시지에서 여러 객체를 삭제할 수 있습니다.

을 참조하십시오 "S3 REST API를 사용하여 S3 오브젝트 잠금을 구성합니다" 거버넌스 모드에서 오브젝트 버전을 삭제하는 방법을 알아보십시오.

DeleteObjectTagging 을 선택합니다

를 사용합니다 tagging 개체에서 모든 태그를 제거하는 하위 리소스입니다.

버전 관리

를 누릅니다 versionId 쿼리 매개 변수가 요청에 지정되지 않았습니다. 이 작업은 버전이 지정된 버킷에 있는 개체의 최신 버전에서 모든 태그를 삭제합니다. 개체의 현재 버전이 삭제 표식이면 와 함께 "MethodNotAllowed" 상태가 반환됩니다 x-amz-delete-marker 응답 헤더가 로 설정되었습니다 true.

GetObject 를 참조하십시오

GetObjectAcl

계정에 필요한 액세스 자격 증명이 제공된 경우 이 작업은 개체 소유자의 ID, DisplayName 및 사용 권한과 함께 긍정적인 응답을 반환합니다. 이는 소유자가 개체에 대한 모든 액세스 권한을 가지고 있음을 나타냅니다.

GetObjectLegalHold 를 참조하십시오

GetObjectRetention을 참조하십시오

GetObjectTagging

를 사용합니다 tagging 개체의 모든 태그를 반환하는 하위 리소스입니다.

버전 관리

를 누릅니다 versionId 쿼리 매개 변수가 요청에 지정되지 않았습니다. 이 작업은 버전 관리되는 버킷에서 가장 최신 버전의 개체에 있는 모든 태그를 반환합니다. 개체의 현재 버전이 삭제 표식이면 와 함께 "MethodNotAllowed" 상태가 반환됩니다 x-amz-delete-marker 응답 헤더가 로 설정되었습니다 true.

HeadObject 를 선택합니다

RestoreObject 를 선택합니다

PutObject 를 선택합니다

CopyObject 를 선택합니다

(이전에 명명된 Put Object - Copy)

PutObjectLegalHold를 선택합니다

PutObjectRetention

PutObjectTagging

를 사용합니다 tagging 기존 개체에 태그 집합을 추가하는 하위 리소스입니다.

개체 태그 제한

새 개체를 업로드할 때 태그를 추가하거나 기존 개체에 태그를 추가할 수 있습니다. StorageGRID 및 Amazon S3 모두 각 오브젝트에 대해 최대 10개의 태그를 지원합니다. 개체와 관련된 태그에는 고유한 태그 키가 있어야 합니다. 태그 키의 길이는 최대 128자의 유니코드 문자이고 태그 값의 길이는 최대 256자의 유니코드 문자일 수 있습니다. 키와 값은 대/소문자를 구분합니다.

태그 업데이트 및 수집 동작

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

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

충돌 해결

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

버전 관리

를 누릅니다 versionId 쿼리 매개 변수가 요청에 지정되지 않았습니다. 작업에서 버전 관리되는 버킷의 가장 최근 개체 버전에 태그를 추가합니다. 개체의 현재 버전이 삭제 표식이면 와 함께 "MethodNotAllowed" 상태가 반환됩니다 x-amz-delete-marker 응답 헤더가 로 설정되었습니다 true.

SelectObjectContent 를 선택합니다