PostObject

最終更新日:2025-08-18 15:51:54

フォームベースの方法を使用してデータをアップロードします。HTMLフォームに適しており、IAMの wos:PutObject 権限が必要です。

リクエスト構文

POST / HTTP/1.1
Host: Bucket.Endpoint
Keep-Alive: 300
Connection: keep-alive
Content-Type: multipart/form-data; boundary=-9431149156168
Content-Length: length

--9431149156168
Content-Disposition: form-data; name=”key”
key
--9431149156168
Content-Disposition: form-data; name=”content-Type”
content_type
--9431149156168
Content-Disposition: form-data; name=”x-wos-meta-*”
x-wos-meta-*
--9431149156168
Content-Disposition: form-data; name=”content-MD5”
content_MD5
--9431149156168
Content-Disposition: form-data; name=”policy”
policy=
--9431149156168
Content-Disposition: form-data; name=”signature”
signature=
--9431149156168
Content-Disposition: form-data; name=”file”; filename=”MyFilename”
Content-Type: image/jpeg
fil_content
--9431149156168
Content-Disposition: form-data; name=”submit”
Upload to WCS
--9431149156168—

URIリクエストパラメータ

なし

リクエストヘッダー

Common Request Headers をご利用ください。

フォームパラメータ

パラメータ 説明 必須
key このリクエストで作成されるオブジェクトの名前。 Yes
file オブジェクトの内容。
型: バイナリまたはテキストタイプ
制限: リクエスト内に含めることができるファイルパラメータは1つのみ。
Yes
content-type MIMEタイプ。アップロードするオブジェクト内容のフォーマットを示す。 No
Content-MD5 アップロードデータのMD5値。データ送信中に破損した場合、403 SignatureDoesNotMatch エラーが返され、元の値と一致しないためアップロードは失敗します。 No
x-wos-storage-class ファイルのストレージクラスを指定。対応値: Standard(標準)、IA(低頻度)、Archive(アーカイブ)。デフォルトはバケットのストレージクラス。 No
x-wos-meta-* カスタムメタデータ。この情報はheadObjectやgetObject操作時にレスポンスヘッダとして返されます。 No

リクエストボディ

オブジェクト本体

レスポンス構文

HTTP/1.1 status_code
x-wos-request-id: request id
Content-Type: type
Location: location
Date: date
ETag: etag
Server:WS-web-server

レスポンスヘッダー

Common Response Headers に加えて以下も含まれます。

要素名

説明

Etag

アップロードデータのエンティティタグ

レスポンスボディ

なし

POST /object HTTP/1.1
Date: Fri, 18 May 2017 01:19:49 GMT
Host: bucket.s3-cn-east-1.wcsapi.com
Content-Type: multipart/form-data; boundary=---------------------------7db143f50da2
Content-Length: 2424
Content-Disposition: form-data; name="AWSAccessKeyId"
94963ba9c9ebb26620acf4d8aac40b72c5706c6a
-----------------------------7db143f50da2
Content-Disposition: form-data; name="key"
object01
-----------------------------7db143f50da2
Content-Disposition: form-data; name="acl"
public-read
-----------------------------7db143f50da2
Content-Disposition: form-data; name="content-type"
text/plain
-----------------------------7db143f50da2
Content-Disposition: form-data; name="policy"
eyJjb25kaXRpb25zIjogW3siYWNsIjogInB1YmxpYy1yZWFkIn0sIHsiYnVja2V0IjogIndzdGVzdC0yIn0sIHsia2V5IjogInYydDEudHh0In0sIFsiY29udGVudC1sZW5ndGgtcmFuZ2UiLCAxMDQ4NTc5LCAxMDQ4NTc2MF1dLCAiZXhwaXJhdGlvbiI6ICIyMDE3LTEyLTEzVDA3OjU0OjU5LjEzWiJ9
-----------------------------7db143f50da2
Content-Disposition: form-data; name="signature"
+c+e164E4cZ7J1WEVp/BKEI91bs=
-----------------------------7db143f50da2
Content-Disposition: form-data; name="file"; filename="C:\Testtools\UpLoadFiles\object
\1024Bytes.txt"
Content-Type: text/plain
01234567890
-----------------------------7db143f50da2

HTTP/1 100 Continue
HTTP/1 200 OK
x-wos-request-id: 90E2BA00C26C00000133B442A90063FD
Date: Fri, 18 May 2017 01:20:27 GMT
ETag: "ab7abb0da4bca5323ab6119bb5dcd296"
Content-Length: 0
Connection: close
Server: WS-Web-Server