tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
对象存储
    文档
    Download PDF

    错误码

    最后更新时间：2023-12-20 14:50:18
    下载PDF

      概述

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

      错误响应

      Content-Type：application/xml
      对应 HTTP 状态码：3XX，4XX，5XX。对于 PUT Object - Copy 接口，即使 HTTP 状态码为200也有可能在响应体中包含错误。

      响应体

      <?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
      提供的 Content-MD5 值与服务端收到的请求体的 MD5 哈希值不一致
      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
      请求体大小与 Content-Length 请求头不符
      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
      请求体大小小于 Content-Length 请求头
      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
      给定的 Content-MD5 值不合法
      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
      单可用区（单 AZ）存储桶不支持多可用区（多 AZ）操作。关于多 AZ 特性及使用限制的说明请参见 多 AZ 特性概述
      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
      多可用区存储桶不支持单可用区操作。关于多 AZ 特性及使用限制的说明请参见 多 AZ 特性概述
      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
      签名或者权限不正确，拒绝访问。请参考 请求签名 和 ACL 概述
      403 Forbidden
      AccessForbidden
      跨域资源共享（CORS）请求被拒绝，请检查请求方法或请求头部中的 Origin、Access-Control-Request-Method、Access-Control-Request-Headers 是否在配置的 CORS 白名单中
      403 Forbidden
      InvalidAccessKeyId
      SecretID 不存在
      403 Forbidden
      InvalidObjectState
      对象存储类型与操作请求冲突
      403 Forbidden
      NoProcessAuthority
      没有处理图片的权限
      403 Forbidden
      RequestTimeTooSkewed
      本地时间与服务器时间相差过大，超过15分钟
      403 Forbidden
      Request has expired
      发起请求的时间超过了签名的有效时间，或者本地系统时间和所在时区的时间不一致。详情请参见 常见问题
      403 Forbidden
      SignatureDoesNotMatch
      客户端计算的签名与 COS 服务端计算的签名不一致。请参阅 请求签名 文档并借助COS 请求签名工具 检查自行实现的签名过程
      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
      指定的对象键不存在。检查对象是否存在请使用 HEAD Object 接口
      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 ObjectNotAppendable
      ObjectNotAppendable
      指定的对象不能追加
      411 Length Required
      MissingContentLength
      Content-Length 请求头部缺失
      412 Precondition Failed
      PreconditionFailed
      前置条件不匹配
      416 Requested Range Not Satisfiable
      InvalidRange
      请求的对象范围不合法
      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
      请降低访问频率

      数据处理相关错误码

      图片下载时处理错误码

      错误码
      说明
      处理措施
      -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 被封禁。
      您的 Bucket 已被封禁，请 提交工单 联系我们处理。
      -46621
      文件被封禁。
      您的资源已被封禁，请 提交工单 联系我们处理。
      -46627
      用户目前在黑名单中。
      您的账号已被封禁，请 提交工单 联系我们处理。
      -46628
      文件不存在。
      请确认请求下载的文件是否真实存在。
      -46642
      APPID 不存在。
      请检查 APPID 是否正确。
      -46646
      文件已封禁。
      文件已被封禁，请检查文件内容是否违规。
      -46661
      无权访问
      请联系资源所有者授予权限。

      图片持久化处理错误码

      错误码
      说明
      处理措施
      -60998
      图片处理参数无效。
      请检查图片处理规则是否正确。
      -60997
      图片处理规则过多。
      持久化处理当前最多支持五条规则，请控制在五条以内。
      -60996
      文件太大，无法处理。
      请将文件控制在32MB以内。
      -60987
      图片获取失败。
      请检查图片 URL。
      -60983
      无效的 Host。
      请检查 Host。
      -60972
      无效地域。
      请检查请求地域是否支持数据万象服务。数据万象现有地域详见 地域与域名。
      -60967
      图片样式不存在。
      请检查图片样式。
      -60957
      样式数量超过上限。
      当前样式数量上限为100条，如需更多样式请 提交工单 联系我们。
      -60955
      无效的 URL。
      请检查 URL 是否正确。
      -60950
      未指定文件。
      请在请求中指定需要处理的文件。
      -60949
      请求频率过高。
      请放缓请求频率。如有需要请 提交工单 联系我们提升频率限制。
      -60948
      账号涉嫌违规。
      您的 APPID 已被封禁，请 提交工单 联系我们处理。
      -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。
      其他
      内部错误
      无。
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款