400错误 - 对象存储 OSS

• The Object name can not be empty.
• The Length of Object name must be less than 1024.
• The specified object is not valid.

• 错误原因：参数格式不符合要求。
• 解决方案：请参见API概览中相应的API，填写正确的参数格式。

• 错误原因：签名版本不支持。
• 解决方案：请确认当前签名为1.0或2.0版本。

• 错误原因：拷贝文件时，没有指定源Bucket和源Object。
• 解决方案：拷贝文件时，需按照/sourcebucket/sourcekey的格式指定拷贝的源地址参数x-oss-copy-source。例如源Bucket为examplebucket，源Object为exampleobject，则拷贝文件时x-oss-copy-source应指定为/examplebucket/exampleobject。

• 错误原因：当SSEAlgorithm取值为AES256时，填写了KMSMasterKeyID。
• 解决方案：仅当SSEAlgorithm取值为KMS且使用指定的密钥加密时，需填写KMSMasterKeyID。

• 错误原因：用户无操作权限。
• 解决方案：只有Bucket拥有者或者授权的RAM用户才能为Bucket设置加密规则。详情请参见PutBucketEncryption。

• 错误原因：指定的Bucket存储类型不存在。
• 解决方案：OSS仅支持Standard（标准存储）、低频访问（IA）、Archive（归档）和ColdArchive（冷归档）四种存储类型。详情请参见PutBucket。

• 错误原因：指定的Object版本ID无效。
• 解决方案：请通过GetBucketVersions (ListObjectVersions)接口确认Bucket是否已开启版本控制，以及Object填写的版本ID是否正确。

• 错误原因：未指定VersionId字段。
• 解决方案：请在VersionId字段中填写Object的版本ID。详情请参见GetBucketVersions(ListObjectVersions)。

Authorization header is invalid.

Authorization header is invalid, bad num of Items in Authorization header.

AccessKeyId or Signature is missing in Authorization header value.

Authorization header value is empty.

Unknown parameter in Authorization header.

• 错误原因：Authorization头部计算方法中参数填写不规范。
• 解决方案：Authorization头部计算方法如下：

  Authorization = "OSS " + AccessKeyId + ":" + Signature
  Signature = base64(hmac-sha1(AccessKeySecret,
              VERB + "\n"
              + Content-MD5 + "\n" 
              + Content-Type + "\n" 
              + Date + "\n" 
              + CanonicalizedOSSHeaders
              + CanonicalizedResource))

  参数	说明
  AccessKeySecret	用于加密签名字符串的密钥。
  VERB	表示HTTP请求的Method，主要有PUT、GET、POST、HEAD、DELETE等。
  \n	换行符。
  Content-MD5	表示请求内容的MD5值，可用于检查消息合法性，例如消息内容是否与发送时一致。 有关Content-MD5的详细计算方法的更多信息，请参见Content-MD5的计算方法。
  Content-Type	表示请求内容的类型。例如application/octet-stream，也可以为空。
  Date	表示此次操作的时间，且必须为GMT格式。例如Sun, 22 Nov 2015 08:16:38 GMT。
  CanonicalizedOSSHeaders	所有以x-oss-为前缀的HTTP Header。
  CanonicalizedResource	用户访问的OSS资源。

• 错误原因：Post请求Header中缺少OSSAccessKeyId表单域。
• 解决方案：当Bucket为非public-read-write或者提供了Policy（或Signature）表单域时，必须提供OSSAccessKeyId表单域。

• 错误原因：Post请求Header中缺少签名信息。
• 解决方案：当Bucket为非public-read-write或者提供了OSSAccessKeyId（或Policy）表单域时，必须提供Signature表单域。

  计算Signature的具体流程如下：

  1. 创建一个UTF-8编码的Policy。
  2. 将Policy进行Base64编码，其值即为Policy表单域填入的值，将该值作为将要签名的字符串。
  3. 使用AccessKeySecret对要签名的字符串进行签名，签名方法为Signature = base64(hmac-sha1(base64(policy), AccessKeySecret)) 。

• 错误原因：Authorization头中的Date无效。
• 解决方案：Date表示此次操作的时间，且必须为GMT格式，例如Sun, 22 Nov 2015 08:16:38 GMT。

• 错误原因：POST请求表单中包含无效参数，或者参数格式不正确。
• 解决方案：请参见PostObject填写规范的参数。

• 错误原因：filename字段的下一行包含了自定义参数。
• 解决方案：filename字段的下一行必须为规范的Content-Type参数。如下图所示：

• 错误原因：Post请求的Body总长度超过5 GB。
• 解决方案：Post请求的Body总长度不允许超过5 GB。详情请参见PostObject。

• 错误原因：Callback参数未经过Base64编码。
• 解决方案：Callback参数必须为经过Base64编码的JSON字符串，且必须指定请求回调的服务器URL以及回调的内容。详情请参见Callback。

• 错误原因：Callback参数不是JSON格式。
• 解决方案：Callback参数必须为经过Base64编码的JSON字符串。示例如下：

  {
  "callbackUrl":"121.101.166.30/test.php",
  "callbackHost":"oss-cn-hangzhou.aliyuncs.com",
  "callbackBody":"{\"mimeType\":${mimeType},\"size\":${size}}",
  "callbackBodyType":"application/json"
  }

• 错误原因：Callback参数没有指定请求回调的服务器 URL（callbackUrl）。
• 解决方案：Callback参数必须为经过Base64编码的JSON字符串，且必须指定请求回调的服务器URL以及回调的内容。

• 错误原因：callbackHost参数无效，无法进行JSON解析。
• 解决方案：callbackHost表示发起回调请求的Host头，例如oss-cn-hangzhou.aliyuncs.com。如果没有配置callbackHost，则解析callbackUrl中的URL，并将URL中解析到的Host填充到callbackHost中。

• 错误原因：callbackBodyType参数无效，无法进行JSON解析。
• 解决方案：callbackBodyType表示发起回调请求的Content-Type，支持application/x-www-form-urlencoded和application/json。

• 错误原因：请求的callbackurl个数超过5个。
• 解决方案：OSS支持同时配置最多5个URL，每个URL之间以分号（;）分隔。

• 错误原因：用户自定义Header中的Value值不合法。
• 解决方案：对自定义Header中Value值包含的中文等特殊字符进行UTF-8编码。

• 错误原因：用户自定义Header与请求头中的Header重名时，两者的Value值不一致。
• 解决方案：用户自定义Header与请求头中的Header重名时，两者的Value值需保持一致。

• 错误原因：用户自定义Header中的Value值包含了回车符\r或换行符\n。
• 解决方案：请删除用户自定义Header中Value值包含的回车符\r和换行符\n。

• 错误原因：请求URL和请求Header中同时包含了callback参数。
• 解决方案：仅允许在请求URL或请求Header中包含callback参数。

• 错误原因：请求URL和请求Header中同时包含了callback var参数。
• 解决方案：仅允许在请求URL或请求Header中包含callback var参数。

• 错误原因：请求URL和请求Header中同时包含了单链接限速参数x-oss-traffic-limit。
• 解决方案：仅允许在请求URL或请求Header中包含单链接限速参数x-oss-traffic-limit。

• 错误原因：单链接限速取值无效。
• 解决方案：单链接限速取值范围为819200~838860800，即100 KB/s~100 MB/s。

• 错误原因：用户自定义Header的格式错误。
• 解决方案：用户自定义Header格式为x-oss-persistent-headers: key1:base64_encode(value1),key2:base64_encode(value2)....。其中key1、key2等为自定义的Header，value1、value2为自定义Header对应的值，Base64_encode表示对自定义Header的值进行Base64编码。

  例如自定义Header为myheader1和myheader2，其值分别为myvalue1、myvalue2，则自定义请求Header应为x-oss-persistent-headers:myheader1:bXl2YWx1ZTE=,myheader2:bXl2YWx1ZTI=。

• 错误原因：标签中Key和Value值未进行URL编码，且Key值重复。
• 解决方案：对象标签使用一组键值对（Key-Value）标记对象，对象标签规则如下：
  • 单个Object最多可设置10个标签，Key不可重复。
  • 每个Key长度不超过128字节，每个Value长度不超过256字节。
  • Key和Value区分大小写。
  • 标签合法字符集包括大小写字母、数字、空格和以下符号：

    +?=._:/

    通过HTTP Header的方式设置标签且标签中包含任意字符时，您需要对标签的Key和Value做URL编码。

• 错误原因：用户自定义Header中与HTTP中规定的标准头冲突。
• 解决方案：用户自定义Header中不能指定HTTP中规定的标准头，例如Host、Content-MD5、Origin或Range等。

• 错误原因：用户自定义Header包含非法字符。
• 解决方案：OSS遵循RFC7230规范，请根据RFC7230规范判断HTTP Header是否包含非法字符。

• 错误原因：Host无效。
• 解决方案：Host包含Bucket域名以及IP地址两种。Bucket域名格式为BucketName.Endpoint，例如examplebucket.oss-cn-hangzhou.aliyuncs.com。如Host为IP地址，需确保IP地址有效。

• 错误原因：OSS无法向内网IP地址发送callback请求。
• 解决方案：请使用公网地址发送callback请求。

• 错误原因：callback参数的Base64编码总长度超过了5 KB。
• 解决方案：callback参数的Base64编码总长度最大为5 KB。

• 错误原因：没有填写callbackBody参数。
• 解决方案：Callback参数必须为经过Base64编码的JSON字符串，且必须指定请求回调的服务器URL（callbackUrl）以及回调的内容（callbackBody）。

• 错误原因：callbackBody参数无效，无法进行JSON解析。
• 解决方案：callbackBody表示发起回调时请求Body的值，例如key=$(object)&etag=$(etag)&my_var=$(x:my_var)。请参见Callback进行排查。

• 错误原因：callback var参数的Base64编码总长度超过了5 KB。
• 解决方案：callback var参数的Base64编码总长度最大为5 KB。

• 错误原因：callback-var参数不是JSON格式。
• 解决方案：callback-var用于配置自定义参数，自定义参数格式为Key-Value对，Key要以 x: 开头且必须为小写格式。假设需要设置的Key分别为x:var1和 x:var2，对应的值分别为value1和value2，则JSON格式如下：

  {
  "x:var1":"value1",
  "x:var2":"value2"
  }

• 错误原因：时间参数无效，Unix时间戳小于0。
• 解决方案：Unix时间戳必须大于0。

• 错误原因：时间参数无效，Unix时间戳晚于当前时间。
• 解决方案：Unix时间戳必须早于当前时间。

• 错误原因：时间参数无效。
• 解决方案：时间格式需遵从RFC 1123标准，例如Sun, 06 Nov 1994 08:49:37 GMT。

• 错误原因：<VersioningConfiguration>字段中未指定Bucket的版本控制状态。
• 解决方案：在<VersioningConfiguration>字段中指定Bucket的版本控制状态。示例如下：

  PUT /?versioning HTTP/1.1
  Host: bucket-versioning.oss-cn-hangzhou.aliyuncs.com
  Date: Tue, 09 Apr 2019 02:20:12 GMT
  Authorization: OSS e7thre3jj5mlvqk:12ztptkaR8a74gIGFzOaZZQe****
  <?xml version="1.0" encoding="UTF-8"?>
  <VersioningConfiguration>
      <Status>Enabled</Status>
  <VersioningConfiguration>

POST /?worm HTTP/1.1
Date: Thu, 15 May 2014 11:18:32 GMT
Content-Length：556
Content-Type: application/xml
Host: BucketName.oss.aliyuncs.com
Authorization: OSS nxj7dtlhcyl5hp****:COS3OQkfQPnKmYZTEHYv2****

<InitiateWormConfiguration>
  <RetentionPeriodInDays>365</RetentionPeriodInDays>
</InitiateWormConfiguration>

错误原因：缺少Origin请求头。

解决方案：浏览器在发送跨域请求之前会发送一个preflight请求（OPTIONS）给OSS，并带上特定的请求头Origin，用于标识跨域请求的来源域。示例如下：

错误原因：缺少Access-Control-Request-Method请求头。

解决方案：浏览器在发送跨域请求之前会发送一个preflight请求（OPTIONS）给OSS，并带上特定的请求头Access-Control-Request-Method，用于标识实际请求所用的方法。示例如下：

• 每个Key长度不超过128字节，每个Value长度不超过256字节。
• Key和Value区分大小写。
• 标签合法字符集包括大小写字母、数字、空格和以下符号：

  +?=._:/

  通过HTTP Header的方式设置标签且标签中包含任意字符时，您需要对标签的Key和Value做URL编码。

The Length of channel name must be less than 64.

ChannelName must not be empty.

The characters encoding must be utf-8.

ChannelName must not contain a slash.

• PartNumber取值为1~10000。PartNumber可以不连续，但必须升序排列。例如第一个Part的PartNumber是1，第二个Part的PartNumber可以是5。
• 通过CompleteMultipartUpload请求创建的Object，ETag值是其内容的UUID。ETag值可以用于检查Object内容是否发生变化。

错误原因：CompleteMultipartUpload提交的Part未按照partNumber升序排列。

解决方案：CompleteMultipartUpload提交的Part需按照partNumber升序排列。例如第一个Part的PartNumber是1，第二个Part的PartNumber可以是5。

错误原因：无效的PartNumber。

解决方案：请确保PartNumber取值为1~10000。

错误原因：请求参数中缺少必选参数。

解决方案：请根据所调用的API接口，检查是否已填写所有必选参数。详情请参见API概览。

错误原因：没有携带security-token。

解决方案：临时用户使用URL签名时，必须携带security-token。临时用户使用签名URL的格式为：http://oss-example.oss-cn-hangzhou.aliyuncs.com/oss-api.pdf?OSSAccessKeyId=nz2pc56s936****&Expires=1141889120&Signature=vjbyPxybdZaNmGa%2ByT272YEAiv****&security-token=SecurityToken。详情请参见在URL中包含签名。

错误原因：Playlist文件大小超出最大限制。

解决方案：请确保Playlist文件大小不超过1 MB。

错误原因：未找到ts音视频文件。

解决方案：通过推流的方式上传音视频文件。详情请参见PutLiveChannel。

错误原因：文件不以.m3u8结尾。

解决方案：当转储类型为HLS时，指定生成的m3u8文件名称。文件名称需以.m3u8结尾，文件长度在6~128字符之间，例如playlist.m3u8。

错误原因：playlist文件中同时包含了m3u8和ts类型文件。

解决方案：通常playlist文件类型为m3u8，用于记录ts视频文件信息。详情请参见基于OSS构建HLS流。

Content-Disposition: form-data;
        name="{key}"\r\n\r\n{value}\r\n--{boundary}

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: xxxx-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\example.png
--9431149156168
Content-Disposition: form-data; name="OSSAccessKeyId"
2NeL********j2Eb

如果您还有疑问，请参见示例代码：

• C#
• Java
• JavaScript

• 错误消息：Invalid Policy: Invalid Simple-Condition: Simple-Conditions must have exactly one property specified.
• 错误原因：请求Policy中没有包含conditions。
• 解决方案：请求Policy中必须包含至少一项conditions。

• 错误消息：Invalid Policy: Invalid JSON: unknown char e.
• 错误原因：请求中的Policy格式错误。
• 解决方案：请检查Policy格式，是否缺失"，转义字符前是否有\。

• 错误消息：Invalid Policy: Invalid JSON: , or ] expected.
• 错误原因：请求中的Policy格式错误。
• 解决方案：请检查Policy中是否缺少,或]。

各请求的详细信息如下：

• DeleteMultipleObjects
• CompleteMultipartUpload
• PutBucketLogging
• PutBucketWebsite
• PutBucketLifecycle
• PutBucketReferer
• PutBucketCORS

• 通过简单上传方式上传的Object大小不能超过5 GB。
• 通过表单上传方式上传的Object大小不能超过5 GB。
• 通过追加上传方式上传的Object大小不能超过5 GB。
• 通过分片上传方式上传的Object大小不能超过48.8 TB。

• 原图文件大小不能超过20 MB。
• 使用旋转图片时原图的宽或高不能超过4096 px。
• 原图单边大小不能超过30000 px。

• Key和Value必须为UTF-8编码。
• Key最大长度为64字节，不能以http://、https://、Aliyun为前缀，且不能为空。
• Value最大长度为128字节，可以为空。

错误原因：通过CopyObject接口修改客户端加密元数据。

解决方案：调用客户端加密上传文件后，加密元数据会被保护，无法通过CopyObject修改Object meta信息。详情请参见CopyObject。

错误原因：客户端加密缺少必要参数。

解决方案：请确保已填写以下各项必选参数。

错误原因：客户端加密元信息中输入的Part数量超出限制。

解决方案：每个Object最多支持切分为10000个Part。

错误原因：客户端加密元信息中输入的文件总大小或分片大小不合法。

解决方案：通过客户端加密Multipart文件时，需要在init_multipart时传入整个大文件的总大小（x-oss-meta-client-side-encryption-data-size）以及分片大小（x-oss-meta-client-side-encryption-part-size），且分片大小必须是16的整数倍。详情请参见客户端加密。

错误原因：实际上传的分片数量和初始化分片上传指定的分片数量不一致。

解决方案：请确保指定的分片数量与实际上传的分片数量一致。

错误原因：分片ID大于总分片数（PartNumber）。

解决方案：请确保分片ID等于或者小于总分片数。详情请参见UploadPart。

错误原因：实际上传的每个分片大小与初始化分片上传指定的每个分片大小不一致。

解决方案：除最后一个分片外，其他分片大小均要求与初始化分片上传指定的每个分片大小一致。详情请参见UploadPart。

错误原因：实际上传的所有分片总大小与初始化分片上传指定的分片总大小不一致。

解决方案：上传最后一个分片后，请确保实际上传的所有分片总大小与初始化分片上传指定的分片总大小一致。详情请参见CompleteMultipartUpload。

错误原因：客户端加密配置的分片加密信息与初始化分片上传中设置的加密信息不一致。

解决方案：请确保客户端配置的分片加密信息与初始化分片上传中设置的加密信息一致。详情请参见客户端加密。

错误原因：不支持对经过客户端加密的源文件中调用UploadPartCopy接口。

解决方案：仅支持从未经客户端加密的源文件中调用UploadPartCopy接口，实现从一个已存在的Object中拷贝数据来上传一个Part。详情请参见UploadPartCopy。

• 错误消息：The list of parts was not in ascending order.
• 错误原因：CompleteMultipartUpload提交的Part未按照partNumber升序排列。
• 解决方案：请参见CompleteMultipartUpload。

• 错误消息：Part number must be an integer between 1 and 10000, inclusive.
• 错误原因：无效的partNumber。partNumber的取值范围为1~10000。
• 解决方案：请参见CompleteMultipartUpload。