3.4. S3 오브젝트 작업
개발자는 Ceph Object Gateway를 통해 Amazon S3 API(애플리케이션 프로그래밍 인터페이스)를 사용하여 오브젝트 작업을 수행할 수 있습니다.
다음 표에는 해당 기능의 지원 상태와 함께 오브젝트에 대한 Amazon S3 기능 작업이 나열되어 있습니다.
| 기능 | 상태 |
|---|---|
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| 지원됨 | |
| Multi-Tenancy | 지원됨 |
사전 요구 사항
- 실행 중인 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 다중 영역 환경 내에서 오브젝트의 복제 경로와 관련된 중간 영역 및 모든 중간 영역을 반환합니다. 이 헤더는
GetObject및HeadObject응답에 포함됩니다.
x-rgw-replicated-at- 설명
-
개체가 현재 위치에 복제된 시기를 나타내는 타임스탬프를 반환합니다.
마지막헤더와 함께 이 헤더를 사용하여 복제를 완료할 기간을 계산할 수 있습니다.
현재 x-rgw-replicated-from 및 x-rgw-replicated-at 은 복제 영역의 s3cmd 또는 curl verify와 같은 클라이언트 툴에서 지원됩니다. 이러한 툴은 확인을 위해 radosgw-admin 명령 외에 사용할 수 있습니다. radosgw-admin 오브젝트 통계를 사용하면 BZ-2312552 헤더 키 x-rgw-replicated-from 의 알려진 문제가 있습니다.