653      技術社區[雲棲]

PostObject__關於Object操作_API 參考_對象存儲 OSS-阿裏雲

Post Object使用HTML表單上傳文件到指定bucket。Post作為Put的替代品，使得基於瀏覽器上傳文件到bucket成為可能。Post Object的消息實體通過多重表單格式（multipart/form-data）編碼，在Put Object操作中參數通過HTTP請求頭傳遞，在Post操作中參數則作為消息實體中的表單域傳遞。

Post object

請求語法

POST / HTTP/1.1 
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
User-Agent: browser_data
Content-Length：ContentLength
Content-Type: multipart/form-data; boundary=9431149156168
--9431149156168
Content-Disposition: form-data; name="key"
key
--9431149156168
Content-Disposition: form-data; name="success_action_redirect"
success_redirect
--9431149156168
Content-Disposition: form-data; name="Content-Disposition"
attachment;filename=oss_download.jpg
--9431149156168
Content-Disposition: form-data; name="x-oss-meta-uuid"
myuuid
--9431149156168
Content-Disposition: form-data; name="x-oss-meta-tag"
mytag
--9431149156168
Content-Disposition: form-data; name="OSSAccessKeyId"
access-key-id
--9431149156168
Content-Disposition: form-data; name="policy"
encoded_policy
--9431149156168
Content-Disposition: form-data; name="Signature"
signature
--9431149156168
Content-Disposition: form-data; name="file"; filename="MyFilename.jpg"
Content-Type: image/jpeg
file_content
--9431149156168
Content-Disposition: form-data; name="submit"
Upload to OSS
--9431149156168--

表單域

響應Header

響應元素(Response Elements)

細節分析

1. 進行Post操作要求對bucket有寫權限，如果bucket為public-read-write，可以不上傳簽名信息，否則要求對該操作進行簽名驗證。與Put操作不同，Post操作使用AccessKeySecret對policy進行簽名計算出簽名字符串作為Signature表單域的值，OSS會驗證該值從而判斷簽名的合法性。
2. 無論bucket是否為public-read-write，一旦上傳OSSAccessKeyId, policy, Signature表單域中的任意一個，則另兩個表單域為必選項，缺失時OSS會返回錯誤碼：InvalidArgument。
3. post操作提交表單編碼必須為“multipart/form-data”，即header中Content-Type為multipart/form-data; boundary=xxxxxx這樣的形式，boundary為邊界字符串。
4. 提交表單的URL為bucket域名即可，不需要在URL中指定object。即請求行是POST / HTTP/1.1，不能寫成POST /ObjectName HTTP/1.1
5. policy規定了該次Post請求中表單域的合法值，OSS會根據policy判斷請求的合法性，如果不合法會返回錯誤碼：AccessDenied。在檢查policy合法性時，policy中不涉及的表單域不進行檢查。
6. 表單和policy必須使用UTF-8編碼，policy為經過UTF-8編碼和base64編碼的JSON。
7. Post請求中可以包含額外的表單域，OSS會根據policy對這些表單域檢查合法性。
8. 如果用戶上傳了Content-MD5請求頭，OSS會計算body的Content-MD5並檢查一致性，如果不一致，將返回InvalidDigest錯誤碼。
9. 如果POST請求中包含Header簽名信息或URL簽名信息，OSS不會對它們做檢查。
10. 如果請求中攜帶以x-oss-meta-為前綴的表單域，則視為user meta，比如x-oss-meta-location。一個Object可以有多個類似的參數，但所有的user meta總大小不能超過8k。
11. Post請求的body總長度不允許超過5G。若文件長度過大，會返回錯誤碼：EntityTooLarge。
12. 如果上傳指定了x-oss-server-side-encryption Header請求域，則必須設置其值為AES256，否則會返回400和錯誤碼：InvalidEncryptionAlgorithmError。指定該Header後，在響應頭中也會返回該Header，OSS會對上傳的Object進行加密編碼存儲，當這個Object被下載時，響應頭中會包含x-oss-server-side-encryption，值被設置成該Object的加密算法。
13. 表單域為大小寫不敏感的，但是表單域的值為大小寫敏感的。

示例

請求示例：

POST / HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Content-Length: 344606
Content-Type: multipart/form-data; boundary=9431149156168
--9431149156168
Content-Disposition: form-data; name="key"
/user/a/${filename}
--9431149156168
Content-Disposition: form-data; name="success_action_status"
200
--9431149156168
Content-Disposition: form-data; name="Content-Disposition"
content_disposition
--9431149156168
Content-Disposition: form-data; name="x-oss-meta-uuid"
uuid
--9431149156168
Content-Disposition: form-data; name="x-oss-meta-tag"
metadata
--9431149156168
Content-Disposition: form-data; name="OSSAccessKeyId"
44CF9590006BF252F707
--9431149156168
Content-Disposition: form-data; name="policy"
eyJleHBpcmF0aW9uIjoiMjAxMy0xMi0wMVQxMjowMDowMFoiLCJjb25kaXRpb25zIjpbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDEwNDg1NzYwXSx7ImJ1Y2tldCI6ImFoYWhhIn0sIHsiQSI6ICJhIn0seyJrZXkiOiAiQUJDIn1dfQ==
--9431149156168
Content-Disposition: form-data; name="Signature"
kZoYNv66bsmc10+dcGKw5x2PRrk=
--9431149156168
Content-Disposition: form-data; name="file"; filename="MyFilename.txt"
Content-Type: text/plain
abcdefg
--9431149156168
Content-Disposition: form-data; name="submit"
Upload to OSS
--9431149156168--

HTTP/1.1 200 OK
x-oss-request-id: 61d2042d-1b68-6708-5906-33d81921362e 
Date: Fri, 24 Feb 2014 06:03:28 GMT
ETag: 5B3C1A2E053D763E1B002CC607C5A0FE
Connection: keep-alive
Content-Length: 0  
Server: AliyunOSS

{ "expiration": "2014-12-01T12:00:00.000Z",
  "conditions": [
    {"bucket": "johnsmith" },
    ["starts-with", "$key", "user/eric/"]
  ]
}