你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

状态和错误代码

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