狀態和錯誤碼

Azure 儲存體的 REST API 作業會傳回標準 HTTP 狀態碼,如 HTTP/1.1 狀態碼定義中所定義

API 作業也可以傳回服務所定義的其他錯誤資訊。 這項額外的錯誤資訊會在回應主體中傳回。

錯誤回應的主體會遵循此處顯示的基本格式。 元素 code 表示錯誤碼字串,而 message 元素則表示錯誤訊息字串。

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

針對 2017-07-29 版和更新版本,失敗的 API 作業也會在回應標頭中傳回 Azure 儲存體錯誤碼字串。

回應標頭 描述
x-ms-error-code 值,表示錯誤碼字串。

特定的錯誤回應也可能包含額外的錯誤資訊,以提供開發人員更多資訊。 例如,下列錯誤回應表示要求 URI 上指定的查詢參數無效,並提供無效參數名稱和值的其他資訊,以及錯誤的原因。

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

下列主題提供您可能會發現有用的錯誤碼清單:

資料表儲存體的錯誤回應

資料表儲存體的錯誤回應符合 OData 規格第 19 節中所述的錯誤格式。 可能包含其他錯誤資訊,但錯誤回應一律符合 OData 規格。

批次錯誤回應類似于標準資料表儲存體錯誤回應。 如需詳細資訊,請參閱執行實體群組交易

注意

JSON 是資料表儲存體的建議承載格式。 這是 2015-12-11 版和更新版本唯一支援的格式。

以下顯示 JSON 格式的基本錯誤本文, (2013-08-15 版和更新版本) :

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

以下顯示 Atom 格式的基本錯誤本文, (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>  
  

另請參閱

針對 API 作業進行疑難排解
HttpStatusCode 列舉
儲存體服務 REST