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.os.cloud.nifty.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
