如您使用原生接口接入,请参考以下状态码。
错误码响应体
```xml
<?xml version='1.0' encoding='utf-8' ?>
<Error>
<Code>string</Code>
<Message>string</Message>
<Resource>string</Resource>
<RequestId>string</RequestId>
</Error>
响应体各元素的详细定义请参见下表。
名称 | 描述 |
---|---|
Error | 错误响应体中描述错误相关信息的根节点 |
Code | 唯一错误码,参考下面表格列出的常见错误码描述 |
Message | 对错误的具体描述 |
Resource | 被错误关联的请求资源信息 |
RequestId | 错误对应的请求ID |
错误码说明
发出请求后,如果遇到错误,在响应的错误信息中会包含错误码等具体的错误信息。访问对象存储服务的错误码如下表所示。
状态码 | 错误码 | 描述 | 备注 |
---|---|---|---|
301 Moved Permanently | PermanentRedirect | 尝试访问的桶必须使用指定的地址,请将以后的请求发送到这个地址 | |
307 Moved Permanently | TemporaryRedirect | 临时重定向,当DNS更新时,请求将被重定向到bucket | |
304 Not Modified | NotModified | 资源没有发生改变 | |
400 Bad Request | AmbiguousGrantByEmailAddress | 提供的电子邮件地址与多个帐户关联 | |
400 Bad Request | AuthorizationHeaderMalformed | 提供的授权header无效 | |
400 Bad Request | CredentialsNotSupported | 此请求不支持凭据 | |
400 Bad Request | ExpiredToken | 提供的令牌已过期 | |
400 Bad Request | IllegalVersioningConfigurationException | 请求中指定的版本控制配置无效 | |
400 Bad Request | InvalidArgument | 缺少特定参数或者参数不合法 | |
400 Bad Request | IncompleteBody | 未提供Content-Length HTTP头指定的字节数 | |
400 Bad Request | InvalidBucketName | 桶的名字不合法 | |
400 Bad Request | IncorrectNumberOfFilesInPostRequest | 每个请求只需要上载一个文件 | |
400 Bad Request | MalformedXML | xml格式有问题 | 标签xml、跨域xml等 |
400 Bad Request | BadDigest | 请求中设置的ContentMD5的值与服务端接收到文件的MD5值不符 | |
400 Bad Request | InvalidDigest | 客户端指定的对象内容的MD5值无效 | |
400 Bad Request | InlineDataTooLarge | 内联数据超过了允许的最大大小 | |
400 Bad Request | InvalidObjectName | 对象的名字不合法 | |
400 Bad Request | EntityTooLarge | 上传的文件太大 | |
400 Bad Request | EntityTooSmall | 建议上传的对象小于允许的最小对象大小 | |
400 Bad Request | InvalidPart | 合并分片的数量有问题,一个或者多个指定的分片未找到 | |
400 Bad Request | InvalidPartOrder | 段列表的顺序不是升序,段列表必须按段号升序排列 | |
400 Bad Request | MalformedACLError | 提供的XML格式不正确,或者未根据已发布的架构进行验证 | |
400 Bad Request | InvalidTag | 设置标签数量太多或者标签内容长度超出限制 | |
400 Bad Request | InvalidEncryptionAlgorithmError | 指定的加密请求无效。有效值为aes256 | |
400 Bad Request | InvalidLocationConstraint | 指定的位置约束无效 | |
400 Bad Request | InvalidPolicyDocument | 表单内容不符合策略文档中指定的条件 | |
400 Bad Request | InvalidSOAPRequest | SOAP请求正文无效 | |
400 Bad Request | InvalidStorageClass | 指定的存储类无效 | |
400 Bad Request | InvalidTargetBucketForLogging | 用于日志记录的目标bucket不存在、不归您所有或没有授权 | |
400 Bad Request | InvalidToken | 提供的令牌格式不正确或无效 | |
400 Bad Request | InvalidURI | 无法分析指定的URI | |
400 Bad Request | KeyTooLongError | Key太长 | |
400 Bad Request | MalformedPOSTRequest | POST请求的主体不符合格式规范 | |
400 Bad Request | MaxMessageLengthExceeded | 请求的长度过长 | |
400 Bad Request | MaxPostPreDataLengthExceededError | 上载文件之前的POST请求字段太大 | |
400 Bad Request | MetadataTooLarge | 元数据头超过了允许的最大元数据大小 | |
400 Bad Request | MissingRequestBodyError | 以请求的形式发送空XML文档 | |
400 Bad Request | MissingSecurityElement | SOAP 1.1请求缺少安全元素 | |
400 Bad Request | MissingSecurityHeader | 请求缺少必需的头 | |
400 Bad Request | NoLoggingStatusForKey | 不存在以日志状态呈现的key的子资源 | |
400 Bad Request | RequestIsNotMultiPartContent | bucket post必须是enclosure类型的multipart/form数据 | |
400 Bad Request | RequestTimeout | 请求超时。服务端还没有收到完整的请求 | |
400 Bad Request | RequestTorrentOfBucketError | 不允许访问bucket的Torrent文件的请求 | |
400 Bad Request | ServerSideEncryptionConfigurationNotFoundError | 找不到服务器端加密配置 | |
400 Bad Request | TokenRefreshRequired | 必须更新令牌 | |
400 Bad Request | TooManyBuckets | 试图创建的bucket超过了允许的数量 | |
400 Bad Request | UnexpectedContent | 该请求不支持内容 | |
400 Bad Request | UnresolvableGrantByEmailAddress | 提供的电子邮件地址与记录中的任何帐户都不匹配 | |
400 Bad Request | UserKeyMustBeSpecified | bucket post必须包含指定的字段名。如果已指定,请检查字段的顺序 | |
403 Forbidden | AccessDenied | 用户没有权限执行操作 | |
403 Forbidden | AllAccessDisabled | 已禁用对此S3资源的所有访问 | |
403 Forbidden | InvalidPayer | 已禁用对此对象的所有访问 | |
403 Forbidden | InvalidSecurity | 提供的安全凭据无效 | |
403 Forbidden | NotSignedUp | 帐户没有注册相关服务 | |
403 Forbidden | InvalidObjectState | 该操作对于对象的当前状态无效 | |
403 Forbidden | InvalidAccessKeyId | 访问密钥ID在我们的记录中不存在 | |
403 Forbidden | AccountProblem | 帐户有问题,导致操作无法成功完成 | |
403 Forbidden | CrossLocationLoggingProhibited | 不允许跨位置日志记录。一个地理位置的bucket无法将信息记录到另一个位置的bucket中 | |
403 Forbidden | RequestTimeTooSkewed | 请求的时间与服务器的时间相差太大 | |
403 Forbidden | SignatureDoesNotMatch | 系统计算的请求signature与提供的signature不匹配。检查Access Key和签名方法 | |
403 Forbidden | UserSuspended | 用户已经被挂起 | |
404 Not Found | NoSuchBucket | 用户请求的桶不存在 | |
404 Not Found | NoSuchUpload | UploadId不存在或者UploadId正在合并中 | |
404 Not Found | NoSuchLifecycleConfiguration | 桶中没有配置生命周期管理信息 | |
404 Not Found | NoSuchKey | 指定的对象不存在 | |
404 Not Found | NoSuchBucketPolicy | 指定的Bucket没有相应的策略 | |
404 Not Found | NoSuchVersion | 请求中指定的版本ID与现有版本不匹配 | |
405 Method Not Allowed | MethodNotAllowed | 指定的方法不允许操作在请求的资源上 | |
408 Request Timeout | RequestTimeout | 用户与Server之间的socket连接在超时时间内没有进行读写操作 | |
409 Conflict | BucketAlreadyExists | 当前请求的桶名已经被使用 | |
409 Conflict | BucketAlreadyOwnedByYou | 试图创建的bucket已经存在且请求者是所有者 | |
409 Conflict | BucketNotEmpty | 请求的桶不为空 | 删除桶前请先清空桶 |
409 Conflict | PositionNotEqualToLength | 请求参数中position的值与对象追加前的大小不一致 | |
409 Conflict | InvalidBucketState | 该请求对存储桶的当前状态无效 | |
409 Conflict | FileImmutable | 桶版本控制设置为enabled或suspended | |
409 Conflict | AccessPointAlreadyOwnedByYou | 您的帐户中已存在同名的访问点 | |
409 Conflict | ObjectNotAppendable | 无法追加指定的对象 | |
409 Conflict | OperationAborted | 当前正在对此资源执行冲突的条件操作 | |
409 Conflict | RestoreAlreadyInProgress | 对象还原进程已在进行中 | |
411 Length Required | MissingContentLength | 必须提供Content-Length HTTP头 | |
412 Precondition Failed | PreconditionFailed | 至少有一个指定的前提条件不成立 | |
416 Client Requested Range Not Satisfiable | InvalidRange | Range指定的范围不合法 | |
422 Unprocessable Entity | UnprocessableEntity | 请求格式正确,但是由于含有语义错误,无法响应 | |
500 Internal Server Error | InternalError | 系统遇到内部错误,请重试 | |
501 Not Implemented | NotImplemented | 提供的头包含未实现的功能 | |
503 Service Unavailable | ServiceUnavailable | 服务不可用 | |
503 Service Unavailable | SlowDown | 请降低请求频率 |