Respons kesalahan REST

Jika permintaan REST mengakibatkan kesalahan, balasan HTTP memiliki:

• Dokumen kesalahan XML sebagai bodi respons

• Tipe Konten: aplikasi/xml

• 3xx, 4xx, atau 5xx kode status HTTP yang sesuai

Berikut ini adalah contoh Respons Kesalahan REST.

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>NoSuchKey</Code>
  <Message>The resource you requested does not exist</Message>
  <Resource>/mybucket/myfoto.jpg</Resource> 
  <RequestId>4442587FB7D0A2F9</RequestId>
</Error>

Untuk informasi selengkapnya tentang kesalahan Amazon S3, kunjungi ErrorCodeList.

Header respons

Berikut ini adalah header respons yang dikembalikan oleh semua operasi:

• x-amz-request-id: ID unik yang ditetapkan untuk setiap permintaan oleh sistem. Jika Anda memiliki masalah dengan Amazon S3, Amazon dapat menggunakannya untuk membantu memecahkan masalah.

• x-amz-id-2: Token khusus yang akan membantu kami memecahkan masalah.

Respons kesalahan

Saat permintaan Amazon S3 mengalami kesalahan, klien menerima tanggapan kesalahan. Format yang tepat dari respons kesalahan adalah spesifik API: Misalnya, respons kesalahan REST berbeda dari respons kesalahan SOAP. Namun, semua respons kesalahan memiliki elemen umum.

catatan

Dukungan SOAP melalui HTTP dihentikan, tetapi SOAP masih tersedia melalui HTTPS. Fitur Amazon S3 baru tidak mendukung SOAP. Alih-alih menggunakan SOAP, kami merekomendasikan agar Anda menggunakan REST API atauAWSSDK

Kode kesalahan

Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe. Banyak kode kesalahan yang umum di seluruh SOAP dan REST , tetapi beberapa di antaranya adalah API yang bersifat spesifik. Misalnya, NoSuchKey bersifat universal, tapi UnexpectedContent dapat terjadi sebagai tanggapan atas permintaan REST yang tidak valid. Dalam semua kasus, kode kesalahan SOAP membawa awalan seperti yang ditunjukkan dalam tabel kode kesalahan, sehingga NoSuchKey kesalahan sebenarnya dikembalikan dalam SOAP sebagai Client.NoSuchKey.

catatan

Dukungan SOAP melalui HTTP dihentikan, tetapi SOAP masih tersedia melalui HTTPS. Fitur Amazon S3 baru tidak mendukung SOAP. Alih-alih menggunakan SOAP, kami merekomendasikan agar Anda menggunakan REST API atauAWSSDK

Pesan kesalahan

Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.

Detail lebih lanjut

Banyak respons kesalahan berisi data terstruktur tambahan yang dimaksudkan untuk dibaca dan dipahami oleh pengembang yang mendiagnosis kesalahan pemrograman. Misalnya, jika Anda mengirim header Content-MD5 dengan permintaan REST PUT yang tidak cocok dengan ringkasan yang dihitung di server, Anda menerima BadDigest kesalahan. Respons kesalahan juga menyertakan sebagai elemen detail digest yang kami hitung, dan digest yang Anda beri tahukan kepada kami. Selama pengembangan, Anda dapat menggunakan informasi ini untuk mendiagnosis kesalahan. Dalam produksi, program yang berperilaku baik mungkin menyertakan informasi ini dalam log kesalahannya.