Status dan kode galat

Operasi REST API untuk layanan penyimpanan Azure mengembalikan kode status HTTP standar, seperti yang ditentukan dalam Definisi Kode Status HTTP/1.1.

Operasi API juga dapat mengembalikan informasi kesalahan tambahan yang ditentukan oleh layanan penyimpanan. Informasi kesalahan tambahan ini dikembalikan dalam isi respons.

Isi respons kesalahan mengikuti format dasar yang ditunjukkan di sini. Elemen code menunjukkan string kode kesalahan layanan penyimpanan, sedangkan message elemen menunjukkan string pesan kesalahan.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>string-value</Code>  
  <Message>string-value</Message>  
</Error>  

Untuk versi 2017-07-29 dan yang lebih baru, operasi API yang gagal juga mengembalikan string kode kesalahan penyimpanan di header respons.

Header Respons Deskripsi
x-ms-error-code Nilai yang menunjukkan string kode kesalahan layanan penyimpanan.

Respons kesalahan tertentu juga dapat menyertakan informasi kesalahan tambahan untuk memberi pengembang informasi lebih lanjut tentang kesalahan tersebut. Misalnya, respons kesalahan berikut menunjukkan bahwa parameter kueri yang ditentukan pada URI permintaan tidak valid, dan memberikan informasi tambahan tentang nama dan nilai parameter yang tidak valid dan alasan kesalahan.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>InvalidQueryParameterValue</Code>  
  <Message>Value for one of the query parameters specified in the request URI is invalid.</Message>  
  <QueryParameterName>popreceipt</QueryParameterName>  
  <QueryParameterValue>33537277-6a52-4a2b-b4eb-0f905051827b</QueryParameterValue>  
  <Reason>invalid receipt format</Reason>  
</Error>  

Topik berikut ini menyediakan daftar kode kesalahan untuk layanan Blob, Antrean, Tabel, dan File:

Respons Kesalahan untuk Layanan Tabel

Respons kesalahan untuk layanan Tabel mencakup kode kesalahan layanan penyimpanan dan elemen pesan, seperti yang ditunjukkan di atas, tetapi juga sesuai dengan format kesalahan yang dijelaskan di bagian 19 spesifikasi OData. Informasi kesalahan tambahan dapat disertakan dalam respons selain kode dan pesan kesalahan layanan penyimpanan, tetapi respons kesalahan akan selalu mematuhi spesifikasi OData.

Respons kesalahan batch mirip dengan respons kesalahan layanan Tabel standar dan dijelaskan secara rinci dalam Melakukan Transaksi Grup Entitas.

Catatan

JSON adalah format payload yang direkomendasikan untuk operasi layanan Tabel, dan merupakan satu-satunya format yang didukung untuk versi 2015-12-11 dan yang lebih baru.

Isi Kesalahan Dasar dalam Format JSON (versi 2013-08-15 dan yang lebih baru)

{"odata.error":{"code":"ResourceNotFound","message":{"lang":"en-US","value":"The specified resource does not exist.\nRequestId:102a2b55-eb35-4254-9daf-854db78a47bd\nTime:2014-06-04T16:18:20.4307735Z"}}}  
  

Isi Kesalahan Dasar dalam Format Atom (versi sebelum 2015-12-11)

<?xml version="1.0" encoding="utf-8"?>  
<error xmlns="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata">  
  <code>ResourceNotFound</code>  
  <message xml:lang="en-US">The specified resource does not exist.  
RequestId:e288ba1e-f5dd-4014-9e09-f1263d223dec  
Time:2014-06-04T16:18:20.7088013Z</message>  
</error>  
  

Lihat juga

Pemecahan Masalah Operasi API
Enumerasi HttpStatusCode
Storage Services REST