当用户访问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 |
错误码 | 描述 | HTTP状态码 |
---|---|---|
InternalErrror | 服务端内部错误 | 500 |
DecryptError | 解密错误,文件加密使用了一种错误的方式 | 500 |
NotImplemented | Header中存在无法处理的方法 | 501 |
ServiceUnavailable | 服务器繁忙,请重试 | 503 |