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