3.4. S3 オブジェクト操作
開発者は、Ceph Object Gateway 経由で Amazon S3 アプリケーションプログラミングインターフェイス (API) を使用してオブジェクト操作を行うことができます。
以下の表は、関数のサポートステータスとともに、オブジェクトの Amazon S3 の機能操作を示しています。
| 機能 | 状態 |
|---|---|
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| サポート対象 | |
| マルチテナンシー | サポート対象 |
前提条件
- 稼働中の Red Hat Ceph Storage クラスターがある。
- RESTful クライアント。
3.4.1. S3 get an object from a bucket リンクのコピーリンクがクリップボードにコピーされました!
バケットからオブジェクトを取得します。
構文
GET /BUCKET/OBJECT HTTP/1.1
versionId サブリソースを追加して、オブジェクトの特定のバージョンを取得します。
構文
GET /BUCKET/OBJECT?versionId=VERSION_ID HTTP/1.1
リクエストヘッダー
partNumber- 説明
-
読み取られるオブジェクトのパーツ番号。これにより、指定した部分に対する範囲指定の
GETリクエストが有効になります。このリクエストは、オブジェクトの一部だけをダウンロードする場合に便利です。 - 有効な値
- 1 から 10,000 までの正の整数。
- 必須
- いいえ
range- 説明
取得するオブジェクトの範囲。
注記各 GET リクエストで複数のデータ範囲を指定することはサポートされていません。
- 有効な値
- 範囲: bytes=beginbyte-endbyte
- 必須
- いいえ
if-modified-since- 説明
- タイムスタンプ以降に変更した場合にのみ取得します。
- 有効な値
- Timestamp
- 必須
- いいえ
if-unmodified-since- 説明
- タイムスタンプ以降変更されていない場合にのみ取得します。
- 有効な値
- Timestamp
- 必須
- いいえ
if-match- 説明
- オブジェクトの ETag が ETag と一致する場合にのみ取得します。
- 有効な値
- エンティティータグ
- 必須
- いいえ
if-none-match- 説明
- オブジェクトの ETag が ETag と一致しない場合にのみ取得します。
- 有効な値
- エンティティータグ
- 必須
- いいえ
リクエストヘッダーを含む構文
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- 説明
- データ範囲 (範囲ヘッダーフィールドがリクエストに指定された場合のみを返します)。
x-amz-version-id- 説明
- バージョン ID または Null を返します。
x-rgw-replicated-from- 説明
-
Ceph マルチゾーン環境内のオブジェクトのレプリケーションパスに関係するソースゾーンと中間ゾーンを返します。このヘッダーは、
GetObjectおよびHeadObject応答に含まれます。
x-rgw-replicated-at- 説明
-
オブジェクトが現在のロケーションにレプリケートされた日時を示すタイムスタンプを返します。このヘッダーを
Last-Modifiedヘッダーと併用することで、レプリケーションが完了するまでの期間を計算できます。
現在のところ、x-rgw-replicated-from と x-rgw-replicated-at は、レプリケートされたゾーンで s3cmd や curl verify などのクライアントツールによってサポートされています。これらのツールは、検証のために radosgw-admin コマンドに加えて使用できます。radosgw-admin オブジェクト stat には、ヘッダーキー x-rgw-replicated-from が欠落しているという既知の問題 BZ-2312552 があります。