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 |
时间: 2024-09-15 10:53:33