Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Praktik terbaik kesalahan Amazon S3
Banyak respons kesalahan berisi data terstruktur tambahan yang dimaksudkan untuk dibaca dan dipahami oleh pengembang yang mendiagnosis kesalahan pemrograman. Misalnya, jika Anda mengirim Content-MD5 header dengan permintaan REST PUT yang tidak cocok dengan ringkasan yang dihitung di server, Anda menerima BadDigest kesalahan. Respons kesalahan juga mencakup sebagai elemen detail ringkasan yang dihitung, dan intisari yang Anda berikan untuk diharapkan. Selama pengembangan, Anda dapat menggunakan informasi ini untuk mendiagnosis kesalahan. Dalam produksi, program yang berperilaku baik mungkin menyertakan informasi ini dalam log kesalahannya.
Saat merancang aplikasi untuk digunakan dengan Amazon S3, penting untuk menangani kesalahan Amazon S3 sebagaimana mestinya. Bagian ini menjelaskan masalah yang perlu dipertimbangkan saat merancang aplikasi Anda.
Coba lagi InternalErrors
Kesalahan internal adalah kesalahan yang terjadi dalam lingkungan Amazon S3.
Permintaan yang menerima InternalError tanggapan mungkin belum diproses. Misalnya, jika permintaan PUT kembali InternalError, GET berikutnya mungkin mengambil nilai lama atau nilai yang diperbarui.
Jika Amazon S3 mengembalikan InternalError respons, coba lagi permintaan tersebut.
Setel aplikasi untuk SlowDown kesalahan berulang
Seperti halnya sistem terdistribusi lainnya, S3 memiliki mekanisme perlindungan yang mendeteksi konsumsi sumber daya yang disengaja atau tidak disengaja dan bereaksi sesuai dengan itu. SlowDown kesalahan dapat terjadi ketika tingkat permintaan tinggi memicu salah satu mekanisme ini. Mengurangi tingkat permintaan Anda akan mengurangi atau menghilangkan kesalahan tipe ini. Secara umum, sebagian besar pengguna tidak akan mengalami kesalahan ini secara teratur; Namun, jika Anda ingin informasi lebih lanjut atau mengalami SlowDown kesalahan tinggi atau tidak terduga, silakan kirim ke forum pengembang Amazon S3 kami
Isolasi kesalahan
catatan
SOAP API untuk Amazon S3 tidak tersedia untuk pelanggan baru, dan mendekati End of Life (EOL) pada 31 Agustus 2025. Kami menyarankan Anda menggunakan REST API atau AWS SDK.
Amazon S3 menyediakan serangkaian kode kesalahan yang digunakan oleh API SOAP dan REST. SOAP API mengembalikan kode kesalahan Amazon S3 standar. API REST dirancang untuk terlihat seperti server HTTP standar dan berinteraksi dengan klien HTTP yang ada (mis. peramban, pustaka klien HTTP, proksi, cache, dan lain-lain). Untuk memastikan klien HTTP menangani kesalahan dengan benar, Amazon S3 memetakan setiap kesalahan Amazon S3 ke kode status HTTP.
Kode status HTTP kurang ekspresif dibandingkan kode kesalahan Amazon S3 dan berisi lebih sedikit informasi tentang kesalahan tersebut. Misalnya, kesalahan NoSuchKey dan NoSuchBucket Amazon S3 keduanya memetakan ke kode status HTTP 404 Not
Found.
Meskipun kode status HTTP memuat lebih sedikit informasi tentang kesalahan, klien yang memahami HTTP, tetapi bukan API Amazon S3, biasanya akan menangani kesalahan dengan benar.
Oleh karena itu, saat menangani kesalahan atau melaporkan kesalahan Amazon S3 kepada pengguna akhir, gunakan kode kesalahan Amazon S3 alih-alih kode status HTTP karena kode ini berisi sebagian besar informasi tentang kesalahan tersebut. Selain itu, saat men-debug aplikasi Anda, Anda juga harus melihat elemen <Details> yang dapat dibaca manusia dari respons kesalahan XML.