你当前正在访问 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 不存在。 |
| BlobOperationNotSupported | 冲突 (409) | 此方案中不支持该操作。 如果对使用 Azure Data Lake Storage Gen2 REST API 的 Path - 创建操作创建的 Blob 使用 PutBlock 或 PutBlockList 操作，则可能会出现此错误。 |
| 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