Dela via

Status och felkoder

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

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

Brödtexten i felsvaret följer det grundläggande formatet 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-felkodssträngen i ett svarshuvud.

Svarsrubrik Beskrivning
x-ms-error-code Ett värde som anger felkodssträngen.

Ett visst felsvar kan också innehålla detaljerad felinformation för att ge utvecklaren mer information. Följande felsvar anger till exempel en ogiltig frågeparameter som angetts på begärande-URI:n och ger 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 detaljerad felinformation när konto-SAS:s signerade resurstyp inte matchar den resurs 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 lista över artiklar innehåller samlingar med felkoder som kan vara användbara:

Svar på kopierings-API-fel

Felsvaret för kopierings-API:erna följer samma format som tidigare nämnts. Brödtexten i felsvaret innehåller elementet code för felkodssträngen och elementet message som anger felmeddelandesträngen.

För versionerna 2024-02-04 och senare kan felsvaret innehålla ett detaljerat fel om kopieringsåtgärden misslyckas på grund av ett problem med kopieringskällan, förutsatt att felet från källan returnerar den här informationen. Svaret kan omfatta CopySourceStatusCode att ange statuskoden för kopieringskällans åtgärd, CopySourceErrorCode ange det x-ms-error-code returnerade i kopieringskällans felsvar och CopySourceErrorMessage ange motsvarande felmeddelande.

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

För versionerna 2024-02-04 och senare returnerar Azure Storage statuskoden för kopieringskällan och felkoden i svarshuvudet, om de tas emot i kopieringskällans fel.

Svarsrubrik Beskrivning
x-ms-copy-source-status-code Ett värde som anger statuskoden för felet i kopieringskällan.
x-ms-copy-source-error-code Ett värde som anger felkodssträngen som returnerades från kopieringskällans fel.

Följande kopierings-API:er returnerar den här informationen –

Felsvar för Table Storage

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

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

Anmärkning

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.

I följande exempel visas 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"}}}

I följande exempel visas den grundläggande feltexten i Atom-format (version 2015-12-11 och tidigare):

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