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

常见 REST API 错误代码

对任何 Azure 存储服务执行的操作都可能返回以下错误代码:

错误代码 HTTP 状态代码 用户消息
NoAuthenticationInformation 未授权 (401) 服务器无法验证该请求。 请参阅 www-authenticate 标头中的信息。
InvalidAuthenticationInfo 未授权 (401) 服务器无法验证该请求。 请参阅 www-authenticate 标头中的信息。
AccountAlreadyExists 冲突 (409) 指定的帐户已存在。
AccountBeingCreated 冲突 (409) 正在创建指定的帐户。
AccountIsDisabled 禁止访问 (403) 已禁用指定的帐户。
AccountProtectedFromDeletion 冲突 (409) 帐户 <accountName> 容器 <containerName> 具有 <have legal hold\locked immutability policy>
AuthenticationFailed 禁止访问 (403) 服务器无法验证该请求。 请确保 Authorization 标头的值构成正确,包括签名。
ConditionHeadersNotSupported BadRequest (400) 不支持条件标头。
ConditionNotMet 未修改 (304) 不符合在条件标头中指定的条件,无法执行读取操作。
ConditionNotMet 前提条件失败 (412) 不符合在条件标头中指定的条件,无法执行写入操作。
EmptyMetadataKey 错误的请求 (400) 元数据键-值对之一的键是空的。
InsufficientAccountPermissions 禁止访问 (403) 读取操作当前处于禁用状态。
InsufficientAccountPermissions 禁止访问 (403) 不允许写入操作。
InsufficientAccountPermissions 禁止访问 (403) 正在访问的帐户没有足够的权限来执行此操作。
InternalError 内部服务器错误 (500) 服务器遇到内部错误。 请重试请求。
InvalidAuthenticationInfo 错误的请求 (400) 未以正确的格式提供身份验证信息。 验证 Authorization 标头的值。
InvalidHeaderValue 错误的请求 (400) 为 HTTP 标头之一提供的值的格式不正确。
InvalidHttpVerb 错误的请求 (400) 服务器无法识别指定的 HTTP 动词。
InvalidInput 错误的请求 (400) 某个请求输入无效。
InvalidMd5 错误的请求 (400) 在请求中指定的 MD5 值无效。 MD5 值必须为 128 位并采用 Base64 编码。
InvalidMetadata 错误的请求 (400) 指定的元数据无效。 它包括不允许的字符。
InvalidQueryParameterValue 错误的请求 (400) 为请求 URI 中的查询参数之一指定的值无效。
InvalidRange 请求的范围不符合条件 (416) 指定的范围对当前资源大小无效。
InvalidResourceName 错误的请求 (400) 指定的资源名称包含无效字符。
InvalidUri 错误的请求 (400) 请求的 URI 不表示服务器上的任何资源。
InvalidXmlDocument 错误的请求 (400) 指定的 XML 语法无效。
InvalidXmlNodeValue 错误的请求 (400) 为请求正文中的 XML 节点之一提供的值的格式不正确。
KeyVaultAccessTokenCannotBeAcquired 禁止访问 (403) 无法使用此资源的标识从 Microsoft Entra 获取密钥保管库的访问令牌。
KeyVaultEncryptionKeyNotFound 禁止访问 (403) 找不到密钥保管库密钥来解包加密密钥。
KeyVaultVaultNotFound 禁止访问 (403) 找不到密钥保管库保管库。
Md5Mismatch 错误的请求 (400) 在请求中指定的 MD5 值与服务器计算的 MD5 值不匹配。
MetadataTooLarge 错误的请求 (400) 指定的元数据大小超过允许的最大大小。
MissingContentLengthHeader 需要指定长度 (411) 未指定 Content-Length 标头。
MissingRequiredQueryParameter 错误的请求 (400) 没有为此请求指定所需的查询参数。
MissingRequiredHeader 错误的请求 (400) 未指定所需的 HTTP 标头。
MissingRequiredXmlNode 错误的请求 (400) 请求正文中未指定所需的 XML 节点。
MultipleConditionHeadersNotSupported 错误的请求 (400) 不支持多个条件标头。
OperationTimedOut 内部服务器错误 (500) 无法在允许的时间内完成该操作。 该操作可能在服务器端成功,也可能未成功。 请在重试操作之前查询服务器状态。
OutOfRangeInput 错误的请求 (400) 请求输入之一超过范围。
OutOfRangeQueryParameterValue 错误的请求 (400) 在请求 URI 中指定的查询参数超过了允许范围。
RequestBodyTooLarge 请求实体太大 (413) 请求正文大小超过允许的最大大小。
ResourceTypeMismatch 冲突 (409) 指定的资源类型与现有资源的类型不匹配。
RequestUrlFailedToParse 错误的请求 (400) 无法解析请求中的 URL。
ResourceAlreadyExists 冲突 (409) 指定的资源已存在。
ResourceNotFound 找不到 (404) 指定的资源不存在。
ServerBusy 服务不可用 (503) 服务器当前无法接收请求。 请重试请求。
ServerBusy 服务不可用 (503) 入口超出帐户限制。
ServerBusy 服务不可用 (503) 出口超出帐户限制。
ServerBusy 服务不可用 (503) 每秒操作数超过帐户限制。
UnsupportedHeader 错误的请求 (400) 不支持请求中指定的 HTTP 标头之一。
UnsupportedXmlNode 错误的请求 (400) 不支持请求正文中指定的 XML 节点之一。
UnsupportedQueryParameter 错误的请求 (400) 不支持请求 URI 中指定的查询参数之一。
UnsupportedHttpVerb 不允许使用方法 (405) 资源不支持指定的 HTTP 动词。

另请参阅

Blob 存储错误代码
队列存储错误代码
表存储错误代码
Azure 文件存储错误代码
排查 API 操作问题
HttpStatusCode 枚举
Azure 存储 REST API 参考