如何实现PostObject错误及排查?-问答-阿里云开发者社区-阿里云

开发者社区> 问答> 正文

如何实现PostObject错误及排查?

青衫无名 2017-10-23 14:46:45 3672


PostObject简介


PostObject使用表单上传文件到OSS。PostObject的消息实体通过 [backcolor=transparent]多重表单格式multipart/form-data 编码,详细说明请参看 RFC 2388。PostObject中参数通过HTTP请求头传递,Post Object参数则作为消息体的表单域传递。
Post Object消息包括消息头(Header)和消息体(Body)。Header和Body之间,由\r\n--{boundary}分割。Body由一系列的表单域构成,表单域格式如下:Content-Disposition: form-data; name="{key}"\r\n\r\n{value}\r\n--{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常见错误见下表:
序号错误原因解法
1ErrorCode: MalformedPOSTRequest ErrorMessage: The body of your POST request is not well-formed multipart/form-data表单域格式不符合要求表单域格式请参看表后的 [backcolor=transparent]PostObject表单域格式
2ErrorCode: InvalidAccessKeyId ErrorMessage: The OSS Access Key Id you provided does not exist in our records.AccessKeyID禁用或不存在,或者过期的临时用户AccessKeyID,或者临时用户没有提供STS Token排查方法请参看 InvalidAccessKeyId错误排查
3ErrorCode: AccessDenied ErrorMessage: Invalid according to Policy: Policy expired.表单域policy中的expiration过期请调整policy中的expiration,注意expiration的格式 [backcolor=transparent]ISO8601 GMT
4ErrorCode: AccessDenied ErrorMessage: SignatureDoesNotMatch The request signature we calculated does not match the signature you provided. Check your key and signing method.签名错误签名方法请参看下面的 [backcolor=transparent]PostObject的签名
5ErrorCode: InvalidPolicyDocument ErrorMessage: Invalid Policy: Invalid Simple-Condition: Simple-Conditions must have exactly one property specified.请求中policy至少包含一个condition请参看表后的 [backcolor=transparent]PostObject的Policy格式
6ErrorCode: InvalidPolicyDocument ErrorMessage: Invalid Policy: Invalid JSON: unknown char e请求中的policy格式不正确请检查policy格式,"是否加缺失,转义字符是否加\
7ErrorCode: InvalidPolicyDocument ErrorMessage: Invalid Policy: Invalid JSON: , or ] expected请求中的policy格式不正确请检查policy中是否缺少 , 或 ]
8ErrorCode: AccessDenied ErrorMessage: Invalid according to Policy: Policy Condition failed: [“starts-with”, “$key”, “user/eric/“]请求指定的key与policy限定的不符请检查请求中表单域key的值
9ErrorCode: AccessDenied ErrorMessage: Invalid according to Policy: Policy Condition failed: [“eq”, “$bucket”, “mingdi-bjx”]请求指定bucket与policy限定的不符请检查endpoint中的bucket的值
10ErrorCode: AccessDenied ErrorMessage: Invalid according to Policy: Policy Condition failed: [“starts-with”, “$x-oss-meta-prop”, “prop-“]请求指定的文件元数据x-oss-meta-prop与policy限定的不符请检查请求中的x-oss-meta-prop的值
11ErrorCode: AccessDenied ErrorMessage: Invalid according to Policy: Policy Condition failed: [“eq”, “${field}”, “${value}”]表单域中指定的{field}与policy中限定的值不符,或者在请求中没有指定请检查请求中的{field}的值
12ErrorCode: AccessDenied ErrorMessage: You have no right to access this object because of bucket acl.当前用户无权限请参看 OSS权限问题及排查
13ErrorCode: InvalidArgument ErrorMessage: The bucket POST must contain the specified ‘key’. If it is specified, please check the order of the fields表单域没有指定key,或者放在了表单域file后请添加表单域key或调整顺序


PostObject表单域格式


PostObject请求格式,有以下注意点:
  • Header一定要有 Content-Type: multipart/form-data; boundary={boundary}。
  • Header和body之间由 \r\n--{boundary} 分割。
  • 表单域格式 Content-Disposition: form-data; name="{key}"\r\n\r\n{value}\r\n--{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:\img\1.png
--9431149156168
Content-Disposition: form-data; name="OSSAccessKeyId"
2NeL********j2Eb


提示:
  • 上面示例请求中\r\n显示为新行,即换行,后面的示例请求类似。
  • 上面的示例为请求的部分内容,完整的请求请参看 Post Object

如果您还有疑问,请参考示例代码: 

PostObject的Policy格式


PostObject请求的 policy 表单域用于验证请求的合法性,声明了PostObject请求必须满足的条件。限定条件为:
  • UTF-8格式的Json文本,经过base64编码后放在表单域policy中。
  • Policy中必须包含expiration和condtions,其中condtions至少有一项。

下面是base64编码前的policy示例: {
    "expiration": "2018-01-01T12:00:00.000Z",
    "conditions": [
        ["content-length-range", 0, 104857600]
    ]
}


expiration项指定了请求的过期时间, ISO8601 GMT 时间格式;如 2018-01-01T12:00:00.000Z指定请求必须发生在2018年1月1日12点前。
Post Policy支持的限定条件(Conditions)如下:
名称描述示例
bucket上传文件的Bucket名称。支持精确匹配方式。{“bucket”: “johnsmith” } 或 [“eq”, “$bucket”, “johnsmith”]
key上传文件的名称。支持精确匹配和前缀匹配方式。[“starts-with”, “$key”, “user/etc/“]
content-length-range上传文件允许的最小、最大长度。[“content-length-range”, 0, 104857600]
x-oss-meta-*指定的object meta。支持精确匹配和前缀匹配方式。[“starts-with”, “$x-oss-meta-prop”, “prop-“]
success_action_redirect上传成功后的跳转URL地址。支持精确匹配和前缀匹配方式。[“starts-with”, “$success_action_redirect”, “http://www.aliyun.com“]
success_action_status未指定success_action_redirect时,上传成功后的返回状态码。支持精确匹配和前缀匹配方式。[“eq”, “$success_action_status”, “204”]
Cache-Control, Content-Type, Content-Disposition, Content-Encoding, Expires等HTTP请求头,作为表单域传递。支持精确匹配和前缀匹配方式。[“eq”, “$Content-Encoding”, “ZLIB”]

Post Policy有以下转义字符,使用 \ 转义。
转义字符描述
/斜杠
\反斜杠
双引号
$美元符
\b空格
\f换页
\n换行
\r回车
\t水平制表符
\uxxxxUnicode字符

Post Policy更详细的说明,请参考 Post Policy

PostObject的签名


对于验证的Post请求,请求中必须包含AccessKeyID、policy、Signature表单域。计算签名的流程如下:
  1. 创建一个UTF-8编码的policy。
  2. 将policy进行base64编码,其值即为policy表单域该填入的值,将该值作为将要签名的字符串。
  3. 使用AccessKeySecret对要签名的字符串进行签名,先用hmac-sha1哈希,再base64编码;签名方法与 Header签名的方法相同。

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

计算出的签名在表单域Signature中指定,如下所示: Content-Disposition: form-data; name="Signature"
{signature}
--9431149156168


如果您还有疑问,请参考示例代码: 

常见问题



怎么指定key?


key即object name,在表单域key中指定,示例如下: Content-Disposition: form-data; name="key"
{key}
--9431149156168



怎么指定object内容?


Object内容通过表单域file中指定,示例如下:

注意:
  • 表单域file必须是表单中的最后一个域,即表单域file必须放在所有表单域后。
  • filename是上传的本地文件名称,而不是object name。


怎么指定object类型content-type?Content-Disposition: form-data; name="file"; filename="images.png"
Content-Type: image/png
{file-content}
--9431149156168




Object类型在表单域file中指定Content-Type,而不是Header中的Content-Type,示例如下: Content-Disposition: form-data; name="file"; filename="images.png"
Content-Type: image/png
{file-content}
--9431149156168



怎么指定object内容md5校验content-md5?


在PostObject请求头中指定Content-MD5,注意MD5值是整个body的MD5,即所有表单域的MD5。请求Header示例如下: 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



怎么指定签名Signature?


签名的计算方法请参看 PostObject中的签名 , 签名通过表单域 Signature 携带。

怎么使用临时用户STS Token执行PostOject?


临时用户密钥的AccessKeyID、AccessKeySecret用法跟主用户、子用户相同,Token放在表单域 x-oss-security-token 中携带。示例如下: Content-Disposition: form-data; name="Signature"
5L0+KaeugxYygfqWLJLoy0ehOmA=
--9431149156168
Content-Disposition: form-data; name="x-oss-security-token"
{Token}
--9431149156168


提示:如果您想更多了解更多访问控制的信息,请参看 阿里云访问控制


怎么指定上传回调(callback)?


上传回调(callback)通过表单域callback携带。示例如下: Content-Disposition: form-data; name="callback"
eyJjYWxsYmFja0JvZHlUeXBlIjogImFwcGxpY2F0aW9uL3gtd3d3LWZvcm0tdXJsZW5j b2RlZCIsICJjYWxsYmFja0JvZHkiOiAiZmlsZW5hbWU9JHtvYmplY3R9JnNpemU9JHtzaXplfSZtaW1lVHlwZT0ke21pbWVUeXBlfSIsICJjYWxsYmFja1VybCI6ICJodHRwOi8vb3NzLWRlbW8uYWxpeXVuY3MuY29tOjIzNDUwIn0=
--9431149156168


Callback的自定义参数也是通过表单域携带。示例如下: Content-Disposition: form-data; name="x:var1"
{var1-value}
--9431149156168


提示:如果您想了解callback更多内容,请参看 上传回调


怎么指定Content-Transfer-Encoding?


在表单域file中指定Content-Transfer-Encoding。file表单域示例如下: Content-Disposition: form-data; name="file"; filename="images.png"
Content-Type: image/png
Content-Transfer-Encoding: base64
{file-content}
--9431149156168



怎么指定用户自定义元信息Object User Meta?


用户自定义元信息,可以表单域指定,示例如下: Content-Disposition: form-data; name="x-oss-meta-uuid"
{uuid}
--9431149156168
Content-Disposition: form-data; name="x-oss-meta-tag"
{tag}
--9431149156168


提示:文件元信息更详细的说明,请参看 文件元信息Object Meta


怎么指定限定条件expiration、Key、Bucket、size、header等?


OSS的PostObject支持丰富的条件限制,可以满足高安全性要求。限定条件Conditions可以通过表单域 policy 指定,详细的说明请参看上面的 [backcolor=transparent]PostObject的Policy格式。下面是一个policy的示例: {
    "expiration": "2018-01-01T12:00:00.000Z",
    "conditions": [
        ["eq", "$bucket", "md-hz"],
        ["starts-with", "$key", "md/conf/"],
        ["content-length-range", 0, 104857600]
    ]
}


上面的policy,用户的PostObject操作的限定条件如下:
  • bucket 必须是 md-hz。
  • key 必须以md/conf/ 开头。
  • 是上传的文件长度必须在100M以下。
  • 请求时间在 2018-01-01T12:00:00.000Z之前。


怎么指定Cache-Control、Content-Type、Content-Disposition、 Content-Encoding、Expires等HTTP Header?


Cache-Control, Content-Type, Content-Disposition, Content-Encoding, Expires等HTTP Header需要在表单域中指定,这些HTTP Header的含义请参看 RFC2616 。但是 Content-MD5 需要在Post Header中指定。

PostObject示例



常用链接

移动开发 JSON JavaScript 前端开发 Java C# 对象存储 数据安全/隐私保护 数据格式 Windows
分享到
取消 提交回答
全部回答(0)
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

推荐文章
相似问题
推荐课程