对象存储

产品文档

对象存储

错误响应

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

下面是错误响应的消息体例子:

<Error>
    <statusCode>404</statusCode>
    <Code>NoSuchBucket</Code>
    <Message>The specified bucket does not exist.</Message>
    <Resource>/henry-dev-test-bucket123123123123</Resource>
    <RequestId>956F69119AE3958B</RequestId>
</Error>

例子中错误消息体包含的几个元素解释,请见下表:
名称 描述 类型
statusCode 状态码 数值
code 错误码是唯一标识错误的,用来确定错误场景 字符串
Message OSS给出的详细错误信息 字符串
Resource 资源地址:Bucket地址或者Object地址。 字符串
RequestId 当请求发送时,服务端将会自动为请求生成一个唯一的ID。使用遇到问题时,request-id能更快地协助OSS定位问题。 字符串

错误码列表

3XX类型错误

错误码 描述 HTTP状态码
PermanentRedirect 该资源已经被永久改变了位置,请利用HTTP Location来重定向到正确的新位置 301
TemporaryRedirect 该资源已经被临时改变了位置,请利用HTTP Location来重定向到正确的新位置 302
Redirect 临时重定向 307
TemporaryRedirect 在DNS更新期间,您将被临时重定向 307

4XX类型错误

错误码 描述 HTTP状态码
POLICYError bucket policy 为 null 400
RequestTimeOut 读取数据超时,检查网络是否过慢或上传并发数过大 400
SlowDown 请降低访问频率 400
RequestTimeTooSkewed 请求时间超过权限有效时间 400
InvalidCompressError Compress need bucket acl public-read-write. 400
TooManyBuckets 您创建的bucket超过限制 400
CompressOjectsNumError 打包文件数量有误,您打包的范围应该1-100 400
TooManyMultipartUploads 初始化分片上传数量超过限制 400
InvalidParamError 请求参数错误 400
EFFECT referer can not apply effect 400
UserAlreadyHasKeys the user already has keys 400
ConnectionLost 连接丢失 400
InvalidParamError 请求参数错误 400
SignatureDoesNotMatch 提供的签名不符合规则 403
SignatureDoesNotMatchV2 签名版本错误,您提供的签名不支持,我们支持签名版本4The request signature we calculated does not match the signature you provided. 403
MethodNotAllowed 此资源不允许您指定的方法。The specified method is not allowed against this resource 405
InvalidPayer 对象禁止访问 403
InvalidAccessKeyId AccessKey不存在 403
SignatureDoesNotMatch 提供的签名不符合规则 403
AccessForbidden 签名或者权限不正确,拒绝访问 403
InvalidBucketName bucket名称不合法 400
InvalidMaxAge 指定的MaxAge不合法 400
InvalidLocationConstraint 指定的位置约束不合法 400
InvalidObjectKey 文件名称不合法 400
InvalidCompressType 打包类型不合法,仅支持zip 400
InvalidContentLengthError http header content-length错误 400
InvalidContentMD5Error http header content-md5错误 400
EntityTooLarge 上传文件的大小超过要求的最大值 413
CORSConfigurationTooLarge CORS的配置文件超过允许的最大值 400
InvalidCORSConfiguration CORS设置不合法 400
InvalidWebsiteConfiguration 静态网站托管设置不合法 400
WebsiteConfigurationTooLarge 静态网站托管设置超过允许的最大值 400
ImgProtectedConditionTooLarge 原图保护设置超过允许的最大值 400
MissingContentLength Header Content-Length缺失 400
MissingContentMD5 请求头中缺少Content-MD5 400
ContentDispositionTooLong Content Disposition过长 400
BadDigest 指定的Content-MD5与我们接收到的不匹配 400
BadContentLength 指定的文件ContentLength与我们接收到的不匹配 400
InvalidRange 请求的文件范围不合法 416
NotSupportMultiRange 不支持多Range 416
KeyTooLong 文件名过长 400
InvalidPartOrder 分块上传编号不连续 400
MalformedPolicy policy格式错误 400
IncorrectNumberOfFilesInPostRequest Post请求每次只允许上传一个文件 400
InvalidToken 非法Token 400
BadRequest 错误请求 400
InvalidURI URI不合法 400
InvalidArgument 请求参数不合法 400
NoSuchDomain 指定域名不存在 404
InvalidPolicyDocument 策略配置文件不合法 400
InvalidImgProtectedCondition 原图保护配置文件不合法 400
MalformedJson JSON格式有误 400
MissingSecurityHeader 必要Header缺失 400
IncompleteBody Content-Length请求头未指定的数值 400
AccessDenied 签名或者权限不正确,拒绝访问 403
AccountProblem 您的账号拒绝了此次操作 403
AccessKeyLimited 您的签名或权限被policy阻止 403
AccountArrear 账户欠费 403
BucketAlreadyExists bucket名称已存在,名称全局唯一 409
BucketAlreadyOwnedByYou 您已创建该Bucket 409
BucketNotEmpty bucket不为空不能删除 409
BucketHasMutiUploads 有分片上传任务,bucket不能删除 409
BucketHasReplicationConfiguration bucket存在跨区域复制规则,不能删除 400
BucketHasPictureStyle bucket存在图片样式不能删除 400
InvalidPart 分片缺失 400
TooManyParts 分片过多 400
NoSuchCORSConfiguration 不存在CORS配置 404
NoSuchWebsiteConfiguration 不存在静态网站托管配置 404
NoSuchBucket 不存在该bucket 404
NoSuchReplicationConfiguration 不存在跨区域复制配置 404
NoSuchImgProtectedCondition 不存在原图保护配置 404
NoSuchKey 指定的文件名不存在 404
NoSuchUpload 指定的分片上传不存在 404
5XX类型错误
错误码 描述 HTTP状态码
InternalErrror 服务端内部错误 500
DecryptError 解密错误,文件加密使用了一种错误的方式 500
NotImplemented Header中存在无法处理的方法 501
ServiceUnavailable 服务器繁忙,请重试 503
更新时间:2019-11-01 11:18:40