Put Object
処理概要
バケット内にオブジェクトを作成します。
リクエストヘッダーにContent-MD5を指定した場合、ネットワーク転送などによりデータが破損していないかどうか確認を行います。
作成できるオブジェクトサイズは、2GB未満です。
- ※2GB以上のファイルをアップロードする場合はマルチアップロード機能をご利用ください。
バージョン管理
バケットのバージョニング設定により、作成されるオブジェクトは以下の通りとなります。
バージョニング設定 | オブジェクトの状態 |
---|---|
Enabled | 新規作成(既存の同一名オブジェクトはバージョン管理されます) |
Suspended | 上書き更新 (すでにバージョン管理されているオブジェクトは現状のまま) |
設定なし | 上書き更新 |
指定するパラメーター
必要なパラメーターはありません。
指定するヘッダー
ヘッダー | 説明 | 必須 | サンプル値 |
---|---|---|---|
Content-Length | オブジェクトサイズ Type : Int |
○ | |
Content-Type | MIMEタイプ Type : String |
||
Content-MD5 | オブジェクトのMD5ダイジェスト Type : String |
||
x-amz-acl | CannedACL Type : String Default : private 値 : private | public-read | authenticated-read |
||
x-amz-meta- | オブジェクトのメタデータ Type : String |
指定するボディ
オブジェクトデータ
応答ヘッダー
ヘッダー | 説明 | 必須 | サンプル値 |
---|---|---|---|
x-amz-version-id | オブジェクトのバージョンID Type : int |
999122348912293847 |
応答フィールド
応答フィールドはありません。
リクエストサンプル
PUT /sample.txt HTTP/1.1
Host: my-first-bucket.jp-east-2.storage.api.nifcloud.com
Date: Wed, 29 Jun 2016 00:00:00 GMT
Authorization: AWS 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 138
Content-MD5: 62cff0140e0931c345c25795689032ca
Content-Type: application/octet-stream
x-amz-meta-alphabet: abcdefghijklmnopqrstuvwxyz
<Object Data>
応答サンプル(バージョニング設定なし)
HTTP/1.1 200 OK
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
ETag: 62cff0140e0931c345c25795689032ca
応答サンプル(バージョニング設定あり)
HTTP/1.1 200 OK
x-amz-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
x-amz-version-id: 999122348912293847
ETag: 62cff0140e0931c345c25795689032ca