History
Introduction
API Category
Making API Requests
Region APIs
Instance APIs
Cloud Hosting Cluster APIs
Image APIs
Instance Launch Template APIs
Placement Group APIs
Key APIs
Security Group APIs
Network APIs
Data Types
Error Codes
<?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 |
节点名称(关键字) | 父节点 | 描述 | 类型 |
Code | Error | 错误码,用来定位唯一的错误条件和确定错误场景,具体错误码见下文 | string |
Message | Error | 具体的错误信息 | string |
Resource | Error | 请求的资源,存储桶地址或对象地址 | string |
RequestId | Error | 每次请求发送时,服务端将会自动为请求生成一个 ID,遇到问题时,该 ID 能更快地协助 COS 定位问题 | string |
TraceId | Error | 每次请求出错时,服务端将会自动为这个错误生成一个 ID,遇到问题时,该 ID 能更快地协助 COS 定位问题 | string |
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 |
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 | 文档大小超过限制 | 文档资源限制,需要调整文档大小 |
错误码 | 说明 | 处理措施 |
-61011 | 文件不存在 | 请检查文件是否存在 |
-65007 | 文件内容错误,解码失败 | 请检查文件格式是否正确 |
-65010 | 下载文件失败 | 请检查文件链接是否正确,私有读文件需要携带签名 |
-65011 | 文件过大,无法处理 | 当前不支持审核过大的文件 |
-65012 | 图片分辨率过小,无法处理 | 当前不支持分辨率过小的图片 |
-65013 | 不符合要求(例如不支持识别的文件后缀、文件过大等),未进行处理 | 请检查文件是否符合规则 |
-65014 | 没有数据万象角色 CI_QCSRole | 请绑定数据万象角色 |
-65015 | 未启用审核场景 | 请使用至少一种审核场景进行审核 |
-65016 | 使用的 BizType 不存在 | 请填写正确的 BizType |
其他 | 内部错误 | 无 |
文档反馈