附录

错误码响应

格式

名称 类型 描述
Code String 3xx，4xx或者5xx的 HTTP 状态码。
继承：Error
Error Container 错误内容空间。
继承：无
Message Enum OSS给出的详细错误信息。
继承：Error
RequestId String 请求的唯一标识，用于快速排查问题。
继承：Error
Resource String 错误来源存储桶和文件。
继承：Error
  • 示例：

状态码：3xx, 4xx, or 5xx HTTP status code

响应格式：Content-Type: application/xml

    <?xml version="1.0" encoding="UTF-8"?>
    <Error>
      <Code>NoSuchKey</Code>
      <Message>The resource you requested does not exist</Message>
      <Resource>Bucket:mybucket, Object:myfoto.jpg</Resource>
      <RequestId>1511763734421829</RequestId>
      <HostId>7c2a9306140c7c00b7f3da9e7f15893a<HostId/>
    </Error>

错误码列表

错误码 描述 状态码 描述
AccessDenied 拒绝访问 403 原因及排除请参看权限问题及排查
AllAccessDisabled 密钥失效 403 针对该资源，密钥已失效
AccountProblem 账户存在问题 403 -
AuthorizationHeaderMalformed authorization无效 400 请求头中authorization header无效
BadDigest 无效的摘要 400 指定的MD5校验值与文件不符，MD5的计算方法请参见PutObject
BucketAlreadyExists Bucket已经存在 409 CreateBucket指定的BucketName已经使用，请选择新的BucketName
BucketAlreadyOwnedByYou 请求创建的bucket已经属于你 409 -
BucketNotEmpty 尝试删除的Bucket不为空 409 -
CrossLocationLoggingProhibited
EntityTooLarge 实体过大 400 -
EntityTooSmall 实体过小 400 Post请求消息长度太短，排除请参看
ExpiredToken Token过期 403 -
IncompleteBody 实体长度与头部Content-Length不一致 400 -
IncorrectNumberOfFilesInPostRequest 未选择上传文件 400
InternalError OSS内部发生错误 500 请重试
InvalidAccessKeyid 无效的AccessKey 403 -
InvalidBucketName 无效的Bucket名字 400 Bucket命名规则请参看描述
InvalidBucketState 无效状态 409 该存储桶无法访问，欠费等状态，停止服务，但是未删除时
InvalidDigest 无效的摘要 400 指定的MD5校验值与文件不符，MD5的计算方法请参见PutObject
InvalidEncryptionAlgorithmError 无效的AES256加密请求 The encryption request you specified is not valid. The valid value is AES256
InvalidObjectState 当前object状态不能进行该操作 403 -
InvalidRange GetObject的Range请求参数非法 416 查看GetObject API文档中的Range参数语法
InvalidRequest 无效的请求 400 -
InvalidSecurity 鉴权信息无效 403 -
InvalidStorageClass 无效的存储类型 400 -
InvalidToken 无效的token 400 -
InvalidURI 无效的URI 400 -
KeyTooLongError Object Key名字太长 400 -
MalformedACLError xml格式非法 400 -
MalformedPOSTRequest Post请求的body格式非法 400 -
MalformedXML xml格式非法 400 -
MaxMessageLengthExceeded 请求头太大 400
MaxPostPreDataLengthExceededError Post文件太大 400
MetadataTooLarge 请求头太多 400 -
MethodNotAllowed 不支持的方法 405 以OSS不支持的操作来访问资源，请查看API文档
MissingContentLength 未携带Content-Length头 411 -
MissingRequestBodyError 请求体为空 411 -
NoSuchBucket Bucket不存在 404 -
NoSuchKey Object不存在 404 -
NoSuchTenant Tenant账户不存在 404 -
NotImplemented 无法处理的方法 501 OSS不支持的操作
InvalidArgument 参数格式错误 400 参数格式不符合要求，请对照相应api文档
PreconditionFailed 预处理错误 412 下载条件不符合，详见GetObject
RequestTimeout 请求超时 400 -
RequestTimeTooSkewed 客户端请求时间与服务器时间差距太大 403 请查看客户端的时区与时间是否与服务器相差
ServiceErrorUnknown 未识别的请求 500 检查请求语法与api文档是否一致
ServiceUnavailable 服务不可用 503 -
SignatureDoesNotMatch 签名错误 403 -
TooManyBucketsBuckets 数目超过限制 403 -

更新历史

发布时间 更新 说明
2019-03-08 初始化更新
  • API文档上线
2020-06-15 内容更新
  • API内容更新