Sdílet prostřednictvím

Stavové a chybové kódy

Operace rozhraní REST API pro Azure Storage vracejí standardní stavové kódy HTTP, jak je definováno v definicích stavových kódů HTTP/1.1.

Operace rozhraní API mohou také vracet podrobné informace o chybách, které služba definuje. Tyto informace o chybě jsou vráceny v textu odpovědi.

Tělo chybové odpovědi má základní formát, 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ší vrátí neúspěšné operace rozhraní API také řetězec kódu chyby Azure Storage v hlavičce odpovědi.

Hlavička odpovědi Popis
x-ms-error-code Hodnota, která označuje řetězec kódu chyby.

Konkrétní chybová odpověď může také obsahovat podrobné informace o chybě, které vývojáři poskytnou další informace. Například následující chybová odpověď označuje neplatný parametr dotazu zadaný v identifikátoru URI požadavku 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>

Pro verzi 2024-08-04 a novější bude chybová odpověď obsahovat podrobné informace o chybě, pokud typ podepsaného prostředku SAS účtu neodpovídá prostředku, ke kterému se přistupuje. Například následující chybová odpověď označuje, že k provedení operace je vyžadován 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í seznam článků obsahuje kolekce kódů chyb, které by pro vás mohly být užitečné:

Kopírovat chybovou odpověď rozhraní API

Chybová odpověď pro rozhraní API pro kopírování má stejný formát, jak bylo uvedeno výše. Tělo chybové odpovědi obsahuje code element pro řetězec kódu chyby a element označující message řetězec chybové zprávy.

U verzí 2024-02-04 a novějších může chybová odpověď obsahovat podrobnou chybu, pokud operace kopírování selže kvůli problému se zdrojem kopírování za předpokladu, že chyba ze zdroje vrátí tyto informace. Odpověď může obsahovat CopySourceStatusCode označení stavového kódu operace zdroje kopírování, CopySourceErrorCode určení vrácené x-ms-error-code chybové odpovědi zdroje kopírování a CopySourceErrorMessage označení odpovídající chybové zprávy.

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

Pro verze 2024-02-04 a novější Azure Storage vrátí stavový kód zdroje kopírování a kód chyby v hlavičce odpovědi, pokud byly přijaty při selhání zdroje kopírování.

Hlavička odpovědi Popis
x-ms-copy-source-status-code Hodnota, která označuje stavový kód selhání zdroje kopie.
x-ms-copy-source-error-code Hodnota, která označuje řetězec kódu chyby vrácený při selhání zdroje kopírování.

Následující rozhraní API pro kopírování vrátí tyto podrobnosti:

Chybové odpovědi pro Table Storage

Chybové odpovědi pro Table Storage jsou v souladu s formátem chyby popsaným v části 19 specifikace OData. Mohou být zahrnuty podrobné informace o chybě, ale chybová odpověď vždy odpovídá specifikaci OData .

Dávkové chybové odpovědi jsou podobné standardním chybovým odpovědím služby Table Storage. Další informace naleznete v tématu Provádění transakcí skupin entit.

Poznámka:

JSON je doporučený formát datové části pro Table Storage. Jedná se o jediný formát podporovaný pro verzi 2015-12-11 a novější.

Následující příklad ukazuje 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ásledující příklad ukazuje základní text chyby ve formátu Atom (verze 2015-12-11 a starší):

<?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
Skladovací služby REST

  • Last updated on