阿里云合作伙伴-授权证书 长期稳定·永久朋友 产品专家1对1服务
阿里云购买咨询热线:158-0160-3153(微信同号)

热门文章

阿里云常见售后问题集锦

阿里云OSS错误响应格式及错误码说明

发布:凯铧互联


当用户访问阿里云OSS出现错误时,阿里云OSS会返回给用户相应的错误码和错误信息,便于用户定位问题,并做出适当的处理。

1、阿里云OSS的错误响应格式

当用户访问OSS出错时,OSS会返回给用户一个合适的3xx,4xx或者5xx的HTTP状态码;以及一个application/xml格式的消息体。

错误响应的消息体例子:

<?xml version="1.0" ?>
<Error xmlns=”http://doc.oss-cn-hangzhou.aliyuncs.com”>
<Code>
AccessDenied
</Code>
<Message>
Query-string authentication requires the Signature, Expires and OSSAccessKeyId parameters
</Message>
<RequestId>
1D842BC5425544BB
</RequestId>
<HostId>
oss-cn-hangzhou.aliyuncs.com
</HostId>
</Error>
2、所有错误的消息体中都包括以下几个元素:

Code:OSS返回给用户的错误码。
Message:OSS给出的详细错误信息。
RequestId:用于唯一标识该次请求的UUID;当你无法解决问题时,可以凭这个RequestId来请求OSS开发工程师的帮助。
HostId:用于标识访问的OSS集群,与用户请求时使用的Host一致。
其他特殊的错误信息元素请参照每个请求的具体介绍。

3、OSS的错误码

OSS的错误码列表如下:

错误码 描述 HTTP状态码 说明
AccessDenied 拒绝访问 403 原因及排除请参看OSS权限问题及排查
BucketAlreadyExists Bucket已经存在 409 CreateBucket指定的BucketName已经使用,请选择新的BucketName
BucketNotEmpty Bucket不为空 409 DeleteBucket前请先删除文件和未完成的分片上传任务
CallbackFailed 上传回调失败 203 原因及排除请参看上传回调错误及排除
EntityTooLarge 实体过大 400 Post请求消息长度超过 5GB,原因及排除请参看PostObject错误及排查
EntityTooSmall 实体过小 400 Post请求消息长度太短,排除请参看PostObject错误及排查
FieldItemTooLong Post请求中表单域过大 400 除了file的表单域大小不要超过4KB,排除请参看PostObject错误及排查
FilePartInterity 文件Part已改变 400 读分片数据时发现数据与校验和不符
FilePartNotExist 文件Part不存在 400 CompleteMultipartUpload提交的分片没有上传
FilePartStale 文件Part过时 400 读分片数据时发现数据与长度不符
IncorrectNumberOfFilesInPOSTRequest Post请求中文件个数非法 400 Post请求表单域中只能有一个file域,排除请参看PostObject错误及排查
InvalidArgument 参数格式错误 400 参数格式不符合要求,请对照相应API
InvalidAccessKeyId AccessKeyId不存在 403 AccessKeyId无效或过期,排除请参看403错误及排查
InvalidBucketName 无效的Bucket名字 400 Bucket命名规则请参看开发人员指南
InvalidDigest 无效的摘要 400 指定的MD5校验值与文件不符,MD5的计算方法请参见PutObject
InvalidEncryptionAlgorithmError 指定的熵编码加密算法错误 400 目前只支持AES256加密算法,详见PutObject
InvalidObjectName 无效的Object名字 400 ObjectName命名规则请参看开发人员指南
InvalidPart 无效的Part 400 CompleteMultipartUpload提交的Part无效,PartNumber或ETag错误
InvalidPartOrder 无效的part顺序 400 CompleteMultipartUpload提交的Part需按照PartNumber升序排列
InvalidPolicyDocument 无效的Policy文档 400 Post请求中Policy无效,排除请参看PostObject错误及排查
InvalidTargetBucketForLogging Logging操作中有无效的目标bucket 400 存放Logging的目标bucket不存在,请更换
InternalError OSS内部发生错误 500 请重试
MalformedXML XML格式非法 400 请求中XML非法,请根据具体请求排除DeleteObjects、CompleteMultipartUpload、PutBucketLogging、PutBucketWebsite、PutBucketLifecycle、PutBucketReferer、PutBucketCORS
MalformedPOSTRequest Post请求的body格式非法 400 表单域格式非法,排除请参看PostObject错误及排查
MaxPOSTPreDataLengthExceededError Post请求上传文件内容之外的body过大 400 除了file的表单域大小不要超过4KB,排除请参看PostObject错误及排查
MethodNotAllowed 不支持的方法 405 以OSS不支持的操作来访问资源
MissingArgument 缺少参数 411 请参看具体的API对照解决
MissingContentLength 缺少内容长度 411 消息即非chunked encoding又没有携带Content-Length
NoSuchBucket Bucket不存在 404 这个提示没什么可说的,请少侠传数据
NoSuchKey Object不存在 404 这个提示没什么可说的,请少侠传数据
NoSuchUpload Multipart Upload ID不存在 404 没有初始化分片上传或者初始化的分片上传过期
NotImplemented 无法处理的方法 400 OSS不支持的操作
ObjectNotAppendable 不是可追加文件 409 OSS有三类文件normal、appendable、multipart,只有appendable类型的文件才能执行AppendObject
PositionNotEqualToLength Append的位置和文件长度不相等 409 详见AppendObject
PreconditionFailed 预处理错误 412 下载条件不符合,详见GetObject
RequestTimeTooSkewed 发起请求的时间和服务器时间超出15分钟 403 排除请参看403错误及排查
RequestTimeout 请求超时 400 请重试
RequestIsNotMultiPartContent Post请求content-type非法 400 排除请参看PostObject错误及排查
DownloadTrafficRateLimitExceeded 下载流量超过限制 503 默认上限是 5Gbps,包括内外网,有调整需求请提交工单
UploadTrafficRateLimitExceeded 上传流量超过限制 503 默认上限是 5Gbps,包括内外网,有调整需求请提交工单
SignatureDoesNotMatch 签名错误 403 排除请参看Header中签名、URL中签名
TooManyBuckets Bucket数目超过限制 400 默认上限是 10,有调整需求请提交工单


以上就是关于阿里云OSS错误响应格式及错误码的说明。阿里云代理商凯铧互联提供阿里云服务器/企业邮箱等产品的代购服务,同样的品质,更多贴心的服务,更实惠的价格。 阿里云代理商凯铧互联会为您提供一对一专业全面的技术服务,同时还能为您提供阿里云其他产品购买的专属折扣优惠。通过凯铧互联购买可以获得折上折优惠!若您需要帮助可以直接联系我方客服,阿里云代理商凯铧互联专业技术团队为您提供全面便捷专业的7x24技术服务。 电话专线:136-5130-9831,QQ:3398234753。

为什么选择我们:北京凯铧互联科技有限公司(简称凯铧互联)由多名前阿里云资深技术专家创立,核心员工来自阿里云、腾讯云等,作为阿里云,腾讯云百度云,金山云,华为云重要的合作伙伴,专注于为企业用户提供云计算及云计算的解决方案。总部设在北京,并在内蒙设有办事处。做为一家综合性方案商,凯铧互联向各行业用户提供基于云计算的各种解决方案。为用户获得优质服务的同时,秉承"专业规划、周到服务"的服务理念,根据用户的实际情况,充分考虑各种网络资源的特点及功效,为用户量身定做一套适合于其实际应用需求的网络应用方案。帮助用户利用互联网的力量展开新的营销方式,并大大缩短了项目实施周期,获得用户的一致好评。