Kody stanu i błędów

Operacje interfejsu API REST dla usług Azure Storage zwracają standardowe kody stanu HTTP zgodnie z definicjami kodu stanu HTTP/1.1.

Operacje interfejsu API mogą również zwracać dodatkowe informacje o błędach zdefiniowane przez usługę magazynu. Te dodatkowe informacje o błędzie są zwracane w treści odpowiedzi.

Treść odpowiedzi o błędzie jest zgodna z podstawowym formatem pokazanym tutaj. Element code wskazuje ciąg kodu błędu usługi magazynu, natomiast message element wskazuje ciąg komunikatu o błędzie.

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

W przypadku wersji 2017-07-29 i nowszych operacje interfejsu API zakończyły się niepowodzeniem, zwracają również ciąg kodu błędu magazynu w nagłówku odpowiedzi.

Nagłówek odpowiedzi	Opis
x-ms-error-code	Wartość wskazująca ciąg kodu błędu usługi magazynu.

Dana odpowiedź o błędzie może również zawierać dodatkowe informacje o błędzie, aby dostarczyć deweloperowi więcej informacji o błędzie. Na przykład następująca odpowiedź o błędzie wskazuje, że parametr zapytania określony na identyfikatorze URI żądania był nieprawidłowy i zawiera dodatkowe informacje o nazwie i wartości nieprawidłowego parametru oraz przyczynie błędu.

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

Poniższe tematy zawierają listy kodów błędów dla usług blob, Queue, Table i File:

• Typowe kody błędów interfejsu API REST

• Kody błędów usługi Blob Service

• Kody błędów usługi kolejki

• Kody błędów usługi Table Service

• Kody błędów usługi plików

Odpowiedzi na błędy dla usługi Table Service

Odpowiedzi na błędy usługi Table Service obejmują kod błędu usług magazynu i elementy komunikatów, jak pokazano powyżej, ale są również zgodne z formatem błędu opisanym w sekcji 19 specyfikacji OData. Dodatkowe informacje o błędzie mogą być zawarte w odpowiedzi oprócz kodu błędu i komunikatu usług magazynu, ale odpowiedź o błędzie zawsze będzie zgodna ze specyfikacją OData.

Odpowiedzi na błędy wsadowe są podobne do standardowych odpowiedzi na błędy usługi Table Service i opisano je szczegółowo w temacie Wykonywanie transakcji grupy jednostek.

Uwaga

Format JSON jest zalecanym formatem ładunku dla operacji usługi Table Service i jest jedynym formatem obsługiwanym w wersjach 2015-12-11 i nowszych.

Podstawowa treść błędu w formacie JSON (wersje 2013-08-15 i nowsze)

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

Podstawowa treść błędu w formacie Atom (wersje wcześniejsze niż 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>  
  

Zobacz też

Rozwiązywanie problemów z operacjami interfejsu API
HttpStatusCode, wyliczenie
rest usług Storage