你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
状态和错误代码
Azure 存储的 REST API 操作返回 HTTP /1.1 状态代码定义中定义的标准 HTTP 状态代码。
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>