Dela via

Status- och felkoder

  • Artikel

REST API-åtgärder för Azure Storage returnerar HTTP-standardstatuskoder enligt definitionen i definitionerna för HTTP/1.1-statuskod.

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

Brödtexten 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 även Azure Storage-felkodsträngen 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 indikerar till exempel att en frågeparameter som angetts 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ör version 2024-08-04 och senare innehåller felsvaret ytterligare felinformation när konto-SAS:s signerade resurstyp inte matchar resursen som används. Följande felsvar anger till exempel att den signerade resurstypen "o" krävs för att utföra åtgärden.

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

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

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