错误码

最后更新时间:2020-08-10 16:26:34

    概述

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

    错误响应

    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 BadRquest 参数错误
    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 单可用区存储桶不支持多可用区操作
    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 多可用区存储桶不支持单可用区操作
    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-Requet-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 服务端计算的签名不一致。请参阅 请求签名 文档。
    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 RestoreFileSizeExceed 超过 256MB 的对象不能使用极速模式(Expedited)恢复
    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 QuotaOperationConfilct 该存储桶的状态不适用于该操作
    409 Conflict RecordAlreadyExist DNS 记录冲突,请删除冲突的记录,或添加 CNAME/TXT 记录
    409 Conflict RestoreAlreadyInProgress 该对象正在回热(恢复)中
    409 Conflict UploadConflict 同一个对象键频繁上传会导致冲突
    409 ObjectNotAppendale 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 请降低访问频率

    Was this page helpful?

    本页内容是否解决了您的问题?

    • 完全没帮助
    • 文档较差
    • 文档一般
    • 文档不错
    • 文档很好
    反馈
    帮助