本文へジャンプします。

Put Object

処理概要

バケット内にオブジェクトを作成します。
リクエストヘッダーにContent-MD5を指定した場合、ネットワーク転送などによりデータが破損していないかどうか確認を行います。

作成できるオブジェクトサイズは、2GB未満です。

  • ※2GB以上のファイルをアップロードする場合はマルチアップロード機能をご利用ください。

バージョン管理

バケットのバージョニング設定により、作成されるオブジェクトは以下の通りとなります。

バージョニング設定 オブジェクトの状態
Enabled 新規作成(既存の同一名オブジェクトはバージョン管理されます)
Suspended 上書き更新 (すでにバージョン管理されているオブジェクトは現状のまま)
設定なし 上書き更新

指定するパラメーター

必要なパラメーターはありません。

指定するヘッダー

ヘッダー 説明 必須 サンプル値
Content-Length オブジェクトサイズ
Type : Int
 
Content-Type MIMEタイプ
Type : String
   
Content-MD5 オブジェクトのMD5ダイジェスト
Type : String
   
x-nifty-acl CannedACL
Type : String
Default : private
値 : private | public-read | authenticated-read
   
x-nifty-meta- オブジェクトのメタデータ
Type : String
   

指定するボディ

オブジェクトデータ

応答ヘッダー

ヘッダー 説明 必須 サンプル値
x-nifty-version-id オブジェクトのバージョンID
Type : int
  999122348912293847

応答フィールド

応答フィールドはありません。

リクエストサンプル

PUT /sample.txt HTTP/1.1
Host: my-first-bucket.ncss.nifty.com
Date: Thu, 29 Sep 2011 00:00:00 GMT
Authorization: NIFTY 07cbb45fc128390123f4:jUgOMOxiuSXIn1MX6NPlpASWsAk=
Content-Length: 138
Content-MD5: 62cff0140e0931c345c25795689032ca
Content-Type: application/octet-stream
x-nifty-meta-alphabet: abcdefghijklmnopqrstuvwxyz

<Object Data>

応答サンプル(バージョニング設定なし)

HTTP/1.1 200 OK
x-nifty-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
ETag: 62cff0140e0931c345c25795689032ca

応答サンプル(バージョニング設定あり)

HTTP/1.1 200 OK
x-nifty-request-id: 9d11265a-4516-3077-bfcd-89b0e847a2ef
x-nifty-version-id: 999122348912293847
ETag: 62cff0140e0931c345c25795689032ca

推奨画面サイズ 1024×768 以上