S3 HeadObject 요청을 사용하여 StorageGRID의 객체에서 메타데이터를 검색합니다
변경 제안
PDF
S3 HeadObject 요청을 사용하면 객체 자체를 반환하지 않고도 객체의 메타데이터를 검색할 수 있습니다. 객체가 클라우드 스토리지 풀에 저장된 경우 HeadObject를 사용하여 객체의 전환 상태를 확인할 수 있습니다.
HeadObject 및 멀티파트 객체
멀티파트 또는 분할된 객체의 특정 부분에 대한 partNumber 요청 매개변수를 사용하여 메타데이터를 검색할 수 있습니다. x-amz-mp-parts-count 응답 요소는 객체가 몇 부분으로 구성되어 있는지를 나타냅니다.
`partNumber`을 분할/멀티파트 객체와 비분할/비멀티파트 객체 모두에 대해 1로 설정할 수 있지만, `x-amz-mp-parts-count` 응답 요소는 분할 또는 멀티파트 객체에 대해서만 반환됩니다.
사용자 메타데이터의 UTF-8 문자
StorageGRID는 사용자 정의 메타데이터에서 이스케이프된 UTF-8 문자를 구문 분석하거나 해석하지 않습니다. 사용자 정의 메타데이터에 이스케이프된 UTF-8 문자가 있는 객체에 대한 HEAD 요청은 키 이름이나 값에 인쇄할 수 없는 문자가 포함된 경우 x-amz-missing-meta 헤더를 반환하지 않습니다.
지원되는 요청 헤더
다음 요청 헤더가 지원됩니다.
-
x-amz-checksum-mode`partNumber` 매개변수와 `Range` 헤더는 HeadObject에 대한 `x-amz-checksum-mode`에서 지원되지 않습니다. 해당 매개변수와 헤더를 `x-amz-checksum-mode`가 활성화된 요청에 포함하면 StorageGRID는 응답에 체크섬 값을 반환하지 않습니다.
지원되지 않는 요청 헤더
다음 요청 헤더는 지원되지 않으며 `XNotImplemented`을(를) 반환합니다.
-
x-amz-website-redirect-location
버전 관리
If a versionId 하위 리소스가 지정되지 않은 경우, 해당 작업은 버전이 지정된 버킷에서 객체의 최신 버전을 가져옵니다. 현재 객체 버전이 삭제 마커인 경우, "찾을 수 없음" 상태가 반환되며 x-amz-delete-marker 응답 헤더가 `true`으로 설정됩니다.
고객이 제공한 암호화 키를 사용한 서버 측 암호화(SSE-C) 요청 헤더
제공된 고유 키로 객체가 암호화된 경우 이 세 가지 헤더를 모두 사용하십시오.
-
x-amz-server-side-encryption-customer-algorithm: `AES256`을(를) 지정합니다. -
x-amz-server-side-encryption-customer-key: 객체에 사용할 암호화 키를 지정하십시오. -
x-amz-server-side-encryption-customer-key-MD5: 객체의 암호화 키의 MD5 다이제스트를 지정합니다.
|
고객이 제공하는 암호화 키는 절대 저장되지 않습니다. 암호화 키를 분실하면 해당 객체도 손실됩니다. 고객이 제공한 키를 사용하여 객체 데이터를 보호하기 전에 "서버 측 암호화 사용"의 고려 사항을 검토하십시오. |
HeadObject 클라우드 스토리지 풀 객체에 대한 응답
객체가 "클라우드 스토리지 풀"에 저장된 경우 다음과 같은 응답 헤더가 반환됩니다.
-
x-amz-storage-class: GLACIER -
x-amz-restore
응답 헤더는 객체가 클라우드 스토리지 풀로 이동될 때, 선택적으로 복구 불가능한 상태로 전환될 때, 그리고 복원될 때 객체의 상태에 대한 정보를 제공합니다.
| 객체의 상태 | HeadObject에 대한 응답 |
|---|---|
StorageGRID에 수집되었지만 ILM에서 아직 평가되지 않은 객체이거나, 기존 스토리지 풀에 저장되었거나 이레이저 코딩을 사용하여 저장된 객체입니다. |
|
클라우드 스토리지 풀에 있는 객체이지만 아직 검색 불가능한 상태로 전환되지 않았습니다. |
객체가 검색 불가능한 상태로 전환될 때까지 `expiry-date`의 값은 먼 미래의 시간으로 설정됩니다. 전환 시점은 StorageGRID 시스템에서 제어하지 않습니다. |
객체가 검색할 수 없는 상태로 전환되었지만, 그리드에 적어도 하나의 복사본이 존재합니다. |
해당 값은 참고: 그리드의 복사본을 사용할 수 없는 경우(예: 스토리지 노드가 다운된 경우) 객체를 성공적으로 검색하려면 클라우드 스토리지 풀에서 복사본을 복원하기 위한 "RestoreObject" 요청을 실행해야 합니다. |
객체가 검색할 수 없는 상태로 전환되었으며, 그리드에 복사본이 존재하지 않습니다. |
|
복구 불가능한 상태에서 복원 중인 객체 |
|
객체가 클라우드 스토리지 풀에 완전히 복원되었습니다. |
`expiry-date`는 Cloud Storage Pool의 객체가 검색 불가능한 상태로 반환되는 시점을 나타냅니다. |
클라우드 스토리지 풀의 멀티파트 또는 분할된 객체
여러 부분으로 나뉜 객체를 업로드했거나 StorageGRID가 큰 객체를 여러 세그먼트로 분할한 경우, StorageGRID는 객체의 일부 또는 세그먼트를 샘플링하여 클라우드 스토리지 풀에서 해당 객체를 사용할 수 있는지 여부를 확인합니다. 경우에 따라 HeadObject 요청이 객체의 일부가 이미 복구 불가능한 상태로 전환되었거나 아직 복원되지 않은 경우에도 잘못된 결과를 x-amz-restore: ongoing-request="false" 반환할 수 있습니다.
HeadObject 및 그리드 간 복제
"그리드 페더레이션"를 사용하고 버킷에 대해 "교차 그리드 복제"가 활성화된 경우, S3 클라이언트는 HeadObject 요청을 통해 객체의 복제 상태를 확인할 수 있습니다. 응답에는 StorageGRID 관련 x-ntap-sg-cgr-replication-status 응답 헤더가 포함되며, 이 헤더에는 다음 값 중 하나가 있습니다.
| 그리드 | 복제 상태 |
|---|---|
소스 |
|
목적지 |
REPLICA: 해당 객체는 원본 그리드에서 복제되었습니다. |
|
StorageGRID는 x-amz-replication-status 헤더를 지원하지 않습니다.
|