Sdílet prostřednictvím

Stavové kódy a kódy chyb

  • Článek

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, které služba definuje. Tyto další informace o chybě se vrátí v textu odpovědi.

Text chybové odpovědi 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, která označuje řetězec kódu chyby.

Konkrétní chybová odpověď může také obsahovat další informace o chybě, aby vývojáři poskytli další informace. Například následující chybová odpověď indikuje, ž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>

Ve verzi 2024-08-04 a novější bude odpověď na chybu obsahovat další informace o chybě, pokud se typ podepsaného sas účtu neshoduje s prostředkem, ke které přistupujete. Například následující chybová odpověď značí, že k provedení operace se vyžaduje podepsaný typ prostředku "o".

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

Následující témata obsahují seznamy kódů chyb, které by pro vás mohly být užitečné:

Chybové odpovědi pro službu Table Storage

Odpovědi na chyby pro službu Table Storage odpovídají formátu chyby popsanému v oddílu 19 specifikace OData. Mohou být zahrnuty další informace o chybách, ale chybová odpověď vždy odpovídá 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ý formát podporovaný 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 před 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
HttpStatusCode – výčet
Rest služby Storage