Stavové kódy a kódy chyb
Operace rozhraní REST API pro Azure Storage vrací standardní stavové kódy HTTP, jak jsou definovány v definicích stavových kódů HTTP/1.1.
Operace rozhraní API můžou také vracet další informace o chybách definované službou. Tyto další informace o chybě se vrátí v textu odpovědi.
Text odpovědi na chybu se řídí základním formátem, který je zde uvedený. Element code
označuje řetězec kódu chyby, zatímco message
element označuje řetězec chybové zprávy.
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>string-value</Code>
<Message>string-value</Message>
</Error>
Pro verzi 2017-07-29 a novější vrací neúspěšné operace rozhraní API také řetězec kódu chyby Azure Storage v hlavičce odpovědi.
Hlavička odpovědi | Description |
---|---|
x-ms-error-code |
Hodnota označující řetězec kódu chyby. |
Konkrétní odpověď na chybu může také obsahovat další informace o chybách, které vývojáři poskytnou další informace. Například následující chybová odpověď označuje, že parametr dotazu zadaný v identifikátoru URI požadavku je neplatný, a poskytuje další informace o názvu a hodnotě neplatného parametru a důvodu chyby.
<?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>
Následující témata obsahují seznam kódů chyb, které by pro vás mohly být užitečné:
Odpovědi na chyby pro Table Storage
Odpovědi na chyby služby Table Storage odpovídají formátu chyby popsanému v části 19 specifikace OData. Mohou být zahrnuty další informace o chybě, ale odpověď na chybu vždy vyhovuje specifikaci OData
.
Dávkové chybové odpovědi se podobají standardním odpovědím na chyby služby Table Storage. Další informace najdete v tématu Provádění transakcí skupin entit.
Poznámka
Json je doporučený formát datové části pro Table Storage. Je to jediný podporovaný formát pro verzi 2015-12-11 a novější.
Následuje základní text chyby ve formátu JSON (verze 2013-08-15 a novější):
{"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"}}}
Následuje základní text chyby ve formátu Atom (verze starší než 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>
Viz také
Řešení potíží s operacemi rozhraní API
Výčet HttpStatusCode
Rest služby úložiště