Status dan kode galat

Operasi REST API untuk Azure Storage 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. Informasi kesalahan tambahan ini dikembalikan dalam isi respons.

Isi respons kesalahan mengikuti format dasar yang diperlihatkan di sini. Elemen code menunjukkan string kode kesalahan, 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 Azure Storage di header respons.

Header respons	Deskripsi
x-ms-error-code	Nilai yang menunjukkan string kode kesalahan.

Respons kesalahan tertentu mungkin juga menyertakan informasi kesalahan tambahan untuk memberi pengembang informasi lebih lanjut. 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 yang mungkin berguna bagi Anda:

• Kode kesalahan REST API umum

• Kode kesalahan Blob Storage

• Kode kesalahan Queue Storage

• Kode kesalahan Table Storage

• Azure Files kode kesalahan

Respons kesalahan untuk Table Storage

Respons kesalahan untuk Table Storage mematuhi format kesalahan yang dijelaskan di bagian 19 spesifikasi OData. Informasi kesalahan tambahan mungkin disertakan, tetapi respons kesalahan selalu sesuai dengan OData spesifikasi.

Respons kesalahan batch mirip dengan respons kesalahan Table Storage standar. Untuk informasi selengkapnya, lihat Melakukan transaksi grup entitas.

Catatan

JSON adalah format payload yang direkomendasikan untuk Table Storage. Ini adalah satu-satunya format yang didukung untuk versi 2015-12-11 dan yang lebih baru.

Berikut ini menunjukkan 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"}}}  
  

Berikut ini menunjukkan 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
Layanan penyimpanan REST