3.5. S3 オブジェクト操作
開発者は、Ceph Object Gateway 経由で Amazon S3 アプリケーションプログラミングインターフェイス (API) を使用してオブジェクト操作を行うことができます。
以下の表は、関数のサポートステータスとともに、オブジェクトの Amazon S3 の機能操作を示しています。
機能 | 状態 |
---|---|
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
サポート対象 | |
マルチテナンシー | サポート対象 |
3.5.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
- 稼働中の Red Hat Ceph Storage クラスターがある。
- RESTful クライアント。
3.5.2. S3 get an object from a bucket リンクのコピーリンクがクリップボードにコピーされました!
バケットからオブジェクトを取得します。
構文
GET /BUCKET/OBJECT HTTP/1.1
GET /BUCKET/OBJECT HTTP/1.1
versionId
サブリソースを追加して、オブジェクトの特定のバージョンを取得します。
構文
GET /BUCKET/OBJECT?versionId=VERSION_ID HTTP/1.1
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 と一致する場合にのみ取得します。
- 有効な値
- エンティティータグ
- 必須
- いいえ
リクエストヘッダーを含む構文
レスポンスヘッダー
Content-Range
- 説明
- データ範囲 (範囲ヘッダーフィールドがリクエストに指定された場合のみを返します)。
x-amz-version-id
- 説明
- バージョン ID または Null を返します。
3.5.3. S3 get information on an object リンクのコピーリンクがクリップボードにコピーされました!
オブジェクトに関する情報を返します。この要求は Get Object 要求と同じヘッダー情報を返しますが、オブジェクトデータペイロードではなくメタデータのみが含まれます。
オブジェクトの現行バージョンを取得します。
構文
HEAD /BUCKET/OBJECT HTTP/1.1
HEAD /BUCKET/OBJECT HTTP/1.1
versionId
サブリソースを追加して、特定バージョンの情報を取得します。
構文
HEAD /BUCKET/OBJECT?versionId=VERSION_ID HTTP/1.1
HEAD /BUCKET/OBJECT?versionId=VERSION_ID HTTP/1.1
リクエストヘッダー
range
- 説明
- 取得するオブジェクトの範囲。
- 有効な値
- 範囲: bytes=beginbyte-endbyte
- 必須
- いいえ
if-modified-since
- 説明
- タイムスタンプ以降に変更した場合にのみ取得します。
- 有効な値
- Timestamp
- 必須
- いいえ
if-match
- 説明
- オブジェクトの ETag が ETag と一致する場合にのみ取得します。
- 有効な値
- エンティティータグ
- 必須
- いいえ
if-none-match
- 説明
- オブジェクトの ETag が ETag と一致する場合にのみ取得します。
- 有効な値
- エンティティータグ
- 必須
- いいえ
レスポンスヘッダー
x-amz-version-id
- 説明
- バージョン ID または Null を返します。
3.5.4. S3 put object lock リンクのコピーリンクがクリップボードにコピーされました!
put object lock API は、選択したバケットにロック設定を配置します。オブジェクトロックを使用すると、write-once-read-many(WORM) モデルを使用してオブジェクトを格納できます。オブジェクトロックは、オブジェクトが一定期間または無期限に削除または上書きされないようにします。Object Lock 設定に指定されるルールは、デフォルトで選択されるバケットにあるすべての新規オブジェクトに適用されます。
バケットを作成するときにオブジェクトロックを有効にします。有効にしないと、操作が失敗します。
構文
PUT /BUCKET?object-lock HTTP/1.1
PUT /BUCKET?object-lock HTTP/1.1
例
PUT /testbucket?object-lock HTTP/1.1
PUT /testbucket?object-lock HTTP/1.1
リクエストエンティティー
ObjectLockConfiguration
- 説明
- 要求のコンテナー。
- 型
- Container
- 必須
- はい
ObjectLockEnabled
- 説明
- このバケットにオブジェクトロック設定が有効になっているかどうかを示します。
- 型
- String
- 必須
- はい
**ルール**
- 説明
- 指定されたバケットの位置にあるオブジェクトロックルール。
- 型
- Container
- 必須
- いいえ
DefaultRetention
- 説明
- 指定されたバケットに設定される新規オブジェクトに適用されるデフォルトの保持期間。
- 型
- Container
- 必須
- いいえ
モード
- 説明
- デフォルトのオブジェクトのロック保持モード。有効な値は GOVERNANCE/COMPLIANCE です。
- 型
- Container
- 必須
- はい
Days
- 説明
- デフォルトの保持期間に指定される日数。
- 型
- 整数
- 必須
- いいえ
Years
- 説明
- デフォルトの保持期間に指定されるの年数。
- 型
- 整数
- 必須
- いいえ
HTTP レスポンス
400
- ステータスコード
-
MalformedXML
- 説明
- XML は適していません。
409
- ステータスコード
-
InvalidBucketState
- 説明
- バケットオブジェクトのロックが有効になっていません。
3.5.5. S3 get object lock リンクのコピーリンクがクリップボードにコピーされました!
get object lock API は、バケットのロック設定を取得します。
構文
GET /BUCKET?object-lock HTTP/1.1
GET /BUCKET?object-lock HTTP/1.1
例
GET /testbucket?object-lock HTTP/1.1
GET /testbucket?object-lock HTTP/1.1
レスポンスエンティティー
ObjectLockConfiguration
- 説明
- 要求のコンテナー。
- 型
- Container
- 必須
- はい
ObjectLockEnabled
- 説明
- このバケットにオブジェクトロック設定が有効になっているかどうかを示します。
- 型
- String
- 必須
- はい
**ルール**
- 説明
- 指定されたバケットの位置に、オブジェクトロックルールがあります。
- 型
- Container
- 必須
- いいえ
DefaultRetention
- 説明
- 指定されたバケットに設定される新規オブジェクトに適用されるデフォルトの保持期間。
- 型
- Container
- 必須
- いいえ
モード
- 説明
- デフォルトのオブジェクトのロック保持モード。有効な値は GOVERNANCE/COMPLIANCE です。
- 型
- Container
- 必須
- はい
Days
- 説明
- デフォルトの保持期間に指定される日数。
- 型
- 整数
- 必須
- いいえ
Years
- 説明
- デフォルトの保持期間に指定されるの年数。
- 型
- 整数
- 必須
- いいえ
3.5.6. S3 put object legal hold リンクのコピーリンクがクリップボードにコピーされました!
put object legal hold API は、選択したオブジェクトに有効な保持設定を適用します。法的な保持機能で、オブジェクトバージョンを上書きしたり、削除したりすることはできません。法的保持には関連付けられた保持期間がなく、明示的に削除されるまでそのまま維持されます。
構文
PUT /BUCKET/OBJECT?legal-hold&versionId= HTTP/1.1
PUT /BUCKET/OBJECT?legal-hold&versionId= HTTP/1.1
例
PUT /testbucket/testobject?legal-hold&versionId= HTTP/1.1
PUT /testbucket/testobject?legal-hold&versionId= HTTP/1.1
versionId
サブリソースは、オブジェクトの特定のバージョンを取得します。
リクエストエンティティー
LegalHold
- 説明
- 要求のコンテナー。
- 型
- Container
- 必須
- はい
状態
- 説明
- 指定されたオブジェクトに正当な保留があるかどうかを示します。有効な値は ON/OFF です。
- 型
- String
- 必須
- はい
3.5.7. S3 get object legal hold リンクのコピーリンクがクリップボードにコピーされました!
get object legal hold API は、オブジェクトの現在の法的保持ステータスを取得します。
構文
GET /BUCKET/OBJECT?legal-hold&versionId= HTTP/1.1
GET /BUCKET/OBJECT?legal-hold&versionId= HTTP/1.1
例
GET /testbucket/testobject?legal-hold&versionId= HTTP/1.1
GET /testbucket/testobject?legal-hold&versionId= HTTP/1.1
versionId
サブリソースは、オブジェクトの特定のバージョンを取得します。
レスポンスエンティティー
LegalHold
- 説明
- 要求のコンテナー。
- 型
- Container
- 必須
- はい
状態
- 説明
- 指定されたオブジェクトに正当な保留があるかどうかを示します。有効な値は ON/OFF です。
- 型
- String
- 必須
- はい
3.5.8. S3 put object retention リンクのコピーリンクがクリップボードにコピーされました!
put object retention API は、オブジェクトの保持設定をオブジェクトに配置します。保持期間は、オブジェクトのバージョンを一定時間保護します。ガバナンスモードとコンプライアンスモードの 2 つのモードがあります。これら 2 つの保持モードは、オブジェクトに対して異なる保護レベルを適用します。
この期間中、オブジェクトは write-once-read-many
(WORM 保護) で、上書きまたは削除することはできません。
構文
PUT /BUCKET/OBJECT?retention&versionId= HTTP/1.1
PUT /BUCKET/OBJECT?retention&versionId= HTTP/1.1
例
PUT /testbucket/testobject?retention&versionId= HTTP/1.1
PUT /testbucket/testobject?retention&versionId= HTTP/1.1
versionId
サブリソースは、オブジェクトの特定のバージョンを取得します。
リクエストエンティティー
Retention
- 説明
- 要求のコンテナー。
- 型
- Container
- 必須
- はい
モード
- 説明
- 指定されたオブジェクトの保持モード。有効な値は GOVERNANCE/COMPLIANCE です。
- 型
- String
- 必須
- はい
RetainUntilDate
- 説明
- 保持日。形式: 2020-01-05T00:00:00.000Z
- 型
- Timestamp
- 必須
- はい
3.5.9. S3 get object retention リンクのコピーリンクがクリップボードにコピーされました!
get object retention API は、オブジェクト上でオブジェクトの保持設定を取得します。
構文
GET /BUCKET/OBJECT?retention&versionId= HTTP/1.1
GET /BUCKET/OBJECT?retention&versionId= HTTP/1.1
例
GET /testbucket/testobject?retention&versionId= HTTP/1.1
GET /testbucket/testobject?retention&versionId= HTTP/1.1
versionId
サブリソースは、オブジェクトの特定のバージョンを取得します。
レスポンスエンティティー
Retention
- 説明
- 要求のコンテナー。
- 型
- Container
- 必須
- はい
モード
- 説明
- 指定されたオブジェクトの保持モード。有効な値は GOVERNANCE/COMPLIANCE です。
- 型
- String
- 必須
- はい
RetainUntilDate
- 説明
- 保持日。形式: 2020-01-05T00:00:00.000Z
- 型
- Timestamp
- 必須
- はい
3.5.10. S3 put object tagging リンクのコピーリンクがクリップボードにコピーされました!
put object tagging API は、タグをオブジェクトに関連付けます。タグはキーと値のペアです。他のバージョンのタグを配置するには、versionId
クエリーパラメーターを使用します。s3:PutObjectTagging
アクションを実行するパーミッションが必要です。デフォルトでは、バケットの所有者はこのパーミッションを持ち、このパーミッションを他のユーザーに付与できます。
構文
PUT /BUCKET/OBJECT?tagging&versionId= HTTP/1.1
PUT /BUCKET/OBJECT?tagging&versionId= HTTP/1.1
例
PUT /testbucket/testobject?tagging&versionId= HTTP/1.1
PUT /testbucket/testobject?tagging&versionId= HTTP/1.1
リクエストエンティティー
タグ付け
- 説明
- 要求のコンテナー。
- 型
- Container
- 必須
- はい
TagSet
- 説明
- タグのセットのコレクションです。
- 型
- String
- 必須
- はい
3.5.11. S3 get object tagging リンクのコピーリンクがクリップボードにコピーされました!
get object tagging API は、オブジェクトのタグを返します。デフォルトでは、GET
操作はオブジェクトの現行バージョンについての情報を返します。
バージョン付けされたバケットの場合は、バケットに複数のバージョンのオブジェクトを使用できます。他のバージョンのタグを取得するには、要求に versionId
クエリーパラメーターを追加します。
構文
GET /BUCKET/OBJECT?tagging&versionId= HTTP/1.1
GET /BUCKET/OBJECT?tagging&versionId= HTTP/1.1
例
GET /testbucket/testobject?tagging&versionId= HTTP/1.1
GET /testbucket/testobject?tagging&versionId= HTTP/1.1
3.5.12. S3 delete object tagging リンクのコピーリンクがクリップボードにコピーされました!
delete object tagging API は、指定されたオブジェクトから設定されたタグ全体を削除します。この操作を使用するには、s3:DeleteObjectTagging
アクションを実行するパーミッションが必要です。
特定のオブジェクトバージョンのタグを削除するには、リクエストに versionId
クエリーパラメーターを追加します。
構文
DELETE /BUCKET/OBJECT?tagging&versionId= HTTP/1.1
DELETE /BUCKET/OBJECT?tagging&versionId= HTTP/1.1
例
DELETE /testbucket/testobject?tagging&versionId= HTTP/1.1
DELETE /testbucket/testobject?tagging&versionId= HTTP/1.1
3.5.13. S3 add an object to a bucket リンクのコピーリンクがクリップボードにコピーされました!
オブジェクトをバケットに追加します。この操作を実行するには、バケットに書き込みパーミッションが必要です。
構文
PUT /BUCKET/OBJECT HTTP/1.1
PUT /BUCKET/OBJECT HTTP/1.1
リクエストヘッダー
content-md5
- 説明
- メッセージの base64 でエンコードされた MD-5 ハッシュ
- 有効な値
- 文字列。デフォルトや制約はありません。
- 必須
- いいえ
content-type
- 説明
- 標準の MIME タイプ。
- 有効な値
-
MIME タイプ。デフォルト:
binary/octet-stream
- 必須
- いいえ
x-amz-meta-<…>*
- 説明
- ユーザーのメタデータ。オブジェクトとともに保存されます。
- 有効な値
- 8kb までの文字列。デフォルトはありません。
- 必須
- いいえ
x-amz-acl
- 説明
- 固定 ACL。
- 有効な値
-
private
、public-read
、public-read-write
、authenticated-read
- 必須
- いいえ
レスポンスヘッダー
x-amz-version-id
- 説明
- バージョン ID または Null を返します。
3.5.14. S3 delete an object リンクのコピーリンクがクリップボードにコピーされました!
オブジェクトを削除します。含まれるバケットに WRITE パーミッションを設定する必要があります。
オブジェクトを削除します。オブジェクトのバージョン管理が有効なの場合、マーカーが作成されます。
構文
DELETE /BUCKET/OBJECT HTTP/1.1
DELETE /BUCKET/OBJECT HTTP/1.1
バージョン管理が有効な場合にオブジェクトを削除するには、versionId
サブリソースおよび削除するオブジェクトのバージョンを指定する必要があります。
DELETE /BUCKET/OBJECT?versionId=VERSION_ID HTTP/1.1
DELETE /BUCKET/OBJECT?versionId=VERSION_ID HTTP/1.1
3.5.15. S3 delete multiple objects リンクのコピーリンクがクリップボードにコピーされました!
この API 呼び出しは、バケットから複数のオブジェクトを削除します。
構文
POST /BUCKET/OBJECT?delete HTTP/1.1
POST /BUCKET/OBJECT?delete HTTP/1.1
3.5.16. S3 get an object's Access Control List (ACL) リンクのコピーリンクがクリップボードにコピーされました!
オブジェクトの現行バージョンの ACL を返します。
構文
GET /BUCKET/OBJECT?acl HTTP/1.1
GET /BUCKET/OBJECT?acl HTTP/1.1
versionId
サブリソースを追加して、特定バージョンの ACL を取得します。
構文
GET /BUCKET/OBJECT?versionId=VERSION_ID&acl HTTP/1.1
GET /BUCKET/OBJECT?versionId=VERSION_ID&acl HTTP/1.1
レスポンスヘッダー
x-amz-version-id
- 説明
- バージョン ID または Null を返します。
レスポンスエンティティー
AccessControlPolicy
- 説明
- 応答のコンテナー。
- 型
- Container
AccessControlList
- 説明
- ACL 情報用のコンテナー
- 型
- Container
Owner
- 説明
-
バケット所有者の
ID
およびDisplayName
のコンテナー。 - 型
- Container
ID
- 説明
- バケット所有者の ID。
- 型
- String
DisplayName
- 説明
- バケットの所有者の表示名。
- 型
- String
Grant
- 説明
-
Grantee
およびPermission
のコンテナー。 - 型
- Container
Grantee
- 説明
-
パーミッションを付与されるユーザーの
DisplayName
およびID
のコンテナー。 - 型
- Container
Permission
- 説明
-
Grantee
バケットに指定されるパーミッション。 - 型
- String
3.5.17. S3 set an object's Access Control List (ACL) リンクのコピーリンクがクリップボードにコピーされました!
オブジェクトの現行バージョンのオブジェクト ACL を設定します。
構文
PUT /BUCKET/OBJECT?acl
PUT /BUCKET/OBJECT?acl
リクエストエンティティー
AccessControlPolicy
- 説明
- 応答のコンテナー。
- 型
- Container
AccessControlList
- 説明
- ACL 情報用のコンテナー
- 型
- Container
Owner
- 説明
-
バケット所有者の
ID
およびDisplayName
のコンテナー。 - 型
- Container
ID
- 説明
- バケット所有者の ID。
- 型
- String
DisplayName
- 説明
- バケットの所有者の表示名。
- 型
- String
Grant
- 説明
-
Grantee
およびPermission
のコンテナー。 - 型
- Container
Grantee
- 説明
-
パーミッションを付与されるユーザーの
DisplayName
およびID
のコンテナー。 - 型
- Container
Permission
- 説明
-
Grantee
バケットに指定されるパーミッション。 - 型
- String
3.5.18. S3 copy an object リンクのコピーリンクがクリップボードにコピーされました!
オブジェクトをコピーするには、PUT
を使用して宛先バケットとオブジェクト名を指定します。
構文
PUT /DEST_BUCKET/DEST_OBJECT HTTP/1.1 x-amz-copy-source: SOURCE_BUCKET/SOURCE_OBJECT
PUT /DEST_BUCKET/DEST_OBJECT HTTP/1.1
x-amz-copy-source: SOURCE_BUCKET/SOURCE_OBJECT
リクエストヘッダー
x-amz-copy-source
- 説明
- ソースバケット名 + オブジェクト名。
- 有効な値
-
BUCKET/OBJECT
- 必須
- はい
x-amz-acl
- 説明
- 固定 ACL。
- 有効な値
-
private
、public-read
、public-read-write
、authenticated-read
- 必須
- いいえ
x-amz-copy-if-modified-since
- 説明
- タイムスタンプ以降に変更された場合のみコピーします。
- 有効な値
- Timestamp
- 必須
- いいえ
x-amz-copy-if-unmodified-since
- 説明
- タイムスタンプ以降変更されていない場合にのみコピーします。
- 有効な値
- Timestamp
- 必須
- いいえ
x-amz-copy-if-match
- 説明
- オブジェクトの ETag が ETag と一致する場合に限りコピーします。
- 有効な値
- エンティティータグ
- 必須
- いいえ
x-amz-copy-if-none-match
- 説明
- オブジェクトの ETag が ETag と一致する場合に限りコピーします。
- 有効な値
- エンティティータグ
- 必須
- いいえ
レスポンスエンティティー
CopyObjectResult
- 説明
- レスポンス要素のコンテナー。
- 型
- Container
LastModified
- 説明
- ソースオブジェクトを最後に変更した日付。
- 型
- 日付
Etag
- 説明
- 新規オブジェクトの ETag。
- 型
- String
3.5.19. S3 add an object to a bucket using HTML forms リンクのコピーリンクがクリップボードにコピーされました!
HTML フォームを使用してオブジェクトをバケットに追加します。この操作を実行するには、バケットに書き込みパーミッションが必要です。
構文
POST /BUCKET/OBJECT HTTP/1.1
POST /BUCKET/OBJECT HTTP/1.1
3.5.20. S3 determine options for a request リンクのコピーリンクがクリップボードにコピーされました!
特定の送信元、HTTP メソッド、およびヘッダーを使用して実際のリクエストを送信できるかどうかを判断するための事前要求です。
構文
OPTIONS /OBJECT HTTP/1.1
OPTIONS /OBJECT HTTP/1.1
3.5.21. S3 initiate a multipart upload リンクのコピーリンクがクリップボードにコピーされました!
複数パートからなるアップロードプロセスを開始します。追加部分の追加、パーツのリスト表示、および複数パートアップロードの完了または破棄時に指定できる UploadId
を返します。
構文
POST /BUCKET/OBJECT?uploads
POST /BUCKET/OBJECT?uploads
リクエストヘッダー
content-md5
- 説明
- メッセージの base64 でエンコードされた MD-5 ハッシュ
- 有効な値
- 文字列。デフォルトや制約はありません。
- 必須
- いいえ
content-type
- 説明
- 標準の MIME タイプ。
- 有効な値
-
MIME タイプ。デフォルト:
binary/octet-stream
- 必須
- いいえ
x-amz-meta-<…>
- 説明
- ユーザーのメタデータ。オブジェクトとともに保存されます。
- 有効な値
- 8kb までの文字列。デフォルトはありません。
- 必須
- いいえ
x-amz-acl
- 説明
- 固定 ACL。
- 有効な値
-
private
、public-read
、public-read-write
、authenticated-read
- 必須
- いいえ
レスポンスエンティティー
InitiatedMultipartUploadsResult
- 説明
- 結果のコンテナー
- 型
- Container
Bucket
- 説明
- オブジェクトの内容を受け取るバケット。
- 型
- String
キー
- 説明
-
key
リクエストパラメーターで指定されるキー (存在する場合)。 - 型
- String
UploadId
- 説明
-
upload-id
要求パラメーターで指定される ID で、マルチパートアップロードを特定します (存在する場合)。 - 型
- String
3.5.22. S3 add a part to a multipart upload リンクのコピーリンクがクリップボードにコピーされました!
マルチパートアップロードに部分を追加します。
複数パートのアップロードに部分を追加するために uploadId
サブリソースとアップロード ID を指定します。
構文
PUT /BUCKET/OBJECT?partNumber=&uploadId=UPLOAD_ID HTTP/1.1
PUT /BUCKET/OBJECT?partNumber=&uploadId=UPLOAD_ID HTTP/1.1
以下の HTTP レスポンスが返されます。
HTTP レスポンス
404
- ステータスコード
-
NoSuchUpload
- 説明
- 指定した upload-id がこのオブジェクトで開始されたアップロードと一致しません。
3.5.23. S3 list the parts of a multipart upload リンクのコピーリンクがクリップボードにコピーされました!
マルチパートアップロードの一部をリスト表示するために uploadId
サブリソースとアップロード ID を指定します。
構文
GET /BUCKET/OBJECT?uploadId=UPLOAD_ID HTTP/1.1
GET /BUCKET/OBJECT?uploadId=UPLOAD_ID HTTP/1.1
レスポンスエンティティー
InitiatedMultipartUploadsResult
- 説明
- 結果のコンテナー
- 型
- Container
Bucket
- 説明
- オブジェクトの内容を受け取るバケット。
- 型
- String
キー
- 説明
-
key
リクエストパラメーターで指定されるキー (存在する場合)。 - 型
- String
UploadId
- 説明
-
upload-id
要求パラメーターで指定される ID で、マルチパートアップロードを特定します (存在する場合)。 - 型
- String
イニシエーター
- 説明
-
アップロードを開始したユーザーの
ID
とDisplayName
が含まれます。 - 型
- Container
ID
- 説明
- イニシエーターの ID。
- 型
- String
DisplayName
- 説明
- イニシエーターの表示名。
- 型
- String
Owner
- 説明
-
アップロードしたオブジェクトを所有するユーザーの
ID
およびDisplayName
のコンテナー。 - 型
- Container
StorageClass
- 説明
-
作成されるオブジェクトを保存するために使用されるメソッド。
STANDARD
またはREDUCED_REDUNDANCY
- 型
- String
PartNumberMarker
- 説明
-
IsTruncated
がtrue
の場合に後続のリクエストで使用する部分マーカー。リストの先頭に指定します。 - 型
- String
NextPartNumberMarker
- 説明
-
IsTruncated
がtrue
の場合は、後続のリクエストで使用する次の部分マーカー。リストの末尾。 - 型
- String
IsTruncated
- 説明
-
true
の場合は、オブジェクトのアップロードコンテンツのサブセットのみが返されます。 - 型
- Boolean
部分
- 説明
-
Key
、Part
、InitiatorOwner
、StorageClass
、およびInitiated
要素のコンテナー。 - 型
- Container
PartNumber
- 説明
-
Key
、Part
、InitiatorOwner
、StorageClass
、およびInitiated
要素のコンテナー。 - 型
- 整数
ETag
- 説明
- コンポーネントのエンティティータグです。
- 型
- String
サイズ
- 説明
- アップロードした部分のサイズ。
- 型
- 整数
3.5.24. S3 assemble the uploaded parts リンクのコピーリンクがクリップボードにコピーされました!
アップロードした部分を組み立て、新規オブジェクトを作成します。これにより、複数パートのアップロードが実行されます。
複数パートからなるアップロードを完了するには、uploadId
サブリソースとアップロード ID を指定します。
構文
POST /BUCKET/OBJECT?uploadId=UPLOAD_ID HTTP/1.1
POST /BUCKET/OBJECT?uploadId=UPLOAD_ID HTTP/1.1
リクエストエンティティー
CompleteMultipartUpload
- 説明
- 1 つ以上の部分で設定されるコンテナー。
- 型
- Container
- 必須
- はい
部分
- 説明
-
PartNumber
およびETag
のコンテナー。 - 型
- Container
- 必須
- はい
PartNumber
- 説明
- 部分の識別子。
- 型
- 整数
- 必須
- はい
ETag
- 説明
- コンポーネントのエンティティータグです。
- 型
- String
- 必須
- はい
レスポンスエンティティー
CompleteMultipartUploadResult
- 説明
- 応答のコンテナー。
- 型
- Container
ロケーション
- 説明
- 新規オブジェクトのリソース識別子 (パス)。
- 型
- URI
bucket
- 説明
- 新規オブジェクトが含まれるバケットの名前。
- 型
- String
キー
- 説明
- オブジェクトのキー。
- 型
- String
ETag
- 説明
- 新規オブジェクトのエンティティータグ。
- 型
- String
3.5.25. S3 copy a multipart upload リンクのコピーリンクがクリップボードにコピーされました!
既存のオブジェクトからデータをデータソースとしてコピーして、パーツをアップロードします。
複数パートからなるアップロードコピーを実行するには、uploadId
サブリソースとアップロード ID を指定します。
構文
PUT /BUCKET/OBJECT?partNumber=PartNumber&uploadId=UPLOAD_ID HTTP/1.1 Host: cname.domain.com Authorization: AWS ACCESS_KEY:HASH_OF_HEADER_AND_SECRET
PUT /BUCKET/OBJECT?partNumber=PartNumber&uploadId=UPLOAD_ID HTTP/1.1
Host: cname.domain.com
Authorization: AWS ACCESS_KEY:HASH_OF_HEADER_AND_SECRET
リクエストヘッダー
x-amz-copy-source
- 説明
- ソースバケット名およびオブジェクト名。
- 有効な値
- BUCKET/OBJECT
- 必須
- はい
x-amz-copy-source-range
- 説明
- ソースオブジェクトからコピーするバイトの範囲。
- 有効な値
-
範囲:
bytes=first-last
(ここで、最初のおよび最後は、コピーするゼロベースのバイトオフセットです)たとえば、bytes=0-9
は、ソースの最初の 10 バイトをコピーすることを示しています。 - 必須
- いいえ
レスポンスエンティティー
CopyPartResult
- 説明
- すべてのレスポンス要素のコンテナー。
- 型
- Container
ETag
- 説明
- 新しい部分の ETag を返します。
- 型
- String
LastModified
- 説明
- 最後に変更した日付を返します。
- 型
- String
関連情報
- この機能の詳細は、Amazon S3 のサイト を参照してください。
3.5.26. S3 abort a multipart upload リンクのコピーリンクがクリップボードにコピーされました!
複数パートアップロードを中止します。
マルチパートによるアップロードを中止するために uploadId
サブリソースとアップロード ID を指定します。
構文
DELETE /BUCKET/OBJECT?uploadId=UPLOAD_ID HTTP/1.1
DELETE /BUCKET/OBJECT?uploadId=UPLOAD_ID HTTP/1.1
3.5.27. S3 Hadoop interoperability リンクのコピーリンクがクリップボードにコピーされました!
HDFS (Hadoop Distributed File System) のアクセスを必要とするデータ解析アプリケーションは、Hadoop 用の Apache S3A コネクターを使用して Ceph Object Gateway にアクセスできます。S3A コネクターは、データが Ceph Object Gateway に保存される一方で、HDFS ファイルシステムがアプリケーションへのセマンティクスを読み取りおよび書き込みする S3 互換のオブジェクトストレージを HDFS ファイルシステムとして表示するオープンソースツールです。
Ceph Object Gateway は、Hadoop 2.7.3 に同梱される S3A コネクターと完全に互換性があります。
3.5.28. 関連情報 リンクのコピーリンクがクリップボードにコピーされました!
- マルチテナンシーの詳細は、Red Hat Ceph StorageObjectGateway ガイド を参照してください。