全部產品
Search
文件中心

Object Storage Service:.NET異常處理

更新時間:Feb 28, 2024

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

使用者的儲存空間數目超過限制