> 文章列表 > OSS的错误响应

OSS的错误响应

OSS的错误响应

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