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

GetObject 요청을 사용하여 StorageGRID의 버킷에서 객체 검색

PDF

S3 GetObject 요청을 사용하여 S3 버킷에서 객체를 검색할 수 있습니다.

GetObject 및 멀티파트 객체

You can use the partNumber 요청 매개변수를 사용하여 여러 부분으로 구성된 객체 또는 분할된 객체의 특정 부분을 검색할 수 있습니다. `x-amz-mp-parts-count`응답 요소는 객체가 몇 부분으로 구성되어 있는지를 나타냅니다.

`partNumber`을 분할/멀티파트 객체와 비분할/비멀티파트 객체 모두에 대해 1로 설정할 수 있지만,  `x-amz-mp-parts-count` 응답 요소는 분할 또는 멀티파트 객체에 대해서만 반환됩니다.

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

StorageGRID는 사용자 정의 메타데이터에서 이스케이프된 UTF-8 문자를 구문 분석하거나 해석하지 않습니다. 사용자 정의 메타데이터에 이스케이프된 UTF-8 문자가 있는 객체에 대한 GET 요청은 키 이름이나 값에 인쇄할 수 없는 문자가 포함된 경우 x-amz-missing-meta 헤더를 반환하지 않습니다.

지원되는 요청 헤더

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

  • x-amz-checksum-mode: 지정 ENABLED

    `Range` 헤더는 GetObject에 대해  `x-amz-checksum-mode`와(과) 함께 지원되지 않습니다. 요청에  `Range`을(를) 포함하고  `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 다이제스트를 지정합니다.

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

클라우드 스토리지 풀 객체에 대한 GetObject의 동작

객체가 "클라우드 스토리지 풀"에 저장된 경우, GetObject 요청의 동작은 객체의 상태에 따라 달라집니다. 자세한 내용은 "HeadObject"을 참조하십시오.

참고 객체가 클라우드 스토리지 풀에 저장되어 있고 해당 객체의 복사본이 그리드에도 하나 이상 존재하는 경우, GetObject 요청은 클라우드 스토리지 풀에서 데이터를 가져오기 전에 그리드에서 데이터를 가져오려고 시도합니다.
객체의 상태 GetObject의 동작

StorageGRID에 수집되었지만 ILM에서 아직 평가되지 않은 객체이거나, 기존 스토리지 풀에 저장되었거나 이레이저 코딩을 사용하여 저장된 객체입니다.

200 OK

객체의 복사본이 검색됩니다.

클라우드 스토리지 풀에 있는 객체이지만 아직 검색 불가능한 상태로 전환되지 않았습니다.

200 OK

객체의 복사본이 검색됩니다.

객체가 복구 불가능한 상태로 전환되었습니다.

403 Forbidden, InvalidObjectState

"RestoreObject" 요청을 사용하여 객체를 검색 가능한 상태로 복원하십시오.

복구 불가능한 상태에서 복원 중인 객체

403 Forbidden, InvalidObjectState

RestoreObject 요청이 완료될 때까지 기다립니다.

객체가 클라우드 스토리지 풀에 완전히 복원되었습니다.

200 OK

객체의 복사본이 검색됩니다.

클라우드 스토리지 풀의 멀티파트 또는 분할된 객체

여러 부분으로 나뉜 객체를 업로드했거나 StorageGRID가 큰 객체를 여러 세그먼트로 분할한 경우, StorageGRID는 객체의 일부 또는 세그먼트를 샘플링하여 클라우드 스토리지 풀에서 해당 객체를 사용할 수 있는지 여부를 확인합니다. 경우에 따라 GetObject 요청이 객체의 일부가 이미 복구 불가능한 상태로 전환되었거나 아직 복원되지 않은 경우 잘못된 결과를 반환할 수 있습니다. 200 OK

이러한 경우:

  • GetObject 요청은 일부 데이터를 반환할 수 있지만 전송 도중에 중단될 수 있습니다.

  • 이후의 GetObject 요청은 `403 Forbidden`을 반환할 수 있습니다.

GetObject 및 그리드 간 복제

"그리드 페더레이션" 및 "교차 그리드 복제"가 버킷에 대해 활성화된 경우, S3 클라이언트는 GetObject 요청을 통해 객체의 복제 상태를 확인할 수 있습니다. 응답에는 StorageGRID 관련 x-ntap-sg-cgr-replication-status 응답 헤더가 포함되며, 이 헤더에는 다음 값 중 하나가 있습니다.

그리드 복제 상태

소스

  • 완료됨: 복제가 성공적으로 완료되었습니다.

  • PENDING: 해당 개체가 아직 복제되지 않았습니다.

  • FAILURE: 복제가 영구적으로 실패했습니다. 사용자가 오류를 해결해야 합니다.

목적지

REPLICA: 해당 객체는 원본 그리드에서 복제되었습니다.
참고 StorageGRID는 x-amz-replication-status 헤더를 지원하지 않습니다.