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 | バケット数が上限を超えています。 |