调用PostObject接口的常见错误及解决方法

概述

本文主要介绍调用PostObject接口出现的常见错误及解决方法。

详细信息

调用PostObject接口出现问题时，您可以参见PostObject，确认调用的配置是否正常。若问题没有解决，请参考以下内容。

• PostObject常见报错
• PostObject常见问题
• PostObject示例
• PostObject简介

PostObject常见报错

PostObject常见问题

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

PostObject示例

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}

  • 表单域名称大小写敏感，如Policy、Key、file、OSSAccessKeyId、OSSAccessKeyId、Content-Disposition。
    

    注意：表单域file必须为最后一个表单域。

  • 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********j2

  说明：
  

  • 以上示例请求中\r\n显示为新行，即换行，后面的示例请求类似。
  • 以上示例为部分内容，完整的请求请参见PostObject。

• 如果您还有疑问，请参考如下示例代码：
  • C#
  • Java
  • JS

PostObject的Policy格式

• PostObject请求的Policy表单域用于验证请求的合法性，声明了PostObject请求必须满足的条件。限定条件如下所示。
  • UTF-8格式的JSON文本，经过base64编码后放在表单域Policy中。
  • Policy中必须包含expiration和condtions，其中condtions至少有一项。
• 下面是base64编码前的Policy示例，expiration项指定了请求的过期时间，使用的是ISO8601 GMT时间格式，例如：2018-01-01T12:00:00.000Z，指定请求必须发生在2018年1月1日12点前。

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

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

PostObject的签名

• 对于验证的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

PostObject简介

PostObject用于通过HTML表单上传的方式将文件（Object）上传至指定存储空间（Bucket）。PostObject的消息实体通过多重表单格式（multipart/form-data）编码，在PutObject操作中参数通过HTTP请求头传递，在PostObject操作中则作为消息体中的表单域传递。详细说明请参见RFC 2388。PostObject消息包括消息头（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必须是最后一个域。更多关于PostObject的介绍请参见PostObject。

相关文档

• PostObject
• C# Post Demo
• Java Post Demo
• JavaScript Post Demo

适用于

• 对象存储OSS