OSS .NET SDK 包含兩類異常,一類是用戶端異常ClientException,另一類是伺服器端異常OSSException,它們均繼承自RuntimeException。
ClientException
ClientException指用戶端嘗試向OSS發送請求以及資料轉送時遇到的異常。例如,當發送請求時網路連接不可用,則會拋出ClientException。當上傳檔案時發生IO異常,也會拋出ClientException。
OSSException
OSSException指伺服器端異常,它來自於對伺服器錯誤資訊的解析。OSSException包含OSS返回的錯誤碼和錯誤資訊,便於定位問題,並做出適當的處理。
OSSException通常包含以下錯誤資訊:
參數 | 描述 |
Code | OSS返回的錯誤碼。 |
Message | OSS返回的詳細錯誤資訊。 |
RequestId | 用於唯一標識該請求的UUID。當您無法解決問題時,可以提供RequestId來請求OSS開發工程師的協助。 |
HostId | 用於標識訪問的OSS叢集,與請求時使用的Host一致。 |
OSS常見錯誤碼
錯誤碼 | 描述 |
AccessDenied | 拒絕訪問 |
BucketAlreadyExists | 儲存空間已經存在 |
BucketNotEmpty | 儲存空間非空 |
EntityTooLarge | 實體過大 |
EntityTooSmall | 實體過小 |
FileGroupTooLarge | 檔案組過大 |
FilePartNotExist | 檔案分區不存在 |
FilePartStale | 檔案分區過時 |
InvalidArgument | 參數格式錯誤 |
InvalidAccessKeyId | AccessKeyId不存在 |
InvalidBucketName | 無效的儲存空間名稱 |
InvalidDigest | 無效的摘要 |
InvalidObjectName | 無效的檔案名稱 |
InvalidPart | 無效的分區 |
InvalidPartOrder | 無效的分區順序 |
InvalidTargetBucketForLogging | Logging操作中有無效的目標儲存空間 |
InternalError | OSS內部錯誤 |
MalformedXML | XML格式非法 |
MethodNotAllowed | 不支援的方法 |
MissingArgument | 缺少參數 |
MissingContentLength | 缺少內容長度 |
NoSuchBucket | 儲存空間不存在 |
NoSuchKey | 檔案不存在 |
NoSuchUpload | 分區上傳ID不存在 |
NotImplemented | 無法處理的方法 |
PreconditionFailed | 預先處理錯誤 |
RequestTimeTooSkewed | 用戶端本地時間和OSS伺服器時間相差超過15分鐘 |
RequestTimeout | 請求逾時 |
SignatureDoesNotMatch | 簽名錯誤 |
TooManyBuckets | 使用者的儲存空間數目超過限制 |