全部产品
Search
文档中心

Object Storage Service:Penanganan Pengecualian (PHP SDK V1)

更新时间:Nov 30, 2025

OSS PHP SDK melemparkan OssException untuk berbagai kesalahan, seperti parameter tidak valid atau file yang tidak ditemukan. Anda dapat menggunakan metode getMessage untuk mengambil pesan kesalahan tersebut.

Untuk informasi selengkapnya mengenai OssException, lihat GitHub.

Contoh Penanganan Pengecualian

Kode berikut menunjukkan cara menangani pengecualian yang dilemparkan saat mencoba membuat bucket yang sudah ada, sekaligus mencetak pesan kesalahannya.

    try {
        $ossClient->createBucket($bucket);
    } catch (OssException $e) {
        print("Pengecualian:" . $e->getMessage() . "\n");
    }
            

Anda juga dapat memperoleh informasi berikut:

Parameter

Deskripsi

HTTPStatus

Kode status HTTP. Gunakan metode getHTTPStatus untuk mendapatkan nilai ini.

ErrorCode

Kode kesalahan yang dikembalikan OSS. Gunakan metode getErrorCode untuk mendapatkan nilai ini.

ErrorMessage

Pesan kesalahan yang dikembalikan OSS. Gunakan metode getErrorMessage untuk mendapatkan nilai ini.

RequestId

Identifier unik universal (UUID) yang secara unik mengidentifikasi permintaan. Jika Anda tidak dapat menyelesaikan suatu masalah, berikan RequestId ini kepada developer OSS untuk bantuan. Gunakan metode getRequestId untuk mendapatkan nilai ini.

Details

Deskripsi detail dari pesan kesalahan yang dikembalikan OSS. Gunakan metode getDetails untuk mendapatkan nilai ini.

Kode kesalahan OSS umum

Kode kesalahan

Deskripsi

Kode status HTTP

AccessDenied

Akses ditolak.

403

BucketAlreadyExists

Bucket sudah ada.

409

BucketNotEmpty

Bucket tidak kosong.

409

EntityTooLarge

Entitas terlalu besar.

400

EntityTooSmall

Entitas terlalu kecil.

400

FileGroupTooLarge

Grup file terlalu besar.

400

FilePartNotExist

Bagian file tidak ada.

400

FilePartStale

Bagian file sudah kadaluarsa.

400

InvalidArgument

Format parameter tidak valid.

400

InvalidAccessKeyId

ID AccessKey tidak ada.

403

InvalidBucketName

Nama bucket tidak valid.

400

InvalidDigest

Digest tidak valid.

400

InvalidObjectName

Nama objek tidak valid.

400

InvalidPart

Bagian tidak valid.

400

InvalidPartOrder

Urutan bagian tidak valid.

400

InvalidTargetBucketForLogging

Bucket target untuk operasi logging tidak valid.

400

InternalError

Terjadi kesalahan internal di OSS.

500

MalformedXML

Format XML tidak valid.

400

MethodNotAllowed

Metode tidak didukung.

405

MissingArgument

Parameter hilang.

411

MissingContentLength

Panjang konten hilang.

411

NoSuchBucket

Bucket tidak ada.

404

NoSuchKey

Objek tidak ada.

404

NoSuchUpload

ID unggah multi-bagian tidak ada.

404

NotImplemented

Metode tidak dapat diproses.

501

PreconditionFailed

Terjadi kesalahan pra-pemrosesan.

412

RequestTimeTooSkewed

Selisih antara waktu client dan waktu server OSS lebih dari 15 menit.

403

RequestTimeout

Permintaan habis waktu.

400

SignatureDoesNotMatch

Signature tidak sesuai.

403

InvalidEncryptionAlgorithmError

Algoritma enkripsi yang ditentukan salah.

400