Aracılığıyla paylaş

Durum ve hata kodları

  • Makale

Azure Depolama için REST API işlemleri, HTTP/1.1 Durum Kodu Tanımlarında tanımlandığı gibi standart HTTP durum kodları döndürür.

API işlemleri, hizmet tarafından tanımlanan ek hata bilgilerini de döndürebilir. Bu ek hata bilgileri yanıt gövdesinde döndürülür.

Hata yanıtının gövdesi burada gösterilen temel biçimi izler. code öğesi hata kodu dizesini, öğesi ise message hata iletisi dizesini gösterir.

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

2017-07-29 ve sonraki sürümler için başarısız API işlemleri de yanıt üst bilgisinde Azure Depolama hata kodu dizesini döndürür.

Yanıt üst bilgisi Description
x-ms-error-code Hata kodu dizesini gösteren değer.

Belirli bir hata yanıtı, geliştiriciye daha fazla bilgi sağlamak için ek hata bilgileri de içerebilir. Örneğin, aşağıdaki hata yanıtı istek URI'sinde belirtilen bir sorgu parametresinin geçersiz olduğunu gösterir ve geçersiz parametrenin adı ve değeri ile hatanın nedeni hakkında ek bilgi sağlar.

<?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>

2024-08-04 ve sonraki sürümlerde, Hesap SAS'sinin imzalı kaynak türü erişilen kaynakla eşleşmediğinde hata yanıtı ek hata bilgilerini içerir. Örneğin, aşağıdaki hata yanıtı işlemi gerçekleştirmek için 'o' imzalı kaynak türünün gerekli olduğunu gösterir.

<?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>

Aşağıdaki konular yararlı bulabileceğiniz hata kodlarının listelerini sağlar:

Tablo Depolama için hata yanıtları

Tablo Depolama için hata yanıtları , OData belirtiminin 19. bölümünde açıklanan hata biçimiyle uyumlu. Ek hata bilgileri eklenebilir, ancak hata yanıtı her zaman belirtim ile OData uyumlu olur.

Toplu hata yanıtları, standart Tablo Depolama hata yanıtlarına benzer. Daha fazla bilgi için bkz. Varlık grubu işlemleri gerçekleştirme.

Not

JSON, Tablo Depolama için önerilen yük biçimidir. Sürüm 2015-12-11 ve üzeri için desteklenen tek biçimdir.

Aşağıda temel hata gövdesi JSON biçiminde (sürüm 2013-08-15 ve üzeri) gösterilmektedir:

{"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"}}}

Aşağıda Atom biçimindeki temel hata gövdesi (2015-12-11 öncesi sürümler) gösterilmektedir:

<?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>

Ayrıca bkz.

API işlemleriyle ilgili sorunları giderme
HttpStatusCode numaralandırması
Depolama hizmetleri REST