# 错误码 调用接口出错后，将不会返回结果数据。调用方可根据每个接口对应的错误码来定位错误原因。 当调用出错时，HTTP请求返回一个3xx，4xx或5xx的HTTP状态码。返回的消息体中是具体的错误代码及错误信息。在调用方找不到错误原因时，可以联系华为云客服，并提供错误码，以便我们尽快帮您解决问题。 #### 错误响应消息格式 当错误发生时，响应消息头中都会包含： - Content-Type: application/xml - 错误对应的3xx，4xx或5xx的HTTP状态码。 响应消息体中同样会包含对错误的描述信息。下面的错误响应消息体示例展示了所有REST错误响应中公共的元素。 ``` NoSuchKey The resource you requested does not exist /example-filesystem/object 001B21A61C6C0000013402C4616D5285 RkRCRDJENDc5MzdGQkQ4OUY3MTI4NTQ3NDk2Mjg0M0FB QUFBQUFBYmJiYmJiYmJD ``` 各元素的具体含义如[表1]所示。 表1错误响应消息元素 | 元素名称 | 描述 | |:---|:---| | Error | 错误响应消息体XML结构中描述错误信息的根节点元素 。 | | Code | 错误响应消息体XML中错误响应对应的HTTP消息返回码，具体的错误码请参见[表2]。 | | Message | 错误响应消息体XML中具体错误更全面、详细的英文解释，具体的错误消息请参见[表2]。 | | RequestId | 本次错误请求的请求ID，用于错误定位。 | | HostId | 返回该消息的服务端ID。 | | Resource | 该错误相关的文件系统或对象资源。 | ![](https://support.huaweicloud.com/api-sfs/public_sys-resources/note_3.0-zh-cn.png) 许多错误响应包含其他的更丰富的错误信息， 建议将所有错误信息记入日志，方便程序员在诊断程序错误时阅读和理解。 #### 错误码说明 在向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 | MalformedError | 请求中携带的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）如何处理](https://support.huaweicloud.com/obs_faq/obs_faq_0173.html)。 | | 403 Forbidden | VirtualHostDomainRequired | 未使用虚拟主机访问域名。 | Host使用[虚拟主机访问域名](https://support.huaweicloud.com/api-sfs/sfs_02_0101.html)。 | | 403 Forbidden | Unauthorized | 用户未实名认证。 | 请实名认证后重试。 | | 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 | 请降低请求频率。 | 请降低请求频率。 |