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

Azure Blob 存储错误代码

你可能会看到针对Azure Blob 存储的操作返回的以下错误代码。

错误代码 HTTP 状态代码 用户消息
AppendPositionConditionNotMet 前提条件失败 (412) 未满足指定的追加位置条件。
BlobAlreadyExists 冲突 (409) 指定的 Blob 已存在。
BlobImmutableDueToLegalHold 冲突 (409) 不允许此操作,因为 Blob 由于一个或多个法定保留是不可变的。
BlobImmutableDueToPolicy 冲突 (409) 不允许此操作,因为 Blob 因策略而不可变。
BlobNotFound 找不到 (404) 指定的 Blob 不存在。
BlobOverwritten 冲突 (409) 自上一个快照创建以来,已重新创建 Blob。
BlobTierInadequateForContentLength 冲突 (409) 指定的 Blob 层大小限制不能小于内容长度。
BlockCountExceedsLimit 冲突 (409) 提交的块计数不能超过最大限制 50,000 个块。
BlockCountExceedsLimit 冲突 (409) 未提交的块计数不能超过最大限制 100,000 个块。
BlockListTooLong 错误的请求 (400) 阻止列表可能不包含超过 50,000 个块。
CannotChangeToLowerTier 冲突 (409) 已显式设置更高的 Blob 层。
CannotVerifyCopySource 内部服务器错误 (500) 无法在指定的时间内验证复制源。 有关此故障的更多信息,请查看 HTTP 状态代码和消息。
ContainerAlreadyExists 冲突 (409) 指定的容器已经存在。
ContainerBeingDeleted 冲突 (409) 指定的容器已删除。
ContainerDisabled 冲突 (409) 管理员已禁用指定的容器。
ContainerHasLegalHold 冲突 (409) 不允许请求的操作,因为容器具有一个或多个法定保留。
ContainerImmutabilityPolicyLocked 冲突 (409) 不允许请求的操作,因为容器具有锁定的不可变性策略。
ContainerNotFound 找不到 (404) 指定的容器不存在。
ContentLengthLargerThanTierLimit 冲突 (409) Blob 的内容长度不能超过其层限制。
CopyAcrossAccountsNotSupported 错误的请求 (400) 复制源帐户和目标帐户必须相同。
CopyIdMismatch 冲突 (409) 指定的复制 ID 与挂起的复制操作的复制 ID 不匹配。
DirectorySasNotSupportedVersion 冲突 (409) 此版本不支持目录 SAS。
FeatureVersionMismatch 冲突 (409) AppendBlob 的操作至少需要版本 2015-02-21。
FeatureVersionMismatch 冲突 (409) 此版本无法识别容器中的 Blob 类型。
IncrementalCopyBlobMismatch 冲突 (409) 指定的源 Blob 不同于现有增量复制 Blob 的复制源。
IncrementalCopyOfEarlierVersionSnapshotNotAllowed 冲突 (409) 指定的快照早于复制到增量复制 Blob 中的最后一个快照。
IncrementalCopySourceMustBeSnapshot 冲突 (409) 增量复制请求的源必须是快照。
InfiniteLeaseDurationRequired 前提条件失败 (412) 租约 ID 匹配,但指定的租约必须为无限期租约。
InvalidBlobOrBlock 错误的请求 (400) 指定的 Blob 或块内容无效。
InvalidBlobTier 错误的请求 (400) 指定的 Blob 层无效。
InvalidBlobType 冲突 (409) Blob 类型对此操作无效。
InvalidBlockId 错误的请求 (400) 指定的块 ID 无效。 块 ID 必须采用 Base64 编码。
InvalidBlockList 错误的请求 (400) 指定的阻止列表无效。
InvalidOperation 错误的请求 (400) 对 Blob 快照执行的操作无效。
InvalidPageRange 请求的范围不符合条件 (416) 指定的页面范围无效。
InvalidSourceBlobType 冲突 (409) 复制源 Blob 类型对于此操作无效。
InvalidSourceBlobUrl 冲突 (409) 增量复制请求的源 URL 必须Azure 存储 blob URL 有效。
InvalidVersionForPageBlobOperation 错误的请求 (400) 对页 Blob 的所有操作都必须至少为版本 2009-09-19。
LeaseAlreadyPresent 冲突 (409) 已存在租约。
LeaseAlreadyBroken 冲突 (409) 租约已中断,不能再次中断。
LeaseIdMismatchWithBlobOperation 前提条件失败 (412) 指定的租约 ID 与 Blob 的租约 ID 不匹配。
LeaseIdMismatchWithContainerOperation 前提条件失败 (412) 指定的租约 ID 与容器的租约 ID 不匹配。
LeaseIdMismatchWithLeaseOperation 冲突 (409) 指定的租约 ID 与Blob/容器的租约 ID 不匹配。
LeaseIdMissing 前提条件失败 (412) Blob/容器目前有租约,但请求中未指定租约 ID。
LeaseIsBreakingAndCannotBeAcquired 冲突 (409) 租约 ID 匹配,但租约现处于正在中断状态,在中断完成前不能获取。
LeaseIsBreakingAndCannotBeChanged 冲突 (409) 租约 ID 匹配,但租约现处于正在中断状态,在中断完成前不能更改。
LeaseIsBrokenAndCannotBeRenewed 冲突 (409) 租约 ID 匹配,但显式中断的租约不能续订。
LeaseLost 前提条件失败 (412) 指定了租约 ID,但 Blob/容器租约已过期。
LeaseNotPresentWithBlobOperation 前提条件失败 (412) Blob 当前没有租约。
LeaseNotPresentWithContainerOperation 前提条件失败 (412) 容器当前没有租约。
LeaseNotPresentWithLeaseOperation 冲突 (409) Blob/容器当前没有租约。
MaxBlobSizeConditionNotMet 前提条件失败 (412) 未满足指定的最大 Blob 大小条件。
NoPendingCopyOperation 冲突 (409) 当前没有挂起的复制操作。
OperationNotAllowedOnIncrementalCopyBlob 冲突 (409) 在增量复制 Blob 上不允许指定操作。
PendingCopyOperation 冲突 (409) 当前有一个挂起的复制操作。
PreviousSnapshotCannotBeNewer 错误的请求 (400) prevsnapshot查询参数值不能大于快照查询参数值。
PreviousSnapshotNotFound 冲突 (409) 找不到上一个快照。
PreviousSnapshotOperationNotSupported 冲突 (409) 上一快照不支持差异 获取页面范围
QueryParameterSddInvalid 禁止访问 (403) sdd 参数无效。
QueryParameterSasMandatory 禁止访问 (403) 对于目录 SAS,sdd 参数是必需的。 不能为空。
SequenceNumberConditionNotMet 前提条件失败 (412) 不满足指定的序列号条件。
SequenceNumberIncrementTooLarge 冲突 (409) 无法执行序列号递增,因为这会导致序列号溢出。
SnapshotCountExceeded 冲突 (409) 已超出此 Blob 的快照计数。
SnapshotOperationRateExceeded 冲突 (409) 已超出此 Blob 的快照操作速率。
SnapshotsPresent 冲突 (409) 当 Blob 包含快照时不允许执行此操作。
SourceConditionNotMet 前提条件失败 (412) 不满足使用 HTTP 条件头指定的源条件。
SystemInUse 冲突 (409) 此 Blob 已被系统使用。
TargetConditionNotMet 前提条件失败 (412) 不满足使用 HTTP 条件头指定的目标条件。
UnauthorizedBlobOverwrite 禁止访问 (403) 此请求无权执行 Blob 覆盖。
UnsupportedHeader 错误的请求 (400) 不支持请求中指定的某个 HTTP 标头。
BlobBeingRehydrated 冲突 (409) 不允许此操作,因为 Blob 正在解除冻结。
BlobArchived 冲突 (409) 在存档的 Blob 上不允许此操作。
BlobNotArchived 冲突 (409) 此 Blob 当前未处于存档状态。

请参阅

常见 REST API 错误代码
队列存储错误代码
表存储错误代码
API 操作疑难解答
HttpStatusCode 枚举
存储服务 REST