Status- och felkoder

REST API-åtgärder för Azure Storage returnerar standard-HTTP-statuskoder enligt definitionen i HTTP/1.1-statuskoddefinitionerna.

API-åtgärder kan också returnera ytterligare felinformation som definieras av tjänsten. Den här ytterligare felinformationen returneras i svarstexten.

Texten i felsvaret följer det grundläggande format som visas här. Elementet code anger felkodsträngen, medan elementet message anger felmeddelandesträngen.

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

För version 2017-07-29 och senare returnerar misslyckade API-åtgärder också Felkodssträngen för Azure Storage i ett svarshuvud.

Svarsrubrik	Description
x-ms-error-code	Ett värde som anger felkodsträngen.

Ett visst felsvar kan också innehålla ytterligare felinformation för att ge utvecklaren mer information. Följande felsvar anger till exempel att en frågeparameter som anges på begärande-URI:n är ogiltig och innehåller ytterligare information om den ogiltiga parameterns namn och värde samt orsaken till felet.

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

Följande avsnitt innehåller listor över felkoder som kan vara användbara:

• Vanliga REST API-felkoder

• Felkoder för Blob Storage

• Kölagringsfelkoder

• Felkoder för Table Storage

• Azure Files felkoder

Felsvar för Table Storage

Felsvar för Table Storage överensstämmer med felformatet som beskrivs i avsnitt 19 i OData-specifikationen. Ytterligare felinformation kan inkluderas, men felsvaret uppfyller alltid specifikationen OData .

Batch-felsvar liknar standardsvar för Table Storage-fel. Mer information finns i Utföra entitetsgrupptransaktioner.

Anteckning

JSON är det rekommenderade nyttolastformatet för Table Storage. Det är det enda format som stöds för version 2015-12-11 och senare.

Följande visar den grundläggande feltexten i JSON-format (version 2013-08-15 och senare):

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

Följande visar den grundläggande feltexten i Atom-format (versioner före 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>  
  

Se även

Felsöka API-åtgärder
HttpStatusCode-uppräkning
REST för lagringstjänster