OSS的错误响应
当用户访问OSS出现错误时,OSS会返回给用户相应的错误码和错误信息,便于用户定位问题,并做出适当的处理。
OSS的错误响应格式
当用户访问OSS出错时,OSS会返回给用户一个合适的3xx,4xx或者5xx的HTTP状态码;以及一个application/xml格式的消息体。
错误响应的消息体例子:
AccessDeniedQuery-string authentication requires the Signature,Expires and OSSAccessKeyId parameters1D842BC5425544BBstorage.aliyun.com
◆ 所有错误的消息体中都包括以下几个元素:
● Code:OSS返回给用户的错误码。
● Message:OSS给出的详细错误信息。
● RequestId:用于唯一标识该次请求的UUID;当你无法解决问题时,可以凭这个RequestId来请求OSS开发工程师的帮助。
● HostId:用于标识访问的OSS集群(目前统一为storage.aliyun.com)。
其他特殊的错误信息元素请参照每个请求的具体介绍。
OSS的错误码
OSS的错误码列表如下:
错误码
描述
HTTP状态码
AccessDenied
拒绝访问
403
BucketAlreadyExists
Bucket已经存在
409
BucketNotEmpty
Bucket不为空
409
FileGroupTooLarge
文件组过大
400
FilePartStale
文件Part过时
400
InvalidArgument
参数格式错误
400
InvalidAccessKeyId
Access ID不存在
403
InvalidBucketName
无效的Bucket名字
400
InvalidObjectName
无效的Object名字
400
InvalidPart
无效的Part
400
InvalidPartOrder
无效的part顺序
400
InternalError
OSS内部发生错误
500
MissingContentLength
缺少内容长度
411
NoSuchBucket
Bucket不存在
404
NoSuchKey
文件不存在
404
NotImplemented
无法处理的方法
501
PreconditionFailed
预处理错误
412
RequestTimeTooSkewed
发起请求的时间和服务器时间超出15分钟
403
RequestTimeout
请求超时
400
SignatureDoesNotMatch
签名错误
403
TooManyBuckets
用户的Bucket数目超过限制
400