処理概要

POST ObjectはHTML Formsを使って指定bucketにobjectを追加します。POST Objectはブラウザでbucketにobjectを追加するPUT Objectの代替手段です。パラメタはHTTPヘッダを経由してPUTされる代わりにmultipart/form-dataでエンコード済メッセージボディとしてPOSTされます。objectをbucketに書き込む権限が必要です。

S3は断片的なobjectを保存しません。成功を示すレスポンスを受け取ったら、objectのすべての内容を保存し終えたことになります。

リクエスト

リクエストパラメタ

なし

リクエストヘッダー

なし

リクエストボディ

なし

フォームフィールド

下記のフィールドが利用できます。

Name	Type	Description	Required
AWSAccessKeyId	string	ポリシーの制約を満たし、anonymous user アクセスを許可するbucketの所有者のaccess key。	Conditional
acl	string	アクセスコントロールリスト（ACL）を指定します。無効なACLが設定された時、エラーが生成されます。	No
Cache-Control, Content-Type, Content-Disposition, Content-Encoding, Expires	–	使用不可	No
file	file or text content	ファイルかテキストの内容	Yes
key	string	アップロード済のobjectのキー名	Yes
policy	string	セキュリティポリシーはリクエストで何が許可されているか記述します。ポリシー書き込み可能bucketでのみ、ポリシー無指定リクエストはanonymousに対するアクセスを許可します。	Conditional
success_action_redirect, redirect	–	使用不可	No
success_action_status	string	success_action_redirectが指定されていない時、アップロードに成功した時にこのステータスコードをクライアントに返します。	No
x-amz-storage-class	–	使用不可	No
x-amz-meta-*	string	この接頭辞で始まるヘッダーはユーザー定義メタデータです。それぞれKey-Valueペアで扱います。S3はユーザー定義メタデータに対して検証や解釈を行いません。詳しい説明は、PUT Objectを参照してください。	No
x-amz-security-token	–	使用不可	No
x-amz-website_-redirect-location	–	使用不可	No

リクエストサンプル

POST /sample-bucket/ HTTP/1.1
Host: 192.168.0.1
Content-Type: multipart/form-data; boundary=----WebKitFormBoundarySMtV8xqFlMjoGhd5
Connection: keep-alive
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_4) AppleWebKit/600.7.12 (KHTML, like Gecko) Version/8.0.7 Safari/600.7.12
Content-Length: 1055
Accept-Language: ja-jp
Accept-Encoding: gzip, deflate


------WebKitFormBoundarySMtV8xqFlMjoGhd5
Content-Disposition: form-data; name="key"

sample-object.txt
------WebKitFormBoundarySMtV8xqFlMjoGhd5
Content-Disposition: form-data; name="AWSAccessKeyId"

EXAMPLEjU2So5By3H5v2
------WebKitFormBoundarySMtV8xqFlMjoGhd5
Content-Disposition: form-data; name="Policy"

eyJleHBpcmF0aW9uIjoiMjAxNi0wMy0xNVQwOTowMDowMC4wMDBaIiwKICAiY29uZGl0aW9ucyI6WwogICAgeyJidWNrZXQiOiAic2FtcGxlLWJ1Y2tldCIgfSwKICAgIFsic3RhcnRzLXdpdGgiLCAiJGtleSIsICJzYW1wbGUiXQogIF0KfQo=
------WebKitFormBoundarySMtV8xqFlMjoGhd5
Content-Disposition: form-data; name="Signature"

EXAMPLErJQb2AGPtLpAfIAlzyxE=
------WebKitFormBoundarySMtV8xqFlMjoGhd5
Content-Disposition: form-data; name="file"; filename="sample-object.txt"
Content-Type: text/plain


------WebKitFormBoundarySMtV8xqFlMjoGhd5
Content-Disposition: form-data; name="submit"

Upload to Amazon S3
------WebKitFormBoundarySMtV8xqFlMjoGhd5--

レスポンス

レスポンスヘッダ

このオペレーションはすべての操作に共通するレスポンスヘッダのみを使用しています。詳細については、一般的なレスポンスヘッダを参照してください。

Name	Type	Description
x-amz-expiration	–	使用不可
success_action_redirect, redirect	–	使用不可
x-amz-version-id	–	使用不可

レスポンスボディ

なし

レスポンスサンプル

HTTP/1.1 204 No Content
Date: Tue, 01 Sep 2015 10:00:00 GMT
X-Clv-Request-Id: 01234567-89ab-cdef-0123-456789abcdef
Accept-Ranges: bytes
Server: Cleversafe/3.5.1.0
X-Clv-S3-Version: 2.4
x-amz-request-id: 01234567-89ab-cdef-0123-456789abcdef
ETag: "abcdef0123456789abcdef0123456789"
Location: http://192.168.0.1/sample-bucket/sample-object.txt