3.4. S3 오브젝트 작업


개발자는 Ceph Object Gateway를 통해 Amazon S3 API(애플리케이션 프로그래밍 인터페이스)를 사용하여 오브젝트 작업을 수행할 수 있습니다.

다음 표에는 해당 기능의 지원 상태와 함께 오브젝트에 대한 Amazon S3 기능 작업이 나열되어 있습니다.

사전 요구 사항

  • 실행 중인 Red Hat Ceph Storage 클러스터.
  • RESTful 클라이언트입니다.

3.4.1. S3 버킷에서 오브젝트 가져오기

버킷에서 오브젝트를 검색합니다.

구문

GET /BUCKET/OBJECT HTTP/1.1

versionId 하위 리소스를 추가하여 특정 버전의 오브젝트를 검색합니다.

구문

GET /BUCKET/OBJECT?versionId=VERSION_ID HTTP/1.1

요청 헤더

partNumber
설명
읽을 개체의 일부입니다. 이렇게 하면 지정된 부분에 대해 범위가 지정된 GET 요청이 활성화됩니다. 이 요청을 사용하면 오브젝트의 일부만 다운로드하는 데 유용합니다.
유효한 값
1에서 10,000 사이의 양의 정수입니다.
필수 항목
없음
범위
설명

검색할 오브젝트의 범위입니다.

참고

GET 요청당 여러 데이터 범위가 지원되지 않습니다.

유효한 값
Range:bytes=beginbyte-endbyte
필수 항목
없음
if-modified-since
설명
타임스탬프 이후 수정된 경우에만 가져옵니다.
유효한 값
Timestamp
필수 항목
없음
if-unmodified-since
설명
타임스탬프 이후 수정되지 않은 경우에만 가져옵니다.
유효한 값
Timestamp
필수 항목
없음
if-match
설명
오브젝트 ETag가 ETag와 일치하는 경우에만 가져옵니다.
유효한 값
엔터티 태그
필수 항목
없음
if-none-match
설명
개체 ETag가 ETag와 일치하지 않는 경우에만 가져옵니다.
유효한 값
엔터티 태그
필수 항목
없음

요청 헤더가 있는 Sytnax

GET /BUCKET/OBJECT?partNumber=PARTNUMBER&versionId=VersionId HTTP/1.1
Host: Bucket.s3.amazonaws.com
If-Match: IfMatch
If-Modified-Since: IfModifiedSince
If-None-Match: IfNoneMatch
If-Unmodified-Since: IfUnmodifiedSince
Range: Range

응답 헤더

content-Range
설명
데이터 범위는 요청에 range 헤더 필드가 지정된 경우에만 반환됩니다.
x-amz-version-id
설명
버전 ID 또는 null을 반환합니다.
x-rgw-replicated-from
설명
Ceph 다중 영역 환경 내에서 오브젝트의 복제 경로와 관련된 중간 영역 및 모든 중간 영역을 반환합니다. 이 헤더는 GetObjectHeadObject 응답에 포함됩니다.
x-rgw-replicated-at
설명
개체가 현재 위치에 복제된 시기를 나타내는 타임스탬프를 반환합니다. 마지막 헤더와 함께 이 헤더를 사용하여 복제를 완료할 기간을 계산할 수 있습니다.
참고

현재 x-rgw-replicated-fromx-rgw-replicated-at 은 복제 영역의 s3cmd 또는 curl verify와 같은 클라이언트 툴에서 지원됩니다. 이러한 툴은 확인을 위해 radosgw-admin 명령 외에 사용할 수 있습니다. radosgw-admin 오브젝트 통계를 사용하면 BZ-2312552 헤더 키 x-rgw-replicated-from 의 알려진 문제가 있습니다.

Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동