你当前正在访问 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>  
  

另请参阅

API 操作疑难解答
HttpStatusCode 枚举
存储服务 REST