概述
本文将为您介绍请求出错时返回的错误码和对应错误信息。
错误响应
Content-Type：application/xml
响应体
<?xml version='1.0' encoding='utf-8' ?><Error><Code>string</Code><Message>string</Message><Resource>string</Resource><RequestId>string</RequestId><TraceId>string</TraceId></Error>
具体的节点描述如下：
节点名称（关键字） | 父节点 | 描述 | 类型 |
Error | 无 | 包含所有的错误信息 | Container |
Container 节点 Error 的内容：
节点名称（关键字） | 父节点 | 描述 | 类型 |
Code | Error | 错误码，用来定位唯一的错误条件和确定错误场景，具体错误码见下文 | string |
Message | Error | 具体的错误信息 | string |
Resource | Error | 请求的资源，存储桶地址或对象地址 | string |
RequestId | Error | 每次请求发送时，服务端将会自动为请求生成一个 ID，遇到问题时，该 ID 能更快地协助 COS 定位问题 | string |
TraceId | Error | 每次请求出错时，服务端将会自动为这个错误生成一个 ID，遇到问题时，该 ID 能更快地协助 COS 定位问题 | string |
错误码列表
4XX 类型错误
HTTP 状态码 | 错误码 | 描述 |
400 Bad Request | ActionAccelerateNotSupported | 加速域名不支持该操作 |
400 Bad Request | AttachmentFull | ACL 和 Policy 数量到达上限。详情请参见 规格与限制 |
400 Bad Request | BadDigest | |
400 Bad Request | BadRequest | 参数错误 |
400 Bad Request | BucketAccelerateNotEnabled | 该存储桶未启用加速域名 |
400 Bad Request | BucketNameTooLong | 存储桶名称过长。详情请参见 存储桶命名规范 |
400 Bad Request | BucketVersionNotOpen | 存储桶未启用版本控制 |
400 Bad Request | DNSRecordVerifyFailed | DNS 记录验证失败，请添加 CNAME 或 TXT 记录。DNS 记录可能需要最多10分钟生效 |
400 Bad Request | EntitySizeNotMatch | |
400 Bad Request | EntityTooLarge | 上传的对象大小超过规定的最大值。详情请参见 规格与限制 |
400 Bad Request | EntityTooSmall | 上传的对象大小不足规定的最小值，常见于分块上传。详情请参见 规格与限制 |
400 Bad Request | ExpiredToken | 临时密钥 Token 已过期 |
400 Bad Request | ImageResolutionExceed | 图片分辨率超出限制或动图帧数过多 |
400 Bad Request | ImageTooLarge | 图片超过限制大小 |
400 Bad Request | IncompleteBody | |
400 Bad Request | IncorrectNumberOfFilesInPostRequest | POST Object 请求每次只允许上传一个对象 |
400 Bad Request | InvalidArgument | 请求参数不合法，请确认是否允许携带该请求参数 |
400 Bad Request | InvalidBucketName | 存储桶名称不合法。详情请参见存储桶 命名规范 |
400 Bad Request | InvalidCopySource | 复制对象源不合法 |
400 Bad Request | InvalidDelimiter | 分隔符（delimiter）参数不合法，分隔符只能为一个字符 |
400 Bad Request | InvalidDigest | |
400 Bad Request | InvalidImageFormat | 图片格式不合法 |
400 Bad Request | InvalidImageSource | 图片源不合法 |
400 Bad Request | InvalidLocationConstraint | 指定的 location 不合法 |
400 Bad Request | InvalidObjectName | 对象名称不合法。详情请参见 对象键 |
400 Bad Request | InvalidPart | 分块缺失 |
400 Bad Request | InvalidPartOrder | 分块的编号不连续 |
400 Bad Request | InvalidPicOperations | Pic-Operations 请求头不合法 |
400 Bad Request | InvalidPolicyDocument | POST Object 请求中的策略（Policy）不合法 |
400 Bad Request | InvalidRegionName | 不合法的地域名。详情请参见 地域和访问域名 |
400 Bad Request | InvalidRequest | 请求不合法 |
400 Bad Request | InvalidSHA1Digest | 请求内容 SHA1 校验不合法 |
400 Bad Request | InvalidTag | 存储桶标签不合法。详情请参见 存储桶标签概述 |
400 Bad Request | InvalidTargetBucketForLogging | 用于存放日志的目标存储桶不合法，目标存储桶必须与当前存储桶在同一个地域 |
400 Bad Request | InvalidUploadStatus | 当启用版本控制时不能使用 JSON API 上传对象，请使用 XML API |
400 Bad Request | InvalidURI | URI 不合法 |
400 Bad Request | InventoryFull | 清单任务数量已达到限制。清单任务上限1000条 |
400 Bad Request | JsonAPINotSupportOnMAZBucket | JSON API 不支持操作多 AZ 存储桶，请使用 XML API |
400 Bad Request | KeyTooLong | 对象键过长。详情请参见 对象键 |
400 Bad Request | KmsException | 密钥管理服务异常 |
400 Bad Request | KmsKeyDisabled | 提供的密钥已被禁用 |
400 Bad Request | KmsKeyNotExist | 提供的密钥不存在 |
400 Bad Request | ListPartUploadIdIsEmpty | UploadId 为空 |
400 Bad Request | LoggingConfExists | 日志配置已存在 |
400 Bad Request | LoggingPrefixInvalid | 日志前缀参数不合法 |
400 Bad Request | MalformedPolicy | 策略格式不合法 |
400 Bad Request | MalformedPOSTRequest | 该 POST 请求的请求体内容不合法 |
400 Bad Request | MalformedXML | 请求体的 XML 格式不符合 XML 语法 |
400 Bad Request | MAZOperationNotSupportOnOAZBucket | The multiple availability zones operation is not supported by single availability zone bucket |
400 Bad Request | MissingRequestBodyError | 请求体缺失 |
400 Bad Request | MultiAZFeatureNotSupport | 当前地域不支持多可用区 |
400 Bad Request | MultiBucketNotSupport | 跨地域复制只能设置一个目的存储桶 |
400 Bad Request | NotifyRuleEventConflict | 通知规则 Event 冲突 |
400 Bad Request | NotifyRulePrefixConflict | 通知规则 Prefix 冲突 |
400 Bad Request | NotifyRuleSuffixConflict | 通知规则 Suffix 冲突 |
400 Bad Request | NotSupportedStorageClass | |
400 Bad Request | OAZOperationNotSupportOnMAZBucket | The single availability zone operation is not supported by multiple availability zones bucket |
400 Bad Request | PolicyFull | ACL 和 Policy 数量到达上限。详情请参见 规格与限制 |
400 Bad Request | PolicyVersionFull | Policy 版本数量到达上限 |
400 Bad Request | RequestTimeout | 请求超时 |
400 Bad Request | SsecDecryptHeaderInvalid | 源文件使用 SSE-C 加密，需要在请求头中提供相同的密钥 |
400 Bad Request | SSEContentNotSupported | 加密方式不支持 |
400 Bad Request | SSEHeaderNotAllowed | 该操作不支持指定的服务端加密头部 |
400 Bad Request | TargetBucketNameInvalid | 目标存储桶名称不合法。详情请参见存储桶 命名规范 |
400 Bad Request | TooManyBuckets | 存储桶数目达到上限200 |
400 Bad Request | UnexpectedContent | 请求不支持相关内容 |
400 Bad Request | UserCnameInvalid | 用户指定的 CNAME 不存在或不合法 |
400 Bad Request | UserNetworkTooSlow | 用户的网络速度过慢 |
400 Bad Request | VerifyAlgorithmNotSupported | 校验算法不支持 |
400 Bad Request | WebsiteURLInvalid | 自定义域名 URL 不合法 |
400 Bad Request | XMLSizeLimit | XML 长度超过限制 |
402 Payment Required | PaymentRequired | 超出费用配额限制 |
403 Forbidden | AccessDenied | |
403 Forbidden | AccessForbidden | 跨域资源共享（CORS）请求被拒绝，请检查请求方法或请求头部中的 Origin、Access-Control-Request-Method、Access-Control-Request-Headers 是否在配置的 CORS 白名单中 |
403 Forbidden | DownloadForbidden | |
403 Forbidden | InvalidAccessKeyId | SecretID 不存在 |
403 Forbidden | InvalidObjectState | 对象存储类型与操作请求冲突 |
403 Forbidden | NoProcessAuthority | 没有处理图片的权限 |
403 Forbidden | RequestTimeTooSkewed | 本地时间与服务器时间相差过大，超过15分钟 |
403 Forbidden | Request has expired | |
403 Forbidden | SignatureDoesNotMatch | |
403 Forbidden | UserNotSourceBucketOwner | 当前用户不是源存储桶的拥有者 |
403 Forbidden | UserNotTargetBucketOwner | 当前用户不是目标存储桶的拥有者 |
404 Not Found | InventoryConfigurationNotFoundError | 清单配置未找到 |
404 Not Found | NoBucketQuotaPolicy | 存储桶配额策略不存在 |
404 Not Found | NoSuchBucket | 指定的存储桶不存在 |
404 Not Found | NoSuchCopySource | 复制对象源不存在 |
404 Not Found | NoSuchCORSConfiguration | 指定的跨域资源共享配置不存在 |
404 Not Found | NoSuchEncryptionConfiguration | 指定的存储桶加密配置不存在 |
404 Not Found | NoSuchJob | 指定的批量处理任务不存在 |
404 Not Found | NoSuchKey | |
404 Not Found | NoSuchLifecycleConfiguration | 指定的生命周期配置不存在 |
404 Not Found | NoSuchObjectLockConfiguration | 指定的对象锁定配置不存在 |
404 Not Found | NoSuchPolicyVersion | 指定的策略版本不存在 |
404 Not Found | NoSuchTagSet | 指定的标签集合不存在 |
404 Not Found | NoSuchUpload | 分块上传时指定的 UploadId 不存在 |
404 Not Found | NoSuchVersion | 指定版本不存在 |
404 Not Found | NoSuchWebsiteConfiguration | 指定的静态网站配置不存在 |
404 Not Found | OriginConfigurationNotFoundError | 回源配置未找到 |
404 Not Found | ReplicationConfigurationNotFoundError | 跨地域复制配置未找到 |
405 Method Not Allowed | MethodNotAllowed | 此资源不支持该 HTTP 方法 |
405 Method Not Allowed | RestoreNonArchiveObject | 不允许对非归档对象进行回热（恢复） |
405 Method Not Allowed | UploadIdNotSupported | 指定的 UploadId 由 JSON API 生成，不能使用 XML API 操作 |
409 Conflict | AppendPositionErr | Append 操作时，对象长度和 Position 不一致 |
409 Conflict | BucketAlreadyExists | 指定的存储桶已存在 |
409 Conflict | BucketAlreadyOwnedByYou | 指定的存储桶已存在且由当前账户创建 |
409 Conflict | BucketLocked | 存储桶已锁定，不能操作跨地域复制或生命周期 |
409 Conflict | BucketNotEmpty | 存储桶不为空 |
409 Conflict | DomainConfigConflict | 域名配置冲突，请删除冲突的记录 |
409 Conflict | InvalidBucketState | 存储桶状态与操作请求冲突，例如版本控制管理与跨地域复制的冲突 |
409 Conflict | InvalidLockedTime | 对象锁定时间无效 |
409 Conflict | ObjectLocked | 对象已锁定，不允许覆盖上传或删除该对象，也不允许通过复制修改该对象的元数据 |
409 Conflict | InvalidObjectState | 对象状态与操作请求冲突 |
409 Conflict | PathConflict | 存在同名对象的毫秒级并发冲突 |
409 Conflict | QuotaConflict | 配额冲突 |
409 Conflict | QuotaOperationConflict | 该存储桶的状态不适用于该操作 |
409 Conflict | RecordAlreadyExist | DNS 记录冲突，请删除冲突的记录，或添加 CNAME/TXT 记录 |
409 Conflict | RestoreAlreadyInProgress | 该对象正在回热（恢复）中 |
409 Conflict | UploadConflict | 同一个对象键频繁上传会导致冲突 |
409 Conflict | FileAlreadyExists | 上传对象时使用 x-cos-forbid-overwrite:true 头部，如果对象已存在，COS 会拒绝这个覆盖请求，返回报错 |
409 ObjectNotAppendable | ObjectNotAppendable | 指定的对象不能追加 |
411 Length Required | MissingContentLength | Content-Length 请求头部缺失 |
412 Precondition Failed | PreconditionFailed | 前置条件不匹配 |
416 Requested Range Not Satisfiable | InvalidRange | 请求的对象范围不合法 |
424 Failed Dependency | MirrorFailed | 镜像源站返回403 |
451 Unavailable For Legal Reasons | DomainAuditFailed | 域名未备案 |
451 Unavailable For Legal Reasons | UnavailableForLegalReasons |
5XX 类型错误
HTTP 状态码 | 错误码 | 描述 |
500 Internal Server Error | InternalError | 服务端内部错误 |
500 Internal Server Error | KmsInternalException | 查询密钥管理服务时发生服务端内部错误 |
501 Not Implemented | NotImplemented | 请求尚未实现 |
503 Service Unavailable | KmsFreqControl | 请降低使用密钥管理服务的请求的访问频率 |
503 Service Unavailable | ServiceUnavailable | 服务暂不可用，请重试 |
503 Service Unavailable | SlowDown | 访问带宽超过阈值，触发流控。报错信息：Connection refused due to traffic overload. 访问频率超过阈值，触发频控。报错信息：Message：Reduce your request rate. |
数据处理相关错误码
图片下载时处理错误码
错误码 | 说明 | 处理措施 |
-103 | 无效的请求；请求报文无法识别。 | 请检查请求内容。 |
-104 | 无效的 APPID，URL 中包含的 APPID 无效，或者域名没有和 APPID 绑定。 | 请检查 APPID 是否正确。 |
-105 | 无效的样式名，URL 中指定的样式名或者别名没有配置。 | 请检查样式配置或样式名内容。 |
-106 | 无效的 URL，URL 格式不符合格式要求。 | 请检查 URL 格式。 |
-107 | 无效的 Host 头域。 | 请检查 Host 是否正确。 |
-108 | 无效的 Referer。 | 请检查相关 Referer 配置。 |
-109 | 无效的样式名 ID。没有找到该样式名对应的图片。可能是上传该图片后，新增的样式名， 因此图片上传时不能生成该样式名对应的数据。 | - |
-110 | 该图片在黑名单中。 | - |
-113 | 该文档的类型不支持。 | 文档预览目前所支持的输入文件类型，请参见 规则与限制 |
-120 | 回源到源站获取数据时，源站返回的数据有异常，无法正常获取到图片数据。 | 请检查源站数据。 |
-124 | 下载偏移错误。HTTP 请求的 Range 断点续传偏移量可能设置错误。 | 请检查断点续传偏移量的相关配置。 |
-154 | 原图保护机制禁止该 URL 下载。 | 请使用样式访问。 |
-156 | 强制执行302流程。 | - |
-162 | 业务配置为欠费，禁止下载图片。 | 请及时充值。 |
-163 | 业务配置不存在。 | 请检查相关配置项。 |
-164 | 热图下载，限制。 | |
-165 | 攻击性下载请求，限制。 | - |
-166 | 消息格式错误。 | - |
-167 | 文件太大，无法支持图片下载。 | 请降低图片大小。 |
-168 | 文件太大，无法支持图片下载。 | 请降低图片大小。 |
-441 | 图片格式不符，无法进行压缩。 | 请使用数据万象支持的图片格式进行图片处理操作。具体支持格式为 jpg、bmp、gif、png、webp。 |
-442 | 图片超过限制大小。 | 请将图片长宽限制在9999像素以内。 |
-443 | 图片格式不满足处理限制。 | 请使用支持的图片格式进行处理，详情请参见 规则与限制 |
-447 | 图片分辨率超出限制或动图帧数过多。 | 请将图片长宽限制在9999像素以内（动图请限制帧数）。 |
-901 | 压缩超时。 | - |
-902 | 回源超时，镜像存储功能把请求转发到开发商源站，但没有收到响应，超时了。 | 请检查源站数据或回源配置。 |
-3006 | 该文档被加密，无法解析。 | - |
-3008 | 该文件为空文件，无法解析。 | - |
-3011 | 该文档的类型不支持。 | 文档预览目前所支持的输入文件类型，请参见 规则与限制 |
-3015 | 请求的页码不存在。 | - |
-3075 | 该文档超过100MB，无法解析。 | 输入文件大小需限制在100MB之内。 |
-5062 | 图片涉嫌违禁。 | 请检查图片内容是否违规。 |
-6101 | 图片不存在、图片没有上传或者图片已经删除。 | 请检查请求源数据。 |
-29033 | 下载请求无有效的 range。 | - |
-29034 | 下载的 offset 大于文件 size。 | - |
-29214 | 触发频控。 | |
-40168 | 原图为空数据。 | 请检查请求源数据。 |
-46152 | 非法的 bucketName。 | 请检查存储桶名称是否正确。 |
-46154 | 非法的 APPID。 | 请检查 APPID 是否正确。 |
-46614 | 文件尚未上传完成，禁止下载。 | 请等待文件上传成功后请求。 |
-46617 | 命中黑名单。 | 请检查图片内容是否违规。 |
-46618 | 签名校验失败。 | 请检查签名是否准确。 |
-46619 | 签名过期。 | 请更新签名。 |
-46620 | Bucket 被封禁。 | |
-46621 | 文件被封禁。 | |
-46627 | 用户目前在黑名单中。 | |
-46628 | 文件不存在。 | 请确认请求下载的文件是否真实存在。 |
-46642 | APPID 不存在。 | 请检查 APPID 是否正确。 |
-46646 | 文件已封禁。 | 文件已被封禁，请检查文件内容是否违规。 |
-46661 | 无权访问 | 请联系资源所有者授予权限。 |
图片持久化处理错误码
错误码 | 说明 | 处理措施 |
-60998 | 图片处理参数无效。 | 请检查图片处理规则是否正确。 |
-60997 | 图片处理规则过多。 | 持久化处理当前最多支持五条规则，请控制在五条以内。 |
-60996 | 文件太大，无法处理。 | 请将文件控制在32MB以内。 |
-60987 | 图片获取失败。 | 请检查图片 URL。 |
-60983 | 无效的 Host。 | 请检查 Host。 |
-60972 | 无效地域。 | |
-60967 | 图片样式不存在。 | 请检查图片样式。 |
-60957 | 样式数量超过上限。 | |
-60955 | 无效的 URL。 | 请检查 URL 是否正确。 |
-60950 | 未指定文件。 | 请在请求中指定需要处理的文件。 |
-60949 | 请求频率过高。 | |
-60948 | 账号涉嫌违规。 | |
-60938 | 签名信息不完整。 | 请检查签名信息中的必选项。 |
-60936 | 请求被拒绝。 | AccessDenied。 |
-60932 | 签名错误。 | 签名无效，请检查签名信息是否匹配。 |
-62999 | 无效的图片格式。 | 请检查图片格式是否正确。 |
文档预览错误码
错误码 | 说明 | 处理措施 |
-3006 | 文档为加密文件 | 建议使用已解密的文档。 |
-3008 | 文档长度为0 | 请确认文档是否正常。 |
-3011 | 文档类型不支持 | |
-3064 | 文件解析失败 | 文档解析失败，请检查资源是否损坏。 |
-3070 | 文件处理超时失败 | 任务处理超时失败，建议调整单次任务生成范围。 |
-3075 | 文档大小超过限制 | 文档资源限制，需要调整文档大小。 |
内容审核错误码
错误码 | 错误码 | 错误信息 | 说明 |
-65001 | InternalError | internal error, please try again. | 内部错误。 |
-65002 | InvalidArgument | invalid params | 参数/消息体解析失败。 |
-65003 | InvalidArgument | invalid params | 参数无效。 |
| | missing Object | 缺少 Object 的值。 |
| | invalid DetectType | DetectType 填写有误。 |
| | Param CallbackVersion is illegal | 参数 CallbackVersion 填写不正确。 |
| | No such bucket | 当前存储桶不存在。 |
| | The image is empty file | 图片内容为空。 |
| | Param is illegal | 参数填写不正确。 |
-65004 | AuditingJobNotFound | JobId not found | 任务不存在。 |
-65006 | SlowDown | RequestLimitExceeded | 请求频率过高。 |
-65007 | ResourceNotSupported | Decode file failed | 文件解码失败，请检查文件是否损坏。 |
-65010 | InvalidArgument | Download file failed | 下载文件失败，请检查文件是否损坏。 |
| | url unreachable | |
-65011 | InvalidArgument | File is too large | 文件过大，不支持审核。 |
| | File is too large or empty | |
| ImageTooLarge | Input image's size exceeded limit | 图片过大，不支持审核。 |
-65012 | InvalidArgument | Resolution is too small | 图片分辨率过低，不支持审核。 |
-65014 | CIRoleNotExist | No permission for CI_QCSRole | 审核失败，请先开通数据万象角色。 (万象角色不存在/未授权) |
-65015 | InvalidArgument | There is not any label opened | 未使用审核策略，请添加审核策略后重试。 |
-65016 | InvalidArgument | The bizType provided does not exist | 提供的BizType不存在，请检查后重试。 |
-65019 | AccessDenied | No permission to do this | 鉴权失败, 没有passrole权限。 |
-65020 | ResourceNotFound | The file does not exist | 文件不存在。 |
| | No such key | |
| | No such object | |
-65023 | InvalidArgument | File size is too small | 文件大小太小。 |
-65024 | InvalidArgument | Image aspect ratio is too large | 图片宽高比过大。 |
| ImageTooLarge | Input image's width or height exceeded limit | 图片的宽或高超过限制。 |
媒体处理错误码
错误码 | 错误信息 | 说明 |
1007 | InternalError | 内部错误 |
1010 | InvalidUrl | 无效的 url |
1011 | InvalidContent | 无效的请求体 |
1012 | MissingAuthorization | 缺失签名 |
1013 | InvalidAuthorization | 无效的签名 |
1014 | SignatureExpired | 签名已过期 |
1015 | InvalidArgument | 无效的参数 |
1016 | MissingContent | 缺失请求体 |
1017 | InvalidHost | 无效的 host |
1018 | AccessDenied | 拒绝访问 |
1019 | SecretidNotExist | 密钥不存在 |
1020 | SlowDown | 频率控制 |
1021 | InvalidContentType | 请求体类型无效 |
1100 | BucketAlreadyBinded | 存储桶已绑定 |
1103 | ResourceNotFound | 资源未找到 |
1106 | QueueNotFound | 队列未找到 |
1107 | TemplateNotFound | 模板未找到 |
1109 | BindedBucketNumLimit | 绑定的存储桶数量超过上限 |
1110 | CreatedTemplateNumLimit | 创建的模板数量超过上限 |
1111 | MediaBucketUnBinded | 存储桶未绑定 |
1112 | TemplateNameDuplicate | 模板命名重复 |
1114 | ActiveWorkflowForbiddenUpdate | 开启的工作流禁止更新 |
1120 | WorkFlowNumLimit | 创建的工作流数量超过上限 |
1124 | WriteTargetBucketDenied | 禁止写入存储桶 |
1145 | QueueNumLimit | 创建的队列数量超过上限 |
