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

复制 Blob

Copy Blob 作将 blob 复制到存储帐户中的目标。

在版本 2012-02-12 及更高版本中,作的 Copy Blob 源可以是任何 Azure 存储帐户中提交的 blob。

从版本 2015-02-21 开始,作的 Copy Blob 源可以是任何 Azure 存储帐户中的 Azure 文件。

注释

只有在 2012 年 6 月 7 日或之后创建的存储帐户才允许作 Copy Blob 从另一个存储帐户复制。

请求

可以按如下所示构造 Copy Blob 请求。 建议使用 HTTPS。 将 myaccount 替换为存储帐户的名称,将 mycontainer 替换为容器的名称,将 myblob 替换为目标 blob 的名称。

从版本 2013-08-15 开始,如果目标 blob 与源 blob 位于同一帐户中,则可以为目标 blob 指定共享访问签名 (SAS)。 从版本 2015-04-05 开始,如果目标 blob 位于不同的存储帐户中,还可以为目标 blob 指定共享访问签名。

PUT 方法请求 URI HTTP 版本
https://myaccount.blob.core.windows.net/mycontainer/myblob HTTP/1.1 协议

模拟存储服务的 URI

当您对模拟存储服务发出请求时,请将模拟器主机名和 Azure Blob 存储端口 127.0.0.1:10000指定为 ,后跟模拟存储帐户的名称:

PUT 方法请求 URI HTTP 版本
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1 协议

有关详细信息,请参阅 使用 Azurite 模拟器进行本地 Azure 存储开发

URI 参数

可以在请求 URI 上指定以下附加参数:

参数 DESCRIPTION
timeout 可选。 timeout 参数以秒为单位表示。 有关详细信息,请参阅 为 Blob 存储作设置超时

请求标头

下表描述了必需请求标头和可选请求标头:

请求标头 DESCRIPTION
Authorization 必填。 指定授权方案、帐户名称和签名。 有关详细信息,请参阅 授权对 Azure 存储的请求。
Datex-ms-date 必填。 指定请求的协调世界时(UTC)。 有关详细信息,请参阅 授权对 Azure 存储的请求。
x-ms-version 所有授权请求都是必需的。 有关详细信息,请参阅 azure 存储服务 版本控制。
x-ms-meta-name:value 可选。 指定与 blob 关联的用户定义的名称/值对。 如果未指定名称/值对,则作会将元数据从源 blob 或文件复制到目标 blob。 如果指定了一个或多个名称/值对,则使用指定的元数据创建目标 Blob,并且不会从源 Blob 或文件中复制元数据。

从版本 2009-09-19 开始,元数据名称必须遵循 C# 标识符的命名规则。 有关详细信息,请参阅 命名和引用容器、blob 和元数据
x-ms-tags 可选。 在 blob 上设置给定的查询字符串编码标记。 不会从复制源复制标记。 有关详细信息,请参阅 备注。 在版本 2019-12-12 及更高版本中受支持。
x-ms-source-if-modified-since 可选。 一个 DateTime 值。 指定此条件标头,仅当源 Blob 自指定日期/时间以来已修改时,才复制 Blob。 如果源 blob 尚未修改,则 Blob 存储将返回状态代码 412(不满足前提条件)。 如果源是 Azure 文件,则无法指定此标头。
x-ms-source-if-unmodified-since 可选。 一个 DateTime 值。 仅当源 Blob 自指定日期/时间以来尚未修改时,才指定此条件标头来复制 Blob。 如果源 blob 已被修改,则 Blob 存储将返回状态代码 412(前提条件失败)。 如果源是 Azure 文件,则无法指定此标头。
x-ms-source-if-match 可选。 一个 ETag 值。 指定此条件标头以仅在源 blob 的值与指定值匹配时 ETag 复制源 blob。 如果值不匹配,Blob 存储将返回状态代码 412(不满足前提条件)。 如果源是 Azure 文件,则无法指定此标头。
x-ms-source-if-none-match 可选。 一个 ETag 值。 指定此条件标头,以便仅在 blob 的值与指定值不匹配时 ETag 复制 blob。 如果值相同,则 Blob 存储将返回状态代码 412(不满足前提条件)。 如果源是 Azure 文件,则无法指定此标头。
If-Modified-Since 可选。 一个 DateTime 值。 指定此条件标头,仅当目标 Blob 自指定日期/时间以来已修改时,才复制 Blob。 如果尚未修改目标 Blob,则 Blob 存储将返回状态代码 412(不满足前提条件)。
If-Unmodified-Since 可选。 一个 DateTime 值。 仅当目标 Blob 自指定日期/时间以来尚未修改时,才指定此条件标头来复制 Blob。 如果目标 blob 已被修改,则 Blob 存储将返回状态代码 412(前提条件失败)。
If-Match 可选。 一个 ETag 值。 为此条件标头指定 ETag 一个值,以便仅在指定 ETag 值与 ETag 现有目标 blob 的值匹配时复制 blob。 如果值不匹配,Blob 存储将返回状态代码 412(不满足前提条件)。
If-None-Match 可选。 值 ETag 或通配符 (*)。

为此条件标头指定 ETag 一个值,以便仅在指定的 ETag 值与 ETag 目标 blob 的值不匹配时复制 blob。

指定通配符 (*) 以仅在目标 blob 不存在时执行该作。

如果未满足指定的条件,则 Blob 存储将返回状态代码 412 (Precondition Failed)。
x-ms-copy-source:name 必填。 指定源 blob 或文件的名称。

从版本 2012-02-12 开始,此值可以是长度不超过 2 千字节 (KiB) 的 URL,用于指定 blob。 该值应进行 URL 编码,就像它在请求 URI 中显示的那样。

可以通过共享密钥对同一存储帐户中的源 blob 执行读取作。 从版本 2017-11-09 开始,还可以使用 Microsoft Entra ID 授权对源 blob 执行读取作。 但是,如果源是另一个存储帐户中的 blob,则源 blob 必须是公共的,或者必须通过共享访问签名授权访问它。 如果源 blob 是公共的,则无需授权即可执行复制作。

从版本 2015-02-21 开始,源对象可以是 Azure 文件存储中的文件。 如果源对象是将复制到 blob 的文件,则必须通过共享访问签名对源文件进行授权,无论它位于同一帐户还是不同帐户中。

只有在 2012 年 6 月 7 日或之后创建的存储帐户才允许作 Copy Blob 从另一个存储帐户复制。

下面是源对象 URL 的一些示例:

- https://myaccount.blob.core.windows.net/mycontainer/myblob
- https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
- https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>

当源对象是 Azure 文件存储中的文件时,源 URL 使用以下格式。 请注意,URL 必须包含文件的有效 SAS 令牌。

- https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?sastoken

在 2012-02-12 之前的版本中,只能在同一帐户中复制 blob,并且源名称可以使用以下格式:

- 命名容器中的 Blob: /accountName/containerName/blobName
- 命名容器中的快照: /accountName/containerName/blobName?snapshot=<DateTime>
- 根容器中的 Blob: /accountName/blobName
- 根容器中的快照: /accountName/blobName?snapshot=<DateTime>
x-ms-lease-id:<ID> 如果目标 blob 具有活动租约,则为必需。 为此标头指定的租约 ID 必须与目标 Blob 的租约 ID 匹配。 如果请求不包括租约 ID 或 ID 无效,则作失败,状态代码为 412(前置条件失败)。

如果指定了此标头,并且目标 blob 当前没有活动租约,则作将失败,状态代码为 412 (Precondition Failed)。

在版本 2012-02-12 及更高版本中,此值必须为租用的 blob 指定活动无限租约。 有限持续时间租约 ID 失败,状态代码为 412 (Precondition Failed)。
x-ms-source-lease-id: <ID> 对于 2012-02-12 之前的版本,此参数为可选(在 2012-02-12 及更高版本中不受支持)。 指定此标头,以便仅在提供的租约 ID 与源 blob 的活动租约 ID 匹配时执行 Copy Blob 作。

如果指定了此标头,并且源 blob 当前没有活动租约,则作将失败,状态代码为 412 (Precondition Failed)。
x-ms-client-request-id 可选。 提供客户端生成的不透明值,该值具有配置日志记录时日志中记录的 1 KiB 字符限制。 强烈建议使用此标头将客户端活动与服务器接收的请求相关联。
x-ms-access-tier 可选。 指定要在目标 blob 上设置的层。 此标头仅适用于版本 2017-04-17 及更高版本的高级帐户上的页 blob。 有关受支持层的完整列表,请参阅 VM 的高性能高级存储和托管磁盘。 块 blob 版本 2018-11-09 及更高版本支持此标头。 Blob 存储或常规用途 v2 帐户支持块 blob 分层。 有效值为 HotCoolColdArchive注意:版本 2021-12-02 及更高版本支持Cold 层。 有关块 blob 分层的详细信息,请参阅 热存储层、冷存储层和存档存储层
x-ms-rehydrate-priority 可选。 指示用于解除存档 Blob 冻结的优先级。 块 blob 版本 2019-02-02 及更高版本支持此标头。 有效值为 HighStandard。 只能在 blob 上设置一次优先级。 在对同一 blob 的后续请求中,将忽略此标头。 没有此标头的默认优先级为 Standard
x-ms-seal-blob 可选。 在版本 2019-12-12 或更高版本上受支持。 此标头仅对追加 blob 有效。 它会在复制作完成后密封目标 blob。
x-ms-immutability-policy-until-date 版本 2020-06-12 及更高版本。 指定要在 blob 上设置的 retention-until 日期。 这是可以保护 blob 免遭修改或删除的日期。 它遵循RFC1123格式。
x-ms-immutability-policy-mode 版本 2020-06-12 及更高版本。 指定要在 blob 上设置的不可变性策略模式。 有效值为 unlockedlocked。 值 unlocked 表示用户可以通过增加或减少 retention-until date 来更改策略。 值 locked 表示禁止这些作。
x-ms-legal-hold 版本 2020-06-12 及更高版本。 指定要在 blob 上设置的依法保留。 有效值为 truefalse

此作仅支持 x-ms-if-tagsx-ms-source-if-tags conditional 标头仅在满足指定条件时成功。 有关详细信息,请参阅 为 Blob 存储操作指定条件标头

请求主体

没有。

响应

响应包括 HTTP 状态代码和一组响应标头。

状态代码

在版本 2012-02-12 及更高版本中,成功的作将返回状态代码 202 (Accepted)。

在 2012-02-12 之前的版本中,成功的作会返回状态代码 201 (Created)。

有关状态代码的信息,请参阅 状态和错误代码

响应标头

此操作的响应包括以下标头。 响应还可以包含其他标准 HTTP 标头。 所有标准标头都符合 HTTP/1.1 协议规范

响应头 DESCRIPTION
ETag 在版本 2012-02-12 及更高版本中,如果复制已完成,则此标头包含 ETag 目标 blob 的值。 如果复制未完成,则标头包含在 ETag 复制作开始时创建的空 blob 的值。

在 2012-02-12 之前的版本中,此标头返回 ETag 目标 blob 的值。

在版本 2011-08-18 及更高版本中, ETag 该值用引号引起来。
Last-Modified 返回对目标 blob 的复制作完成的日期/时间。
x-ms-request-id 唯一标识发出的请求。 可以使用此标头对请求进行故障排除。 有关详细信息,请参阅 API作疑难解答
x-ms-version 指示用于执行请求的 Blob 存储版本。 对于针对版本 2009-09-19 及更高版本发出的请求,将返回此标头。
Date 一个 UTC 日期/时间值,指示服务发送响应的时间。
x-ms-copy-id: <id> 版本 2012-02-12 及更高版本。 提供此复制作的字符串标识符。 与 Get BlobGet Blob Properties 一起使用可检查此复制作的状态,或传递给 Abort Copy Blob 以取消挂起的复制作。
x-ms-copy-status: <success ¦ pending> 版本 2012-02-12 及更高版本。 指示复制作的状态,具有以下值:

- success:作成功完成。
- pending:作正在进行中。
x-ms-version-id: <DateTime> 版本 2019-12-12 及更高版本。 按版本唯一标识 blob。 可以在后续请求中使用此不透明值来访问此版本的 Blob。
x-ms-client-request-id 可用于对请求和相应的响应进行故障排除。 此标头的值等于 x-ms-client-request-id 标头的值(如果请求中存在),并且该值最多为 1,024 个可见 ASCII 字符。 如果请求中不存在 x-ms-client-request-id 标头,则响应中不会显示此标头。

响应体

没有。

示例响应

以下代码是复制 blob 的请求的示例响应:

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:   
Last-Modified: <date>   
ETag: "0x8CEB669D794AFE2"  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-request-id: cc6b209a-b593-4be1-a38a-dde7c106f402  
x-ms-version: 2015-02-21  
x-ms-copy-id: 1f812371-a41d-49e6-b123-f4b542e851c5  
x-ms-copy-status: pending
x-ms-version-id: <DateTime>  
Date: <date>  
  

授权

在 Azure 存储中调用任何数据访问操作时,需要授权。 下表介绍了如何授权 Copy Blob作的目标和源对象:

对象类型 Microsoft Entra ID 授权 共享访问签名 (SAS) 授权 共享密钥授权(或共享密钥 Lite)
目标 blob 是的 是的 是的
同一存储帐户中的源 blob 是的 是的 是的
另一个存储帐户中的源 blob 是的

如果请求在请求标头中 x-ms-tags 指定了 tags,则调用方必须满足 Set Blob Tags 作的授权要求。

可以按如下所述授权 Copy Blob 操作。 请注意,必须通过具有 读取 (r) 权限的 SAS 令牌单独授权不同存储帐户中的源 blob。 有关源 blob 授权的更多信息,请参阅请求标头 x-ms-copy-source的详细信息。

重要

Microsoft建议将 Microsoft Entra ID 与托管标识配合使用来授权对 Azure 存储的请求。 与共享密钥授权相比,Microsoft Entra ID 提供更高的安全性和易用性。

Azure 存储支持使用 Microsoft Entra ID 来授权请求 Blob 数据。 使用 Microsoft Entra ID,可以使用 Azure 基于角色的访问控制(Azure RBAC)向安全主体授予权限。 安全主体可以是用户、组、应用程序服务主体或 Azure 托管标识。 安全主体由 Microsoft Entra ID 进行身份验证,以返回 OAuth 2.0 令牌。 然后可以使用令牌来授权对 Blob 服务发出请求。

若要详细了解如何使用 Microsoft Entra ID 进行授权,请参阅 使用 Microsoft Entra ID授予对 blob 的访问权限。

权限

下面列出了Microsoft Entra 用户、组、托管标识或服务主体调用 Copy Blob 操作所需的 RBAC 操作,以及包含此操作的最小特权内置 Azure RBAC 角色:

目标 blob

同一存储帐户中的源 blob

若要详细了解如何使用 Azure RBAC 分配角色,请参阅 分配 Azure 角色以访问 blob 数据

注解

在版本 2012-02-12 及更高版本中, Copy Blob 该作可以异步完成。 此作将返回一个复制 ID,您可以使用该 ID 来检查或取消复制作。 由于复制作的异步性质,Blob 存储会尽最大努力复制 Blob。 当服务器资源未被其他任务利用时,Blob 服务会复制 Blob,因此不能保证复制会立即启动或在指定的时间范围内完成。

复制作的源 blob 可以是块 blob、追加 blob、页 blob 或快照。 如果目标 blob 已存在,则它必须与源 blob 具有相同的 blob 类型。 任何现有的目标 blob 都将被覆盖。 当复制作正在进行时,无法修改目标 blob。

在版本 2015-02-21 及更高版本中,复制作的源也可以是 Azure 文件存储中的文件。 如果源是文件,则目标必须是块 blob。

一个账户中的多个待处理 Copy Blob 作可能会按顺序处理。 目标 blob 只能有一个未完成的 Copy Blob 作。 换句话说,一个 blob 不能是多个待处理 Copy Blob 作的目标。 尝试将 blob 复制到已挂起复制作的目标 blob 失败,状态代码为 409(冲突)。

只有在 2012 年 6 月 7 日或之后创建的存储帐户才允许作 Copy Blob 从另一个存储帐户复制。 尝试从另一个存储帐户复制到 2012 年 6 月 7 日之前创建的帐户失败,状态代码为 400 (错误请求)。

Copy Blob作始终复制整个源 blob 或文件。 不支持复制一系列字节或一组块。

Copy Blob作可以采用以下任何形式:

  • 可以将源 blob 复制到具有不同名称的目标 blob。 目标 blob 可以是相同 blob 类型(块、追加或页)的现有 blob,也可以是复制作创建的新 blob。

  • 可以将源 blob 复制到具有相同名称的目标 blob,从而有效地替换目标 blob。 此类复制作会删除任何未提交的块并覆盖 blob 的元数据。

  • 可以将 Azure 文件存储中的源文件复制到目标 blob。 目标 blob 可以是现有的块 blob,也可以是复制作创建的新块 blob。 不支持从文件复制到页 blob 或追加 blob。

  • 可以在其基本 blob 上复制快照。 通过将快照提升到基本 blob 的位置,可还原早期版本的 blob。

  • 可以将快照复制到具有不同名称的目标 blob。 生成的目标 Blob 是可写的 Blob,而不是快照。

从页 blob 复制时,Blob 存储会创建源 blob 长度的目标页 blob。 最初,页 blob 包含所有零。 然后枚举源页面范围,并复制非空范围。

对于块 blob 或追加 blob,Blob 存储在从此作返回之前会创建一个长度为零的已提交 blob。

从块 blob 复制时,将复制所有已提交的块及其块 ID。 未提交的块不会被复制。 在复制作结束时,目标 blob 的已提交块计数与源 blob 相同。

从追加 blob 复制时,将复制所有提交的块。 在复制作结束时,目标 blob 的已提交块数将少于或等于源 blob 数。

对于所有 blob 类型,都可以调用 Get Blob 目标 blob 上的 或 Get Blob Properties 来检查复制作的状态。 复制作完成后,将提交最终 blob。

当复制作的源提供 ETag 值时,在复制作正在进行时对源的任何更改都会导致该作失败。 在复制过程中尝试更改目标 blob 将失败,并显示状态代码 409 (冲突)。 如果目标 blob 具有无限租约,则必须将租约 ID 传递给 Copy Blob。 不允许有限期限的租约。

ETag块 blob 的值在作开始时和作结束时会发生变化Copy BlobETag页 blob 的值在作开始时会更改Copy Blob,并且在复制作期间会继续频繁更改。 只有在完整复制作完成后,块 blob 的内容才能通过 Get 命令可见。

复制 blob 属性、标记和元数据

复制 blob 时,以下系统属性将复制到具有相同值的目标 blob:

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-Length

  • Cache-Control

  • Content-MD5

  • Content-Disposition

  • x-ms-blob-sequence-number (仅适用于页 blob)

  • x-ms-committed-block-count (仅适用于追加 blob,并且仅适用于版本 2015-02-21)

如果 blob 是块 blob,则源 blob 的已提交块列表也会复制到目标 blob。 不会复制任何未提交的块。

目标 blob 的大小始终与源 blob 相同。 目标 blob 的标头值 Content-Length 与源 blob 的标头值匹配。

当源 blob 和目标 blob 相同时, Copy Blob 删除任何未提交的块。 如果在这种情况下指定了 metadata,则现有元数据将被新元数据覆盖。

x-ms-tags如果标头为目标 blob 提供标记,则必须对它们进行查询字符串编码。 标签键和值必须符合 设置 Blob 标签中指定的命名和长度要求。

x-ms-tags标头最多可以包含 2 KB 的标签。 如果您需要更多标签,请使用该 Set Blob Tags 作。

x-ms-tags如果标头未提供标记,则不会从源 blob 复制标记。

复制租用的 blob

Copy Blob 作仅从源 blob 中读取,因此源 blob 的租约状态无关紧要。 但是,该 Copy Blob 作会在复制作启动时保存 ETag 源 blob 的值。 如果在复制作完成之前 ETag 值发生更改,则作将失败。 可以通过在复制作期间租用源 blob 来防止对源 blob 进行更改。

如果目标 blob 具有活动的无限租约,则必须在对 Copy Blob 作的调用中指定其租约 ID。 如果您指定的租约是有效的有限持续时间租约,则此调用将失败,并显示状态代码 412 (Precondition Failed)。 当复制作处于挂起状态时,目标 blob 上的任何租约作都会失败,状态代码为 409 (冲突)。 在复制作期间,无论是复制到与源名称不同的目标 blob、复制到与源名称相同的目标 blob,还是在其基本 blob 上提升快照,目标 blob 上的无限租约都会以这种方式锁定。

如果客户端在尚不存在的 blob 上指定租约 ID,则 Blob 存储将针对版本 2013-08-15 及更高版本发出的请求返回状态代码 412 (前提条件失败) 。 对于早期版本,Blob 存储返回状态代码 201 (Created)。

复制 blob 快照

复制源 blob 时,不会将源 blob 的任何快照或版本复制到目标。 当目标 blob 被副本覆盖时,与目标 blob 关联的任何快照或版本在其名称下保持不变。

可以执行复制作,将快照提升到其基本 blob 上,只要它位于联机层(热或冷)中即可。 这样,可以还原 blob 的早期版本。 快照将保留,但其目标将被可读取和写入的副本覆盖。

复制 blob 版本

可以执行复制作,将版本提升到其基本 blob 上,只要该版本位于联机层(热或冷)中即可。 这样,可以还原 blob 的早期版本。 版本仍然存在,但其目标被可读取和写入的副本覆盖。

复制存档的 blob

从版本 2018-11-09 开始,可以将存档的 blob 复制到同一存储帐户中的新 blob。 源 blob 保留在存档层中。 当源 blob 是存档的 blob 时,请求必须包含 x-ms-access-tier 标头,该标头指示目标 blob 的层。 目标 blob 必须位于联机层中。 无法复制到存档层中的 blob。

从版本 2021-02-12 开始,只要目标帐户与源帐户位于同一区域,就可以将存档的 blob 复制到其他存储帐户中的联机层。

如果正在解除冻结源 blob,则请求可能会失败。

有关在块 blob 级别分层的详细信息,请参阅 热存储层、冷存储层和存档存储层

使用待处理的复制作(版本 2012-02-12 及更高版本)

Copy Blob如果作异步完成,请使用下表根据返回的状态代码确定下一步:

状态代码 含义
202 (已接受),x-ms-copy-status: success 复制作成功完成。
202 (已接受),x-ms-copy-status: pending 复制作尚未完成。 使用 Get Blob Properties 轮询目标 blob 以检查 x-ms-copy-status 标头,直到作完成或失败。
4xx、500 或 503 复制作失败。

在作期间和之后 Copy Blob ,目标 blob 的属性包含作的 Copy Blob 复制 ID 和源 blob 的 URL。 作完成后,Blob 存储会将时间和结果值(successfailedaborted)写入目标 blob 的属性。 如果作具有 failed 结果,则 x-ms-copy-status-description 标头包含错误详细信息字符串。

挂起的 Copy Blob作有两周超时。 两周后仍未完成的复制尝试将超时,并留下一个空 blob,其 x-ms-copy-status 字段设置为 failed 500 ( x-ms-copy-status-description OperationCancelled)。 在复制作期间可能发生的间歇性非致命错误可能会妨碍作的进度,但不会导致作失败。 在这些情况下,x-ms-copy-status-description 描述间歇性错误。

在复制作期间修改目标 blob 或创建目标 blob 快照的任何尝试都将失败,并显示状态代码 409(冲突)、“复制 blob 正在进行”。

如果调用该 Abort Copy Blob 作,您将看到一个 x-ms-copy-status:aborted 标头。 目标 blob 将具有完整的元数据和 blob 长度为 0 字节。 您可以重复原始调用 to Copy Blob 以再次尝试复制作。

Copy Blob如果作同步完成,请使用下表确定复制作的状态:

状态代码 含义
202 (已接受),x-ms-copy-status: success 复制作成功完成。
4xx、500 或 503 复制作失败。

高级存储层继承了该层。 对于块 blob,如果未提供,则覆盖目标 blob 将从目标 x-ms-access-tier 继承热层或冷层。 覆盖存档的 blob 将失败。 有关在块 blob 级别分层的详细信息,请参阅 热存储层、冷存储层和存档存储层

账单管理

定价请求可能源自使用 Blob 存储 API 的客户端,可以直接通过 Blob 存储 REST API 或 Azure 存储客户端库。 这些请求按事务产生费用。 事务类型会影响帐户的计费方式。 例如,读取事务累算到与写入事务不同的计费类别。 下表显示了基于存储帐户类型的 Copy Blob 请求的计费类别:

操作 存储帐户类型 计费类别
复制 Blob(目标帐户1 高级块 blob
标准常规用途 v2
标准常规用途 v1
写入操作
复制 Blob(源帐户2 高级块 blob
标准常规用途 v2
标准常规用途 v1
读取操作

1目标账户需要为启动写入的 1 个事务付费。
阿拉伯数字当源对象位于不同的账户中时,源账户对源对象的每个读取请求都会产生一个事务。

若要了解指定计费类别的定价,请参阅 Azure Blob 存储定价

目标帐户还会为取消复制作(请参阅 中止复制 Blob)或检查复制作的状态(请参阅 获取 Blob获取 Blob 属性)的每个请求产生事务成本。

此外,如果源账户和目标账户位于不同的区域(例如,美国北部和美国南部),则用于传输请求的带宽将作为出口向源存储帐户收费。 同一区域中的帐户之间的出口是免费的。

将源 blob 复制到同一帐户中具有不同名称的目标 blob 时,会为新 blob 使用额外的存储资源。 然后,复制作将对存储帐户的容量使用量收取这些额外资源的费用。 但是,如果源 blob 和目标 blob 的名称在同一帐户中相同(例如,当您将快照提升到其基本 blob 时),则不会产生额外费用,除了存储在版本 2012-02-12 及更高版本中的额外复制元数据外。

提升快照以替换其基本 blob 时,快照和基本 blob 将变得相同。 它们共享块或页面,因此复制作不会对存储帐户的容量使用产生额外费用。 但是,如果将快照复制到具有不同名称的目标 blob,则该作将产生生成的新 blob 使用的存储资源的额外费用。 具有不同名称的两个 blob 不能共享块或页面,即使它们相同。 有关快照成本方案的更多信息,请参阅 了解快照如何产生费用

另请参阅

授权对 Azure 存储 的请求
状态和错误代码
Blob 存储错误代码
了解快照如何产生费用
中止复制 Blob