Udostępnij za pośrednictwem


Kody stanu i błędów

Operacje interfejsu API REST dla usługi Azure Storage zwracają standardowe kody stanu HTTP zdefiniowane w definicjach kodu stanu HTTP/1.1.

Operacje interfejsu API mogą również zwracać dodatkowe informacje o błędzie zdefiniowane przez usługę. 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, 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 lub nowszej operacje interfejsu API, które zakończyły się niepowodzeniem, zwracają również ciąg kodu błędu usługi Azure Storage w nagłówku odpowiedzi.

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

Konkretna odpowiedź na błąd może również zawierać dodatkowe informacje o błędzie, aby dostarczyć deweloperowi więcej informacji. Na przykład następująca odpowiedź o błędzie wskazuje, że parametr zapytania określony w identyfikatorze URI żądania jest 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>  

W przypadku wersji 2024-08-04 lub nowszej odpowiedź na błąd będzie zawierać dodatkowe informacje o błędzie, gdy podpisany typ zasobu sygnatury dostępu współdzielonego konta jest niezgodny z używanym zasobem. Na przykład następująca odpowiedź o błędzie wskazuje, że do wykonania operacji wymagany jest podpisany typ zasobu "o".

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

Poniższe tematy zawierają listy kodów błędów, które mogą okazać się przydatne:

Odpowiedzi na błędy usługi Table Storage

Odpowiedzi na błędy usługi Table Storage są zgodne z formatem błędu opisanym w sekcji 19 specyfikacji OData. Mogą zostać dołączone dodatkowe informacje o błędzie, ale odpowiedź na błąd jest zawsze zgodna ze specyfikacją OData .

Odpowiedzi na błędy wsadowe są podobne do standardowych odpowiedzi na błędy usługi Table Storage. Aby uzyskać więcej informacji, zobacz Wykonywanie transakcji grupy jednostek.

Uwaga

Format JSON jest zalecanym formatem ładunku dla usługi Table Storage. Jest to jedyny format obsługiwany w wersji 2015-12-11 lub nowszej.

Poniżej przedstawiono podstawową treść błędu w formacie JSON (wersja 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"}}}  
  

Poniżej przedstawiono podstawową 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 magazynu