Állapot- és hibakódok
Az Azure Storage REST API-műveletei a HTTP/1.1 állapotkód-definíciókban meghatározott szabványos HTTP-állapotkódokat ad vissza.
Az API-műveletek a szolgáltatás által meghatározott további hibainformációkat is visszaadhatnak. Ez a további hibainformáció a válasz törzsében jelenik meg.
A hibaválasz törzse az itt látható alapvető formátumot követi. Az code
elem a hibakód-sztringet jelöli, míg az message
elem a hibaüzenet sztringet.
<?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ében a sikertelen API-műveletek az Azure Storage hibakód-sztringet is visszaadják a válaszfejlécben.
Válaszfejléc | Description |
---|---|
x-ms-error-code |
A hibakód sztringet jelző érték. |
Egy adott hibaválasz további hibainformációkat is tartalmazhat, hogy további információkat nyújtson a fejlesztőnek. A következő hibaválasz például azt jelzi, hogy a kérelem URI-ján megadott lekérdezési paraméter érvénytelen, és további információt 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>
Az alábbi témakörökben felsoroljuk azokat a hibakódokat, amelyek hasznosak lehetnek:
Hibaválaszok a Table Storage-hoz
A Table Storage hibaválaszai megfelelnek az OData-specifikáció 19. szakaszában leírt hibaformátumnak. További hibainformációk is megjelenhetnek, de a hibaválasz mindig megfelel a OData
specifikációnak.
A kötegelt hibaválaszok hasonlóak a table storage-hibaválaszokhoz. További információ: Entitáscsoport-tranzakciók végrehajtása.
Megjegyzés
A JSON a Table Storage ajánlott hasznosadat-formátuma. Ez az egyetlen támogatott formátum a 2015-12-11-es és újabb verziókban.
Az alábbiakban az alapszintű hibatörzs látható JSON formátumban (2013-08-15-es é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ábbiakban az Atom formátumú alapszintű hibatörzs látható (a 2015-12-11 előtti 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
Storage-szolgáltatások REST