Megosztás a következőn keresztül:

Állapot- és hibakódok

Az Azure Storage REST API-műveletei szabványos HTTP-állapotkódokat adnak vissza a HTTP/1.1 állapotkód-definíciókban meghatározottak szerint.

Az API-műveletek a szolgáltatás által meghatározott részletes hibainformációkat is visszaadhatnak. Ezt a hibainformációt a válasz törzse adja vissza.

A hibaválasz törzse az itt látható alapformátumot követi. Az code elem a hibakód karakterláncot, míg az message elem a hibaüzenet karakterláncát jelzi.

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

A 2017-07-29-es és újabb verziók esetén a sikertelen API-műveletek az Azure Storage hibakód-sztringjét is visszaadják egy válaszfejlécben.

Válaszfejléc Leírás
x-ms-error-code A hibakód karakterláncát jelző érték.

Egy adott hibaválasz részletes hibainformációkat is tartalmazhat, hogy a fejlesztő további információkkal szolgáljon. Az alábbi hibaválasz például a kérelem URI-jában megadott érvénytelen lekérdezési paramétert jelez, és további információkat nyújt az érvénytelen paraméter nevéről és értékéről, valamint a hiba okáról.

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

A 2024-08-04-es és újabb verziók esetében a hibaválasz részletes hibainformációkat tartalmaz, ha a fiók SAS aláírt erőforrástípusa nem egyezik meg az elért erőforrással. Az alábbi hibaválasz például azt jelzi, hogy a művelet végrehajtásához az aláírt "o" erőforrástípus szükséges.

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

Az alábbi cikkek listája hasznos hibakódok gyűjteményét tartalmazza:

API-hibaválasz másolása

A másolási API-k hibaválasza a korábban említett formátumot követi. A hibaválasz törzse tartalmazza code a hibakód-sztring elemét és a message hibaüzenet-sztringet jelző elemet.

A 2024-02-04-es és újabb verziók esetén a hibaválasz részletes hibát tartalmazhat, ha a másolási művelet a másolási forrással kapcsolatos probléma miatt meghiúsul, feltéve, hogy a forrás hibája visszaadja ezt az információt. A válasz tartalmazhatja CopySourceStatusCode a másolási forrás művelet állapotkódjának megadását, CopySourceErrorCode a másolási forrás hibaválaszában visszaadott érték x-ms-error-code megadását és CopySourceErrorMessage a megfelelő hibaüzenet jelzését.

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

A 2024-02-04-es és újabb verziók esetén az Azure Storage visszaadja a forrás állapotkódját és a hibakódot a válasz fejlécében, ha azok a másolási forrás hibája esetén érkeznek.

Válaszfejléc Leírás
x-ms-copy-source-status-code A másolási forrás hibájának állapotkódját jelző érték.
x-ms-copy-source-error-code A másolási forrás hibája miatt visszaadott hibakód-sztringet jelző érték.

A következő másolási API-k adják vissza ezeket a részleteket:

Hibaválaszok a Table Storage szolgáltatáshoz

A Table Storage hibaválaszai megfelelnek az OData-specifikáció 19. szakaszában leírt hibaformátumnak. Részletes hibainformációk is szerepelhetnek, de a hibaválasz mindig megfelel a OData specifikációnak.

A kötegelt hibaválaszok hasonlóak a Table Storage szabványos hibaválaszaihoz. További információ: Entitáscsoport-tranzakciók végrehajtása.

Megjegyzés:

A JSON a Table Storage ajánlott hasznos adatformátuma. Ez az egyetlen formátum, amelyet a 2015-12-11-es és újabb verziók támogatnak.

Az alábbi példa az alapszintű hibatörzset mutatja be JSON formátumban (2013-08-15-ös és újabb verziók):

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

Az alábbi minta az alapvető hibatörzset mutatja be Atom formátumban (2015-12-11-es és korábbi verziók):

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

Lásd még

API-műveletek hibaelhárítása
HttpStatusCode enumerálás
Tárolási szolgáltatások REST