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 ditunjukkan 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>
Untuk versi 2024-08-04 dan yang lebih baru, respons kesalahan akan menyertakan informasi kesalahan tambahan ketika jenis sumber daya yang ditandatangani SAS Akun tidak cocok dengan sumber daya yang diakses. Misalnya, respons kesalahan berikut menunjukkan jenis sumber daya 'o' yang ditandatangani diperlukan untuk melakukan operasi.
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>AuthorizationResourceTypeMismatch</Code>
<Message>This request is not authorized to perform this operation using this resource type. RequestId:42a48a49-201e-0092-3770-a7ea70000000 Time:2024-05-16T09:04:16.3226200Z</Message>
<ExtendedErrorDetail>SignedResourceTypes 'o' is required to perform this operation.</ExtendedErrorDetail>
</Error>
Topik berikut ini menyediakan daftar kode kesalahan yang mungkin berguna bagi Anda:
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