全部产品
Search
文档中心

Object Storage Service:Penanganan exception (C# SDK V1)

更新时间:Nov 29, 2025

Pengecualian OSS SDK untuk C# dikategorikan menjadi dua jenis: OSSException dan ClientException. Keduanya merupakan subkelas dari RuntimeException.

ClientException

ClientException menunjukkan pengecualian yang terjadi saat klien mengirimkan permintaan atau mentransmisikan data ke OSS. Sebagai contoh, ClientException dikembalikan ketika klien gagal mengirimkan permintaan karena pemutusan jaringan atau terjadi pengecualian I/O selama pengunggahan objek.

OSSException

OSSException menunjukkan pengecualian server yang muncul dari penguraian pesan kesalahan server. ServiceException mencakup kode kesalahan dan pesan yang dikembalikan oleh OSS sehingga Anda dapat mengidentifikasi dan menyelesaikan kesalahan tersebut.

OSSException melibatkan informasi kesalahan berikut:

Parameter

Deskripsi

Code

Kode kesalahan yang dikembalikan oleh OSS.

Message

Pesan kesalahan rinci yang dikembalikan oleh OSS.

RequestId

UUID yang digunakan untuk secara unik mengidentifikasi permintaan. Jika masalah tetap ada, Anda dapat memberikan ID permintaan kepada insinyur pengembangan OSS untuk mendapatkan bantuan.

HostId

ID host di kluster OSS yang diakses, yang sama dengan ID host yang ditentukan dalam permintaan.

Kode kesalahan OSS umum

Kode kesalahan

Deskripsi

AccessDenied

Akses ditolak.

BucketAlreadyExists

Bucket sudah ada.

BucketNotEmpty

Bucket tidak kosong.

EntityTooLarge

Entitas terlalu besar.

EntityTooSmall

Entitas terlalu kecil.

FileGroupTooLarge

Grup file terlalu besar.

FilePartNotExist

Bagian file tidak ada.

FilePartStale

Bagian file telah kedaluwarsa.

InvalidArgument

Format parameter tidak valid.

InvalidAccessKeyId

ID AccessKey tidak ada.

InvalidBucketName

Nama bucket tidak valid.

InvalidDigest

Digest tidak valid.

InvalidObjectName

Nama objek tidak valid.

InvalidPart

Bagian tidak valid.

InvalidPartOrder

Urutan bagian tidak valid.

InvalidTargetBucketForLogging

Bucket untuk logging tidak valid.

InternalError

Terdapat kesalahan internal OSS.

MalformedXML

Format XML tidak valid.

MethodNotAllowed

Metode tidak didukung.

MissingArgument

Beberapa parameter yang diperlukan tidak ditentukan.

MissingContentLength

Panjang konten tidak ada.

NoSuchBucket

Bucket OSS yang ditentukan tidak ada.

NoSuchKey

Objek tidak ada.

NoSuchUpload

ID unggah multi-bagian yang ditentukan tidak ada.

NotImplemented

Metode tidak dapat diimplementasikan.

PreconditionFailed

Kesalahan terjadi selama pra-pemrosesan.

RequestTimeTooSkewed

Deviasi waktu antara klien OSS dan server OSS melebihi 15 menit.

RequestTimeout

Permintaan habis waktu.

SignatureDoesNotMatch

Kesalahan tanda tangan terjadi.

TooManyBuckets

Jumlah bucket melebihi batas.