狀態和錯誤碼
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>
針對 2024-08-04 版和更新版本，當帳戶 SAS 簽署的資源類型不符合所存取的資源時，錯誤回應會包含其他錯誤資訊。 例如，下列錯誤回應指出執行作業需要簽署的資源類型 『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>
下列主題提供您可能會發現有用的錯誤碼清單：
數據表記憶體的錯誤回應
數據表記憶體的錯誤回應符合 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>