Object Storage Service：PostObject

注意事項

• 要通過HTML表單上傳的方式上傳檔案，您必須有oss:PutObject許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

• 通過PostObject上傳的Object大小不能超過5 GB。

• Post請求需要對Bucket擁有寫入權限。如果Bucket為public-read-write，可以不上傳簽名資訊，否則要求對該操作進行簽名驗證。

• 與Put操作不同，Post操作使用AccessKey Secret對policy進行簽名，計算出簽名字串作為Signature表單域的值，OSS通過驗證該值從而判斷簽名的合法性。

• 提交表單的URL為Bucket網域名稱，不需要在URL中指定Object。即請求行是POST / HTTP/1.1，不能寫為POST /ObjectName HTTP/1.1。

• 如果POST請求中包含Header簽名資訊或URL簽名資訊，OSS不會對此類資訊做檢查。

版本控制

在開啟了版本控制的Bucket中發起PostObject請求時，OSS將為新添加的Object自動產生唯一的版本ID，並在響應Header中通過x-oss-version-id的形式返回。

在暫停了版本控制的Bucket中發起PostObject請求時，OSS將為新添加的Object自動產生一個null的版本ID，並在響應Header中通過x-oss-version-id的形式返回。同一個Object僅允許一個null的版本ID。

請求文法

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--

要求標頭

此介面還需要包含Host、Date等公用要求標頭。更多資訊，請參見公用要求標頭（Common Request Headers）。

表單元素

以下表格列舉了POST V1和V4簽名共有的表單元素。關於POST V4簽名專屬的表單元素，請參見V4簽名表單。關於POST V1簽名專屬的表單元素，請參見V1簽名表單。

回應標頭

此介面還涉及其他公用回應標頭，例如Date、x-oss-request-id等。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

樣本

• 請求樣本：

  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/objectName.txt
  --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"
  44CF9590006BF252****
  --9431149156168
  Content-Disposition: form-data; name="policy"
  eyJleHBpcmF0aW9uIjoiMjAxMy0xMi0wMVQxMjowMDowMFoiLCJjb25kaXRpb25zIjpbWyJjb250ZW50LWxlbmd0aC1yYW5nZSIsIDAsIDEwNDg1NzYwXSx7ImJ1Y2tldCI6ImFoYWhhIn0sIHsiQSI6ICJhIn0seyJrZXkiOiAiQUJDIn1dfQ==
  --9431149156168
  Content-Disposition: form-data; name="Signature"
  kZoYNv66bsmc10+dcGKw5x2P****
  --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: "5B3C1A2E053D763E1B002CC607C5****"
  Connection: keep-alive
  Content-Length: 0
  x-oss-hash-crc64ecma: 316181249502703****
  Content-MD5: 1B2M2Y8AsgTpgAmY7PhC****
  Server: AliyunOSS

錯誤碼

POST policy

policy表單域是一種安全性原則，用於定義通過HTML表單上傳檔案到OSS時的許可權限制和約束條件。policy表單域通過JSON格式定義，通過多項參數限制上傳操作，例如允許上傳的Bucket名稱、Object首碼、有效期間、允許的HTTP方法、上傳內容的大小限制、內容類型限制等。

• 關於POST請求V4簽名的policy詳細介紹，請參見POST請求V4簽名的policy

• 關於POST請求V1簽名的policy詳細介紹，請參見POST請求V1簽名的policy。

POST signature

POST signature是指在使用PostObject上傳方式時，為保證上傳請求的安全性，OSS要求每個上傳請求都攜帶一個簽名（Signature），用於確保上傳請求的合法性和安全性。

• 關於POST請求V4簽名的詳細介紹，請參見POST請求V4簽名。

• 關於POST請求V1簽名的詳細介紹，請參見POST請求V1簽名。

常見問題

報錯Your proposed upload exceeds the maximum allowed size.如何處理？

• 問題原因：上傳檔案的大小超出content-length-range指定的檔案大小範圍。

• 解決方案：content-length-range用於指定上傳檔案的最小和最大允許大小，單位為位元組。例如，您需要上傳的檔案大小為1 GB，則content-length-range可以設定為["content-length-range", 1, 1073741824]。

更多參考

• 關於Web端表單直傳OSS的樣本，請參見JavaScript用戶端簽名直傳。

• 關於調用PostObject介面的常見錯誤及解決方案，請參見PostObject常見錯誤及排查。