控制台指南

最佳实践

开发者指南

API 文档

SDK 文档

错误码

最近更新时间:2022-03-21 16:03:06

概述

本文将为您介绍请求出错时返回的错误码和对应错误信息。

错误响应

Content-Type:application/xml

对应 HTTP 状态码:3XX,4XX,5XX。

响应体

<?xml version='1.0' encoding='utf-8' ?>
<Error>
    <Code>string</Code>
    <Message>string</Message>
    <RequestId>string</RequestId>
    <TraceId>string</TraceId>
</Error>

具体的节点描述如下:

节点名称(关键字) 父节点 描述 类型
Error 包含所有的错误信息 Container

Container 节点 Error 的内容:

节点名称(关键字) 父节点 描述 类型
Code Error 错误码,用来定位唯一的错误条件和确定错误场景,具体错误码见下文 string
Message Error 具体的错误信息 string
RequestId Error 每次请求发送时,服务端将会自动为请求生成一个 ID,遇到问题时,该 ID 能更快地协助定位问题 string
TraceId Error 每次请求出错时,服务端将会自动为这个错误生成一个ID,遇到问题时,该 ID 能更快地协助定位问题 string

错误码列表

3XX 类型错误

错误码 描述 HTTP状态码
PermanentRedirect 该资源已经被永久改变了位置,请利用 HTTP Location 响应头部来重定向到正确的新位置 301 Moved Permanently
TemporaryRedirect 该资源已经被临时改变了位置,请利用 HTTP Location 响应头部来重定向到正确的新位置 307 Temporary Redirect

4XX 类型错误

错误码 描述 HTTP 状态码
InvalidArgument 请求的部分参数不符合要求 400 Bad Request
MissingContent 缺少包体 400 Bad Request
InvalidContent 发送的包体格式不正确或者与 Content-MD5 值不同 400 Bad Request
InvalidHost Host 验证失败 400 Bad Request
ResourceNotFound 指定的输入资源不存在 400 Bad Request
ResourceAccessDenied 没有权限操作指定的资源,请检查是否赋权 400 Bad Request
ResourceDownloadFailed 指定的输入资源下载失败 400 Bad Request
CIRoleNotExist 万象角色CI_QCSRole不存在 400 Bad Request
ResourceNotSupported 文件有问题或不支持 400 Bad Request
MissingAuthorization 缺少 Authorization 401 Unauthorized
InvalidAuthorization Authorization 格式不正确 401 Unauthorized
AccessDenied 没有权限 401 Unauthorized
SecretidNotExist 该密钥不存在 401 Unauthorized
SignatureExpired 签名已过期 401 Unauthorized
AccessDenied 禁止此操作 403 Forbidden
MediaBucketAlreadyBinded 该存储桶已经被绑定 403 Forbidden
QueueSaturated 该队列已满 403 Forbidden
QueuePaused 该队列已暂停 403 Forbidden
InvalidUrl 请求的 Url 格式不正确 404 Not Found
AuditingJobNotFound 审核Job不存在 404 Not Found
MissingContentLength Content-Length 请求头部缺失 411 Length Required
InvalidContent 发送的包体过大 413 Payload Too Large
SlowDown 请降低访问频率 429 Too Many Requests
UnavailableForLegalReasons 因法律原因不可用。请 联系我们 451 Unavailable For Legal Reasons

5XX 类型错误

错误码 描述 HTTP 状态码
InternalError 服务端内部错误 500 Internal Server
NotImplemented 请求尚未实现 501 Not Implemented
ServiceUnavailable 服务暂不可用,请重试 503 Service Unavailable
目录