OSS.NET SDK には、ClientException と OSSException の 2 種類の例外があります。 ともに RuntimeException のプロパティを共有します。

ClientException

ClientException 例外は、クライアントがリクエストを送信しようとしたとき、およびデータが OSS に送信されたときに発生します。 たとえば、リクエストが送信されると、利用できないネットワーク接続が原因で ClientException が発生することがあります。 I/O 例外のため、ファイルのアップロード中に ClientException が発生することがあります。

OSSException

OSSException は、サーバー例外を示します。 サーバーエラーメッセージが解析されることが原因で、例外が発生します。 OSSException には、OSS から返されたエラーコードと情報が含まれます。 OSSException は問題を見つけて処理するために使用されます。

次の表に、一般的な OSSException の情報を示します。

パラメーター 説明
Code OSS から返されたエラーコードを特定します。
Message OSS から返される詳細なエラー情報を特定します。
RequestId UUID を特定します。 UUID は固有のものであり、リクエストを識別するために使用されます。 問題が解決しない場合は、OSS 開発者に "RequestId" を送り、問い合わせます。
HostId OSS クラスターを識別します。 "HostId" の値が、リクエストで使用されているホスト (バケットにアクセスするためのエンドポイント) と一致していることを確認してください。

OSS エラーコード

エラーコード 説明
AccessDenied アクセスが拒否されました。
BucketAlreadyExists バケットが既に存在します。
BucketNotEmpty バケットが空ではありません。
EntityTooLarge エンティティサイズが上限を超えています。
EntityTooSmall エンティティサイズが下限を下回っています。
FileGroupTooLarge ファイルグループの合計サイズが上限を超えています。
FilePartNotExist そのようなオブジェクトパーツは存在しません。
FilePartStale オブジェクトパーツは有効期限切れです。
InvalidArgument パラメーターの形式が無効です。
InvalidAccessKeyId そのような AccessKeyId は存在しません。
InvalidBucketName バケット名が無効です。
InvalidDigest ダイジェストが無効です。
InvalidObjectName オブジェクト名が無効です。
InvalidPart パーツが無効です。
InvalidPartOrder パーツの順序が無効です。
InvalidTargetBucketForLogging ログファイルを格納するバケットが無効です。
InternalError 内部 OSS エラーです。
MalformedXML XML 形式が無効です。
MethodNotAllowed メソッドがサポートされていません。
MissingArgument パラメーターが設定されていません。
MissingContentLength コンテンツの長さが設定されていません。
NoSuchBucket そのようなバケットは存在しません。
NoSuchKey そのようなオブジェクトは存在しません。
NoSuchUpload そのようなアップロード ID は存在しません。
NotImplemented メソッドが実装されていません。
PreconditionFailed 事前条件エラーです。
RequestTimeTooSkewed OSSClient に設定されている現地時間が、OSS サーバーに設定されている時間から 15 分以上ずれています。
RequestTimeout リクエストがタイムアウトされました。
SignatureDoesNotMatch 署名が不一致です。
TooManyBuckets バケット数が上限を超えています。