计算
弹性云服务器 ECS
Flexus云服务
裸金属服务器 BMS
弹性伸缩 AS
镜像服务 IMS
专属主机 DeH
函数工作流 FunctionGraph
云手机服务器 CPH
Huawei Cloud EulerOS
网络
虚拟私有云 VPC
弹性公网IP EIP
虚拟专用网络 VPN
弹性负载均衡 ELB
NAT网关 NAT
云专线 DC
VPC终端节点 VPCEP
云连接 CC
企业路由器 ER
企业交换机 ESW
全球加速 GA
安全与合规
安全技术与应用
Web应用防火墙 WAF
企业主机安全 HSS
云防火墙 CFW
安全云脑 SecMaster
DDoS防护 AAD
数据加密服务 DEW
数据库安全服务 DBSS
云堡垒机 CBH
数据安全中心 DSC
云证书管理服务 CCM
边缘安全 EdgeSec
态势感知 SA
威胁检测服务 MTD
CDN与智能边缘
内容分发网络 CDN
CloudPond云服务
智能边缘云 IEC
迁移
主机迁移服务 SMS
对象存储迁移服务 OMS
云数据迁移 CDM
迁移中心 MGC
大数据
MapReduce服务 MRS
数据湖探索 DLI
表格存储服务 CloudTable
云搜索服务 CSS
数据接入服务 DIS
数据仓库服务 GaussDB(DWS)
数据治理中心 DataArts Studio
数据可视化 DLV
数据湖工厂 DLF
湖仓构建 LakeFormation
企业应用
云桌面 Workspace
应用与数据集成平台 ROMA Connect
云解析服务 DNS
专属云
专属计算集群 DCC
IoT物联网
IoT物联网
设备接入 IoTDA
智能边缘平台 IEF
用户服务
账号中心
费用中心
成本中心
资源中心
企业管理
工单管理
国际站常见问题
ICP备案
我的凭证
支持计划
客户运营能力
合作伙伴支持计划
专业服务
区块链
区块链服务 BCS
Web3节点引擎服务 NES
解决方案
SAP
高性能计算 HPC
视频
视频直播 Live
视频点播 VOD
媒体处理 MPC
实时音视频 SparkRTC
数字内容生产线 MetaStudio
存储
对象存储服务 OBS
云硬盘 EVS
云备份 CBR
存储容灾服务 SDRS
高性能弹性文件服务 SFS Turbo
弹性文件服务 SFS
云硬盘备份 VBS
云服务器备份 CSBS
数据快递服务 DES
专属分布式存储服务 DSS
容器
云容器引擎 CCE
容器镜像服务 SWR
应用服务网格 ASM
华为云UCS
云容器实例 CCI
管理与监管
云监控服务 CES
统一身份认证服务 IAM
资源编排服务 RFS
云审计服务 CTS
标签管理服务 TMS
云日志服务 LTS
配置审计 Config
资源访问管理 RAM
消息通知服务 SMN
应用运维管理 AOM
应用性能管理 APM
组织 Organizations
优化顾问 OA
IAM 身份中心
云运维中心 COC
资源治理中心 RGC
应用身份管理服务 OneAccess
数据库
云数据库 RDS
文档数据库服务 DDS
数据管理服务 DAS
数据复制服务 DRS
云数据库 GeminiDB
云数据库 GaussDB
分布式数据库中间件 DDM
数据库和应用迁移 UGO
云数据库 TaurusDB
人工智能
人脸识别服务 FRS
图引擎服务 GES
图像识别 Image
内容审核 Moderation
文字识别 OCR
AI开发平台ModelArts
图像搜索 ImageSearch
对话机器人服务 CBS
华为HiLens
视频智能分析服务 VIAS
语音交互服务 SIS
应用中间件
分布式缓存服务 DCS
API网关 APIG
微服务引擎 CSE
分布式消息服务Kafka版
分布式消息服务RabbitMQ版
分布式消息服务RocketMQ版
多活高可用服务 MAS
事件网格 EG
企业协同
华为云会议 Meeting
云通信
消息&短信 MSGSMS
云生态
合作伙伴中心
云商店
开发者工具
SDK开发指南
API签名指南
Terraform
华为云命令行工具服务 KooCLI
其他
产品价格详情
系统权限
管理控制台
客户关联华为云合作伙伴须知
消息中心
公共问题
开发与运维
应用管理与运维平台 ServiceStage
软件开发生产线 CodeArts
需求管理 CodeArts Req
部署 CodeArts Deploy
性能测试 CodeArts PerfTest
编译构建 CodeArts Build
流水线 CodeArts Pipeline
制品仓库 CodeArts Artifact
测试计划 CodeArts TestPlan
代码检查 CodeArts Check
代码托管 CodeArts Repo
云应用引擎 CAE
开天aPaaS
云消息服务 KooMessage
云手机服务 KooPhone
云空间服务 KooDrive
本文导读

错误码

更新时间:2024-03-05 GMT+08:00

调用接口出错后,将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时,HTTP请求返回一个3xx,4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。

错误响应消息格式

当错误发生时,响应消息头中都会包含:

  • Content-Type: application/xml
  • 错误对应的3xx,4xx或5xx的HTTP状态码。

响应消息体中同样会包含对错误的描述信息。下面的错误响应消息体示例展示了所有REST错误响应中公共的元素。

1
2
3
4
5
6
7
8
9
<?xml version="1.0" encoding="UTF-8"?> 
<Error> 
<Code>NoSuchKey</Code> 
<Message>The resource you requested does not exist</Message> 
<Resource>/example-bucket/object</Resource> 
<RequestId>001B21A61C6C0000013402C4616D5285</RequestId> 
<HostId>RkRCRDJENDc5MzdGQkQ4OUY3MTI4NTQ3NDk2Mjg0M0FB 
QUFBQUFBYmJiYmJiYmJD</HostId> 
</Error>

各元素的具体含义如表1所示。

表1 错误响应消息元素

元素名称

描述

Error

错误响应消息体XML结构中描述错误信息的根节点元素 。

Code

错误响应消息体XML中错误响应对应的HTTP消息返回码,具体的错误码请参见表2

Message

错误响应消息体XML中具体错误更全面、详细的英文解释,具体的错误消息请参见表2

RequestId

本次错误请求的请求ID,用于错误定位。

HostId

返回该消息的服务端ID。

Resource

该错误相关的桶或对象资源。

说明:

许多错误响应包含其他的更丰富的错误信息, 建议将所有错误信息记入日志,方便程序员在诊断程序错误时阅读和理解。

错误码说明

在向OBS系统发出请求后,如果遇到错误,会在响应中包含响应的错误码描述错误信息。对象存储访问服务的错误码如表2所示。

表2 错误码

状态码

错误码

错误信息

处理措施

301 Moved Permanently

PermanentRedirect

尝试访问的桶必须使用指定的地址,请将以后的请求发送到这个地址。

按照返回的重定向地址发送请求。

301 Moved Permanently

WebsiteRedirect

Website请求缺少bucketName。

携带桶名后重试。

307 Moved Temporarily

TemporaryRedirect

临时重定向,当DNS更新时,请求将被重定向到桶。

会自动重定向,也可以将请求发送到重定向地址。

400 Bad Request

BadDigest

客户端指定的对象内容的MD5值与系统接收到的内容MD5值不一致。

检查头域中携带的MD5与消息体计算出来的MD5是否一致。

400 Bad Request

BadDomainName

域名不合法。

使用合法的域名。

400 Bad Request

BadRequest

请求参数不合法。

根据返回的错误消息体提示进行修改。

400 Bad Request

CustomDomainAreadyExist

配置了已存在的域。

已经配置过了,不需要再配置。

400 Bad Request

CustomDomainNotExist

删除不存在的域。

未配置或已经删除,无需删除。

400 Bad Request

EntityTooLarge

  • 通过SDK或API的PUT上传、POST上传和追加写超过5GB的文件
  • 上传段超过5GB
  • 设置的桶配置超过20KB
  • 超过post表单中policy限制的文件大小(用户可自定义)
  • 通过SDK或API的多段上传以及SDK的断点续传超过48.8TB的文

修改上传的policy中的条件或者减少对象大小。

400 Bad Request

EntityTooSmall

  • 上传段除最后一段小于100KB
  • 小于post表单中policy限制的文件大小(用户可自定义)

修改上传的policy中的条件或者增加对象大小。

400 Bad Request

IllegalLocationConstraintException

用户未带Location在非默认Region创桶。

请求发往默认Region创桶或带非默认Region的Location创桶。

400 Bad Request

IncompleteBody

由于网络原因或其他问题导致请求体未接受完整。

重新上传对象。

400 Bad Request

IncorrectNumberOfFilesInPost Request

每个POST请求都需要带一个上传的文件。

带上一个上传文件。

400 Bad Request

InvalidArgument

无效的参数。

根据返回的错误消息体提示进行修改。

400 Bad Request

InvalidBucket

请求访问的桶已不存在。

更换桶名。

400 Bad Request

InvalidBucketName

请求中指定的桶名无效,超长或带不允许的特殊字符。

更换桶名。

400 Bad Request

InvalidContentLength

Content-Length头域内容有误。

请检查封装头域或联系技术支持。

400 Bad Request

InvalidDefaultStorageClass

存储类别不可用。

请确认能够使用的存储类别。

400 Bad Request

InvalidEncryptionAlgorithmError

错误的加密算法。下载SSE-C加密的对象,携带的加密头域错误,导致不能解密。

携带正确的加密头域下载对象。

400 Bad Request

InvalidLocationConstraint

创建桶时,指定的Location不合法或不存在。

指定正确的Location创桶。

400 Bad Request

InvalidPart

一个或多个指定的段无法找到。这些段可能没有上传,或者指定的entity tag与段的entity tag不一致。

按照正确的段和entity tag合并段。

400 Bad Request

InvalidPartOrder

段列表的顺序不是升序,段列表必须按段号升序排列。

按段号升序排列后重新合并。

400 Bad Request

InvalidPolicyDocument

表单中的内容与策略文档中指定的条件不一致。

根据返回的错误消息体提示修改构造表单的policy重试。

400 Bad Request

InvalidRedirectLocation

无效的重定向地址。

指定正确的地址。

400 Bad Request

InvalidRequest

无效请求。

根据返回的错误消息体提示进行修改。

400 Bad Request

InvalidRequestBody

请求体无效,需要消息体的请求没有上传消息体。

按照正确的格式上传消息体。

400 Bad Request

InvalidTargetBucketForLogging

delivery group对目标桶无ACL权限。

对目标桶配置ACL权限后重试。

400 Bad Request

KeyTooLongError

提供的Key过长。

使用较短的Key。

400 Bad Request

KMS.DisabledException

SSE-KMS加密方式下,主密钥被禁用。

更换密钥后重试,或联系技术支持。

400 Bad Request

KMS.NotFoundException

SSE-KMS加密方式下,主密钥不存在。

携带正确的主密钥重试。

400 Bad Request

MalformedACLError

提供的XML格式错误,或者不符合要求的格式。

使用正确的XML格式重试。

400 Bad Request

MalformedError

请求中携带的XML格式不正确。

使用正确的XML格式重试。

400 Bad Request

MalformedLoggingStatus

Logging的XML格式不正确。

使用正确的XML格式重试。

400 Bad Request

MalformedPolicy

Bucket policy检查不通过。

根据返回的错误消息体提示结合桶policy的要求进行修改。

400 Bad Request

MalformedQuotaError

Quota的XML格式不正确。

使用正确的XML格式重试。

400 Bad Request

MalformedXML

当用户发送了一个配置项的错误格式的XML会出现这样的错误。

使用正确的XML格式重试。

400 Bad Request

MaxMessageLengthExceeded

拷贝对象,带请求消息体。

拷贝对象不带消息体重试。

400 Bad Request

MetadataTooLarge

元数据消息头超过了允许的最大元数据大小。

减少元数据消息头。

400 Bad Request

MissingRegion

请求中缺少Region信息,且系统无默认Region。

请求中携带Region信息。

400 Bad Request

MissingRequestBodyError

当用户发送一个空的XML文档作为请求时会发生。

提供正确的XML文档。

400 Bad Request

MissingRequiredHeader

请求中缺少必要的头域。

提供必要的头域。

400 Bad Request

MissingSecurityHeader

请求缺少一个必须的头。

提供必要的头域。

400 Bad Request

MultipleContentLengths

多个Content-Length头域。

请检查封装头域或者联系技术支持。

400 Bad Request

TooManyBuckets

用户拥有的桶的数量达到了系统的上限,并且请求试图创建一个新桶。

删除部分桶后重试。

400 Bad Request

TooManyCustomDomains

配置了过多的用户域。

删除部分用户域后重试。

400 Bad Request

TooManyWrongSignature

因高频错误请求被拒绝服务。

更换正确的Access Key后重试。

400 Bad Request

UnexpectedContent

该请求需要消息体而客户端没带,或该请求不需要消息体而客户端带了。

根据说明重试。

400 Bad Request

UserKeyMustBeSpecified

该操作只有特殊用户可使用。

请联系技术支持。

403 Forbidden

AccessDenied

拒绝访问,请求没有携带日期头域或者头域格式错误。

请求携带正确的日期头域。

403 Forbidden

AccessForbidden

权限不足,桶未配置CORS或者CORS规则不匹配。

修改桶的CORS配置,或者根据桶的CORS配置发送匹配的OPTIONS请求。

403 Forbidden

AllAccessDisabled

用户无权限执行某操作。桶名为禁用关键字。

更换桶名。

403 Forbidden

DeregisterUserId

用户已经注销。

充值或重新开户。

403 Forbidden

InArrearOrInsufficientBalance

用户欠费或余额不足而没有权限进行某种操作。

充值。

403 Forbidden

InsufficientStorageSpace

存储空间不足。

超过配额限制,增加配额或删除部分对象。

403 Forbidden

InvalidAccessKeyId

系统记录中不存在客户提供的Access Key Id。

携带正确的Access Key Id。

403 Forbidden

InvalidObjectState

冷对象不能直接下载,需要先进行恢复才能下载。

先对对象进行恢复操作。

403 Forbidden

NotSignedUp

你的账户还没有在系统中注册,必须先在系统中注册了才能使用该账户。

先注册OBS服务。

403 Forbidden

RequestTimeTooSkewed

客户端发起请求的时间与OBS服务端的时间相差太大。

出于安全目的,OBS会校验客户端与OBS服务端的时间差,当该时间差大于15分钟时,OBS服务端会拒绝您的请求,从而出现此报错。

请检查客户端时间是否与当前OBS服务端时间相差太大。请根据本地UTC时间调整客户端时间后再访问。

403 Forbidden

SignatureDoesNotMatch

请求中带的签名与系统计算得到的签名不一致。

检查你的Secret Access Key和签名计算方法。

403 Forbidden

VirtualHostDomainRequired

未使用虚拟主机访问域名。

Host使用虚拟主机访问域名

403 Forbidden

Unauthorized

用户未实名认证。

请实名认证后重试。

404 Not Found

NoSuchBucket

指定的桶不存在。

先创桶再操作。

404 Not Found

NoSuchBucketPolicy

桶policy不存在。

先配置桶policy。

404 Not Found

NoSuchCORSConfiguration

CORS配置不存在。

先配置CORS。

404 Not Found

NoSuchCustomDomain

请求的用户域不存在。

先设置用户域。

404 Not Found

NoSuchKey

指定的Key不存在。

先上传对象。

404 Not Found

NoSuchLifecycleConfiguration

请求的LifeCycle不存在。

先配置LifeCycle。

404 Not Found

NoSuchUpload

指定的多段上传不存在。Upload ID不存在,或者多段上传已经终止或完成。

使用存在的段或重新初始化段。

404 Not Found

NoSuchVersion

请求中指定的version ID与现存的所有版本都不匹配。

使用正确的version ID。

404 Not Found

NoSuchWebsiteConfiguration

请求的Website不存在。

先配置Website。

405 Method Not Allowed

MethodNotAllowed

指定的方法不允许操作在请求的资源上。

对应返回的Message为:Specified method is not supported.

方法不允许。

405 Method Not Allowed

FsNotSupport

posix桶不支持该API。

方法不允许。

408 Request Timeout

RequestTimeout

用户与Server之间的socket连接在超时时间内没有进行读写操作。

检查网络后重试,或联系技术支持。

409 Conflict

BucketAlreadyExists

请求的桶名已经存在。桶的命名空间是系统中所有用户共用的,选择一个不同的桶名再重试一次。

更换桶名。

409 Conflict

BucketAlreadyOwnedByYou

发起该请求的用户已经创建过了这个名字的桶,并拥有这个桶。

不需要再创桶了。

409 Conflict

BucketNotEmpty

用户尝试删除的桶不为空。

先删除桶中对象,然后再删桶。

409 Conflict

InvalidBucketState

无效的桶状态,配置跨Region复制后不允许关闭桶多版本。

不关闭桶的多版本或取消跨Region复制。

409 Conflict

OperationAborted

另外一个冲突的操作当前正作用在这个资源上,请重试。

等待一段时间后重试。

409 Conflict

ServiceNotSupported

请求的方法服务端不支持。

服务端不支持,请联系技术支持。

409 ObjectNotAppendable

ObjectNotAppendable

该对象不支持追加上传

请确认桶类型,并行文件系统不支持追加上传。请确认对象类型,冷存储对象不支持追加上传。

411 Length Required

MissingContentLength

必须要提供HTTP消息头中的Content-Length字段。

提供Content-Length消息头。

412 Precondition Failed

PreconditionFailed

用户指定的先决条件中至少有一项没有包含。

根据返回消息体中的Condition提示进行修改。

414 URI Too Long

Request-URI Too Large

请求使用的URI过长

请减少URI的长度。

416 Client Requested Range Not Satisfiable

InvalidRange

请求的range不可获得。

携带正确的range重试。

500 Internal Server Error

InternalError

系统遇到内部错误,请重试。

请联系技术支持。

501 Not Implemented

ServiceNotImplemented

请求的方法服务端没有实现。

当前不支持,请联系技术支持。

503 Service Unavailable

ServiceUnavailable

服务器过载或者内部错误异常。

等待一段时间后重试,或联系技术支持。

503 Service Unavailable

SlowDown

请降低请求频率。

请降低请求频率。

我们使用cookie来确保您的高速浏览体验。继续浏览本站,即表示您同意我们使用cookie。 详情

文档反馈

文档反馈

意见反馈

0/500

标记内容

同时提交标记内容