OSS的錯誤響應
當用戶訪問OSS出現錯誤時,OSS會返回給用戶相應的錯誤碼和錯誤信息,便於用戶定位問題,並做出適當的處理。
OSS的錯誤響應格式
當用戶訪問OSS出錯時,OSS會返回給用戶一個合適的3xx,4xx或者5xx的HTTP狀態碼;以及一個application/xml格式的消息體。
錯誤響應的消息體例子:
AccessDeniedQuery-string authentication requires the Signature,Expires and OSSAccessKeyId parameters1D842BC5425544BBstorage.aliyun.com
◆ 所有錯誤的消息體中都包括以下幾個元素:
● Code:OSS返回給用戶的錯誤碼。
● Message:OSS給出的詳細錯誤信息。
● RequestId:用於唯一標識該次請求的UUID;當你無法解決問題時,可以憑這個RequestId來請求OSS開發工程師的幫助。
● HostId:用於標識訪問的OSS集群(目前統一為storage.aliyun.com)。
其他特殊的錯誤信息元素請參照每個請求的具體介紹。
OSS的錯誤碼
OSS的錯誤碼列表如下:
錯誤碼
描述
HTTP狀態碼
AccessDenied
拒絕訪問
403
BucketAlreadyExists
Bucket已經存在
409
BucketNotEmpty
Bucket不為空
409
FileGroupTooLarge
文件組過大
400
FilePartStale
文件Part過時
400
InvalidArgument
參數格式錯誤
400
InvalidAccessKeyId
Access ID不存在
403
InvalidBucketName
無效的Bucket名字
400
InvalidObjectName