Aracılığıyla paylaş

Durum ve hata kodları

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

API işlemleri, hizmetin tanımladığı ayrıntılı hata bilgilerini de döndürebilir. Bu 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. Öğe code hata kodu dizesini gösterirken, öğe hata iletisi dizesini message gösterir.

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

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

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

Belirli bir hata yanıtı, geliştiriciye daha fazla bilgi sağlamak için ayrıntılı hata bilgileri de içerebilir. Örneğin, aşağıdaki hata yanıtı istek URI'sinde belirtilen geçersiz bir sorgu parametresini 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>

Sürüm 2024-08-04 ve sonraki sürümler için hata yanıtı, Hesap SAS'ın imzalı kaynak türü erişilen kaynakla eşleşmediğinde ayrıntılı hata bilgilerini içerir. Örneğin, aşağıdaki hata yanıtı, işlemi gerçekleştirmek için imzalı kaynak türü 'o' gerektiğini 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 makale listesi, yararlı bulabileceğiniz hata kodları koleksiyonlarını sağlar:

API Hata Yanıtını Kopyala

Kopyalama API'leri için hata yanıtı, daha önce belirtilenle aynı biçimi izler. Hata yanıtının gövdesi, code hata kodu dizesinin öğesini ve hata iletisi dizesini message gösteren öğeyi içerir.

2024-02-04 ve sonraki sürümler için, kaynaktan gelen hatanın bu bilgileri döndürmesi koşuluyla, kopyalama kaynağıyla ilgili bir sorun nedeniyle Kopyalama işlemi başarısız olursa hata yanıtı ayrıntılı bir hata içerebilir. Yanıt, kopyalama kaynağı işleminin durum kodunu belirtmeyi, CopySourceErrorCode kopyalama kaynağının hata yanıtında döndürüleni x-ms-error-code belirtmeyi ve CopySourceErrorMessage karşılık gelen hata iletisini belirtmeyi içerebilirCopySourceStatusCode.

<?xml version="1.0" encoding="utf-8"?>  
<Error>  
  <Code>CannotVerifyCopySource</Code>  
  <Message> The specified blob doesn’t exist.
      RequestId:de1e2279-b01e-0000-5f26-5c4741000000
      Time:2023-03-21T18:52:10.1018932Z</Message>
  <CopySourceStatusCode> 404 </CopySourceStatusCode>
  <CopySourceErrorCode> BlobNotFound </CopySourceErrorCode>
  <CopySourceErrorMessage> The specified blob doesn’t exist </CopySourceErrorMessage> 
</Error>

2024-02-04 ve sonraki sürümler için Azure Depolama, kopyalama kaynağı hatasında alınmışsa yanıt üst bilgisinde kopyalama kaynağı durum kodunu ve hata kodunu döndürür.

Yanıt üst bilgisi Açıklama
x-ms-copy-source-status-code Kopyalama kaynağı hatasının durum kodunu gösteren bir değer.
x-ms-copy-source-error-code Kopyalama kaynağı hatasından döndürülen hata kodu dizesini gösteren bir değer.

Aşağıdaki Kopyalama API'leri şu ayrıntıları döndürür:

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çimine uygundur. Ayrıntılı hata bilgileri dahil edilebilir, ancak hata yanıtı her zaman spesifikasyona OData uygundur.

Toplu iş 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.

Uyarı

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

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

{"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ğıdaki örnek, Atom biçimindeki temel hata gövdesini gösterir (2015-12-11 ve önceki sürümler):

<?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 bakınız

API işlemlerinde sorun giderme
HttpStatusCode numaralandırması
Depolama hizmetleri REST

  • Last updated on