通用文件系统错误码

调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便我们尽快帮您解决问题。

错误响应消息格式

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

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

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

    
         <?xml version="1.0" encoding="UTF-8"?> 
<Error> 
<Code>NoSuchKey</Code> 
<Message>The resource you requested does not exist</Message> 
<Resource>/example-filesystem/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	该错误相关的文件系统或对象资源。

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

错误码说明

在向SFS系统发出请求后，如果遇到错误，会在响应中包含响应的错误码描述错误信息。通用文件系统的错误码如表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	IllegalLocationConstraintException	用户未带Location在非默认Region创文件系统。	请求发往默认Region创文件系统或带非默认Region的Location创文件系统。
400 Bad Request	InvalidArgument	无效的参数。	根据返回的错误消息体提示进行修改。
400 Bad Request	InvalidBucket	请求访问的文件系统已不存在。	更换文件系统名。
400 Bad Request	InvalidBucketName	请求中指定的文件系统名无效，超长或带不允许的特殊字符。	更换文件系统名。
400 Bad Request	InvalidLocationConstraint	创建文件系统时，指定的Location不合法或不存在。	指定正确的Location创文件系统。
400 Bad Request	InvalidPolicyDocument	表单中的内容与策略文档中指定的条件不一致。	根据返回的错误消息体提示修改构造表单的policy重试。
400 Bad Request	InvalidRedirectLocation	无效的重定向地址。	指定正确的地址。
400 Bad Request	InvalidRequest	无效请求。	根据返回的错误消息体提示进行修改。
400 Bad Request	InvalidRequestBody	请求体无效，需要消息体的请求没有上传消息体。	按照正确的格式上传消息体。
400 Bad Request	KeyTooLongError	提供的Key过长。	使用较短的Key。
400 Bad Request	MalformedACLError	提供的XML格式错误，或者不符合我们要求的格式。	使用正确的XML格式重试。
400 Bad Request	MalformedError	请求中携带的XML格式不正确。	使用正确的XML格式重试。
400 Bad Request	MalformedLoggingStatus	Logging的XML格式不正确。	使用正确的XML格式重试。
400 Bad Request	MalformedQuotaError	Quota的XML格式不正确。	使用正确的XML格式重试。
400 Bad Request	MalformedXML	当用户发送了一个配置项的错误格式的XML会出现这样的错误。	使用正确的XML格式重试。
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	TooManyBuckets	用户拥有的文件系统的数量达到了系统的上限，并且请求试图创建一个新文件系统。	删除部分文件系统后重试。
400 Bad Request	TooManyWrongSignature	因高频错误请求被拒绝服务。	更换正确的Access Key后重试。
400 Bad Request	UnexpectedContent	该请求需要消息体而客户端没带，或该请求不需要消息体而客户端带了。	根据说明重试。
400 Bad Request	ContentSHA256Mismatch	客户端与服务端计算的对象的SHA256值不一致。	建议重新确认客户端计算的对象的SHA256的值是否正确。
403 Forbidden	AccessDenied	拒绝访问，请求没有携带日期头域或者头域格式错误。	请求携带正确的日期头域。
403 Forbidden	DeregisterUserId	用户已经注销。	充值或重新开户。
403 Forbidden	InArrearOrInsufficientBalance	用户欠费或余额不足而没有权限进行某种操作。	充值。
403 Forbidden	InvalidAccessKeyId	系统记录中不存在客户提供的Access Key Id。	携带正确的Access Key Id。
403 Forbidden	RequestTimeTooSkewed	客户端发起请求的时间与OBS服务端的时间相差太大。出于安全目的，OBS会校验客户端与OBS服务端的时间差，当该时间差大于15分钟时，OBS服务端会拒绝您的请求，从而出现此报错。	请检查客户端时间是否与当前OBS服务端时间相差太大。请根据本地UTC时间调整客户端时间后再访问。
403 Forbidden	SignatureDoesNotMatch	请求中带的签名与系统计算得到的签名不一致。	检查您的Secret Access Key和签名计算方法。详细排查方法请参见签名不匹配（SignatureDoesNotMatch）如何处理。
403 Forbidden	VirtualHostDomainRequired	未使用虚拟主机访问域名。	Host使用虚拟主机访问域名。
403 Forbidden	Unauthorized	用户未实名认证。	请实名认证后重试。
403 Forbidden	RequestPayerDenied	文件系统为请求者付费文件系统。	请携带请求者付费的指定头域x-obs-request-payer: requester访问。
404 Not Found	NoSuchBucket	指定的文件系统不存在。	先创文件系统再操作。
404 Not Found	NoSuchLifecycleConfiguration	请求的LifeCycle不存在。	先配置LifeCycle。
405 Method Not Allowed	MethodNotAllowed	指定的方法不允许操作在请求的资源上。对应返回的Message为：Specified method is not supported.	方法不允许。
408 Request Timeout	RequestTimeout	用户与Server之间的socket连接在超时时间内没有进行读写操作。	检查网络后重试，或联系技术支持。
409 Conflict	BucketAlreadyExists	请求的文件系统名已经存在。文件系统的命名空间是系统中所有用户共用的，选择一个不同的文件系统名再重试一次。	更换文件系统名。
409 Conflict	BucketAlreadyOwnedByYou	发起该请求的用户已经创建过了这个名字的文件系统，并拥有这个文件系统。	不需要再创文件系统了。
409 Conflict	BucketNotEmpty	用户尝试删除的文件系统不为空。	先删除文件系统中对象，然后再删文件系统。
409 Conflict	ServiceNotSupported	请求的方法服务端不支持。	服务端不支持，请联系技术支持。
411 Length Required	MissingContentLength	必须要提供HTTP消息头中的Content-Length字段。	提供Content-Length消息头。
412 Precondition Failed	PreconditionFailed	用户指定的先决条件中至少有一项没有包含。	根据返回消息体中的Condition提示进行修改。
500 Internal Server Error	InternalError	系统遇到内部错误，请重试。	请联系技术支持。
501 Not Implemented	ServiceNotImplemented	请求的方法服务端没有实现。	当前不支持，请联系技术支持。
503 Service Unavailable	ServiceUnavailable	服务器过载或者内部错误异常。	等待一段时间后重试，或联系技术支持。
503 Service Unavailable	SlowDown	请降低请求频率。	请降低请求频率。

父主题： 附录

上一篇：SFS Turbo错误码

下一篇：获取访问密钥（AK/SK）

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消