353      小米MIX

PostObject錯誤及排查___常見錯誤及排除_最佳實踐_對象存儲 OSS-阿裏雲

PostObject簡介

PostObject使用表單上傳文件到OSS。PostObject的消息實體通過 多重表單格式multipart/form-data 編碼，詳細說明請參看 RFC 2388。Put Object中參數通過HTTP請求頭傳遞，Post Object參數則作為消息體的表單域傳遞。

Post Object消息包括消息頭（Header）和消息體（Body）。Header和Body之間，由rn--{boundary}分割。Body由一係列的表單域構成，表單域格式如下： Content-Disposition: form-data; name="{key}"rnrn{value}rn--{boundary}。 常見的Header有Host、User-Agent、Content-Length、Content-Type、Content-MD5等，表單域字段有key、OSSAccessKeyId、Signature、Content-Disposition、object meta(x-oss-meta-*)、x-oss-security-token、其它HTTP Header(Cache-Control/Content-Type/Cache-Control/Content-Type/Content-Disposition/Content-Encoding/Expires/Content-Encoding/Expires)、file等。表單域中file必須是最後一個。

更多詳細的介紹請參看 Post Object 。

PostObject常見錯誤

PostObject常見錯誤見下表：

PutObject表單域格式

PutObject請求格式，有以下注意點：

• Header一定要有 Content-Type: multipart/form-data; boundary={boundary}。
• Header和body之間由 rn--{boundary} 分割。
• 表單域格式 Content-Disposition: form-data; name="{key}"rnrn{value}rn--{boundary}。
• 表單域 file 必須為最後一個表單域。
• 表單域名稱大小寫敏感，如policy、key、file、OSSAccessKeyId、OSSAccessKeyId、Content-Disposition。
• Bucket為 public-read-write 時，可以不指定表單域OSSAccessKeyId、policy、Signature；一旦指定OSSAccessKeyId、policy、 Signature中的任意一個，無論bucket是否為public-read-write，則另兩個必須指定。

下麵是PostObject請求的示例：

POST / HTTP/1.1
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; zh-CN; rv:1.9.2.6)
Content-Type: multipart/form-data; boundary=9431149156168
Host: mingdi-hz.oss-cn-hangzhou.aliyuncs.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive
Content-Length: 5052
--9431149156168
Content-Disposition: form-data; name="key"
test-key
--9431149156168
Content-Disposition: form-data; name="Content-Disposition"
attachment;filename=D:img1.png
--9431149156168
Content-Disposition: form-data; name="OSSAccessKeyId"
2NeL********j2Eb

提示：

• 上麵示例請求中rn顯示為新行，即換行，後麵的示例請求類似。
• 上麵的示例為請求的部分內容，完整的請求請參看 Post Object 。

{
    "expiration": "2018-01-01T12:00:00.000Z",
    "conditions": [
        ["content-length-range", 0, 104857600]
    ]
}

Signature = base64(hmac-sha1(AccessKeySecret, base64(policy)))

Content-Disposition: form-data; name="Signature"
{signature}
--9431149156168

Content-Disposition: form-data; name="key"
{key}
--9431149156168

Content-Disposition: form-data; name="file"; filename="images.png"
Content-Type: image/png
{file-content}
--9431149156168

Content-Disposition: form-data; name="file"; filename="images.png"
Content-Type: image/png
{file-content}
--9431149156168

POST / HTTP/1.1
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 6.1; zh-CN; rv:1.9.2.6)
Content-Type: multipart/form-data; boundary=9431149156168
Content-MD5: tdqHe4hT/TuKb7Y4by+nJg==
Host: mingdi-hz.oss-cn-hangzhou.aliyuncs.com
Accept: text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
Connection: keep-alive
Content-Length: 5246
--9431149156168

Content-Disposition: form-data; name="Signature"
5L0+KaeugxYygfqWLJLoy0ehOmA=
--9431149156168
Content-Disposition: form-data; name="x-oss-security-token"
{Token}
--9431149156168

Content-Disposition: form-data; name="callback"
eyJjYWxsYmFja0JvZHlUeXBlIjogImFwcGxpY2F0aW9uL3gtd3d3LWZvcm0tdXJsZW5jb2RlZCIsICJjYWxsYmFja0JvZHkiOiAiZmlsZW5hbWU9JHtvYmplY3R9JnNpemU9JHtzaXplfSZtaW1lVHlwZT0ke21pbWVUeXBlfSIsICJjYWxsYmFja1VybCI6ICJodHRwOi8vb3NzLWRlbW8uYWxpeXVuY3MuY29tOjIzNDUwIn0=
--9431149156168

Content-Disposition: form-data; name="x:var1"
{var1-value}
--9431149156168

Content-Disposition: form-data; name="file"; filename="images.png"
Content-Type: image/png
Content-Transfer-Encoding: base64
{file-content}
--9431149156168

Content-Disposition: form-data; name="x-oss-meta-uuid"
{uuid}
--9431149156168
Content-Disposition: form-data; name="x-oss-meta-tag"
{tag}
--9431149156168

{
    "expiration": "2018-01-01T12:00:00.000Z",
    "conditions": [
        ["eq", "$bucket", "md-hz"],
        ["starts-with", "$key", "md/conf/"],
        ["content-length-range", 0, 104857600]
    ]
}