开发者社区> 鸣镝> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

OSS PostObject错误及排查

简介: 详细阐述了OSS PostObject的消息格式,列举了常见的问题及解法、说明了常见的需求及实现。
+关注继续查看

PostObject简介

PostObject使用表单上传文件到OSS。PostObject的消息实体通过 多重表单格式multipart/form-data 编码,详细说明请参看 RFC 2388。Put Object中参数通过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常见错误见下表:

序号 错误 原因 解法
1 ErrorCode: MalformedPOSTRequest
ErrorMessage: The body of your POST request is not well-formed multipart/form-data
表单域格式不符合要求 表单域格式请参看表后的PutObject表单域格式
2 ErrorCode: InvalidAccessKeyId
ErrorMessage: The OSS Access Key Id you provided does not exist in our records.
AccessKeyID禁用或不存在,或者过期的临时用户AccessKeyID,或者临时用户没有提供STS Token 排查方法请参看 InvalidAccessKeyId错误排查
3 ErrorCode: AccessDenied
ErrorMessage: Invalid according to Policy: Policy expired.
表单域policy中的expiration过期 请调整policy中的expiration,注意expiration的格式 ISO8601 GMT
4 ErrorCode: AccessDenied
ErrorMessage: SignatureDoesNotMatch The request signature we calculated does not match the signature you provided. Check your key and signing method.
签名错误 签名方法请参看下面的PutObject中的签名
5 ErrorCode: InvalidPolicyDocument
ErrorMessage: Invalid Policy: Invalid Simple-Condition: Simple-Conditions must have exactly one property specified.
请求中policy至少包含一个condition 请参看表后的 PutObject中的Policy格式
6 ErrorCode: InvalidPolicyDocument
ErrorMessage: Invalid Policy: Invalid JSON: unknown char e
请求中的policy格式不正确 请检查policy格式,"是否加缺失,转义字符是否加\
7 ErrorCode: InvalidPolicyDocument
ErrorMessage: Invalid Policy: Invalid JSON: , or ] expected
请求中的policy格式不正确 policy中是否缺少 ,]
8 ErrorCode: AccessDenied
ErrorMessage: Invalid according to Policy: Policy Condition failed: ["starts-with", "$key", "user/eric/"]
请求指定的keypolicy限定的不符 请检查请求中表单域key的值
9 ErrorCode: AccessDenied
ErrorMessage: Invalid according to Policy: Policy Condition failed: ["eq", "$bucket", "mingdi-bjx"]
请求指定bucketpolicy限定的不符 请检查endpoint中的bucket的值
10 ErrorCode: 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的值
11 ErrorCode: AccessDenied
ErrorMessage: Invalid according to Policy: Policy Condition failed: ["eq", "${field}", "${value}"]
表单域中指定的{field}与policy中限定的值不符,或者在请求中没有指定 请检查请求中的{field}的值
12 ErrorCode: AccessDenied
ErrorMessage: You have no right to access this object because of bucket acl.
当前用户无权限 请参看 OSS权限问题及排查
13 ErrorCode: InvalidArgument
ErrorMessage: The bucket POST must contain the specified 'key'. If it is specified, please check the order of the fields
表单域没有指定key,或者放在了表单域file 请添加表单域key或调整顺序

PutObject表单域格式

PutObject请求格式,有以下注意点:

  • 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

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

PutObject的Policy格式

PutObject请求的 policy 表单域用于验证请求的合法性,声明了PutObject请求必须满足的条件。限定条件为 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 水平制表符
uxxxx Unicode字符

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

PutObject的签名

对于验证的Post请求,请求中必须包含AccessKeyID、policy、Signature表单域。计算签名的流程如下:

  • 创建一个UTF-8编码的policy。
  • 将policy进行base64编码,其值即为policy表单域该填入的值,将该值作为将要签名的字符串。
  • 使用AccessKeySecret对要签名的字符串进行签名,先用hmac-sha1哈希,再base64编码;签名方法与 Header签名 的方法相同。

即:

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

计算出的签名在表单域Signature中指定,如下所示:

Content-Disposition: form-data; name="Signature"

{signature}
--9431149156168

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

常见问题

怎么指定key

key即object name,在表单域key中指定,示例如下:

Content-Disposition: form-data; name="key"

{key}
--9431149156168

怎么指定object内容

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

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

{file-content}
--9431149156168

注意:

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

怎么指定object类型content-type

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

签名的计算方法请参看 PutObject中的签名 , 签名通过表单域 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"

eyJjYWxsYmFja0JvZHlUeXBlIjogImFwcGxpY2F0aW9uL3gtd3d3LWZvcm0tdXJsZW5jb2RlZCIsICJjYWxsYmFja0JvZHkiOiAiZmlsZW5hbWU9JHtvYmplY3R9JnNpemU9JHtzaXplfSZtaW1lVHlwZT0ke21pbWVUeXBlfSIsICJjYWxsYmFja1VybCI6ICJodHRwOi8vb3NzLWRlbW8uYWxpeXVuY3MuY29tOjIzNDUwIn0=

callback的自定义参数也是通过表单域携带。示例如下:

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

{var1-value}

提示:

怎么指定Content-Transfer-Encoding

在表单域file中指定Content-Transfer-Encodingfile表单域示例如下:

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

提示:

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

OSS的PostObject支持丰富的条件限制,可以满足高安全性要求。限定条件Conditions可以通过表单域 policy 指定,详细的说明请参看上面的 PutObject中的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-hzkey 必须以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示例

C# Post Demo

Java Post Demo

Js Post Demo

常用链接

Post Object  https://help.aliyun.com/document_detail/31988.html

Java PostObject实现  https://yq.aliyun.com/articles/30346

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
访问 OSS 这类对象存储最快的方式- JindoFS SDK |学习笔记
快速学习 访问 OSS 这类对象存储最快的方式- JindoFS SDK
107 0
第1期:一图了解阿里云对象存储OSS
阿里云对象存储OSS是一款海量,安全,低成本,高可靠的云存储服务。跟着阿里云内容设计中心来一起了解一下OSS吧~
320 0
阿里云OSS对象存储服务上传失败问题之一
OSS是阿里云提供一个对象存储服务,有着稳定高效的特点,但在操作时有些问题还是必须要注意一下的
610 0
一文了解阿里云对象存储OSS
对象存储OSS是什么? 对象存储服务(Object Storage Service,简称 OSS),以 HTTP RESTful API 的形式对外提供服务,是阿里云提供的海量、安全、低成本、高可靠的云存储服务,适合存放任意类型的文件。容量和处理能力弹性扩展,多种存储类型供选择,全面覆盖从热到冷的各种数据,优化存储成本。其数据可靠性不低于 99.9999999999%(12 个 9),服务可用性
7549 0
一分钟了解阿里云产品:对象存储OSS概述
阿里云的产品种类繁多,今天让我们一起来了解下对象存储(Object Storage Service,简称OSS)吧!
1320 0
三大场景,对象存储OSS带你快速上云
本文介绍对象存储OSS的主要应用场景。 图片和音视频等应用的海量存储 OSS可用于图片、音视频、日志等海量文件的存储。
2555 0
基于对象存储 OSS 的智能数据分析处理框架和功能
今年参加了 2019 全球闪存峰会(Flash Memory World),分享了“基于云存储的智能数据分析处理架构”,重点介绍在对象存储 OSS 之上的数据处理功能,现整理相关内容和大家探讨。
2493 0
对象存储 OSS 常见问题
本文列举了阿里云对象存储 OSS 的常见问题,帮助您快速了解 OSS。
8967 0
如何设置对象存储OSS静态网站托管功能?
今天为大家介绍一下如何设置OSS的默认页面。OSS的静态网站托管功能,主要是允许客户将一个.html的静态文件上传到bucket中作为bucket外网域名访问的一个特定页面。 接下来,我们登录控制台给大家详细介绍一下设置方法。
3295 0
【答疑】对象存储OSS常见问题解答(SDK类2)
1.客户在使用OSS java SDK 上传时发现卡死。解答:原因是连接池中连接泄漏,可能是使用ossObject后没有关闭。云栖社区里有一篇文章详细介绍了这个问题: https://yq.aliyun.
1475 0
+关注
鸣镝
Alibaba Cloud OSS SDK/Tools Developer
25
文章
27
问答
来源圈子
更多
阿里云存储基于飞天盘古2.0分布式存储系统,产品包括对象存储OSS、块存储Block Storage、共享文件存储NAS、表格存储、日志存储与分析、归档存储及混合云存储等,充分满足用户数据存储和迁移上云需求,连续三年跻身全球云存储魔力象限四强。
+ 订阅
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载