KDDIクラウドプラットフォームサービス ナレッジサイト

  • HOME
  • 開発者ガイドブック(APIリファレンス)
  • オブジェクトストレージ
  • サービス操作
  • オブジェクト操作
  • POST Object

POST Object

処理概要

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
2022/07/06 2022/07/06