通过

你当前正在访问 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 位于同一帐户中，则可以指定共享访问签名 (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 上指定以下附加参数：

参数 说明
timeout 可选。 timeout 参数以秒表示。 有关详细信息，请参阅 为 Blob 存储操作设置超时。

请求标头

下表介绍了必需请求标头和可选请求标头：

请求标头 说明
Authorization 必需。 指定授权方案、帐户名称和签名。 有关详细信息，请参阅授权对 Azure 存储的请求。
Date 或 x-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值与现有目标 Blob 的值匹配ETag时，才能复制 Blob。 如果值不匹配，Blob 存储将返回状态代码 412 (先决条件失败) 。
If-None-Match 可选。 值 ETag 或通配符 (*) 。

ETag指定此条件标头的值，以便仅当指定的ETag值与目标 Blob 的值不匹配ETag时复制 Blob。

指定通配符 (*) ，仅当目标 blob 不存在时才执行操作。

如果不满足指定条件，Blob 存储将返回状态代码 412 (先决条件失败) 。
x-ms-copy-source:name 必需。 指定源 Blob 或文件的名称。

从版本 2012-02-12 开始，此值可以是最多 2 千字节的 URL， (指定 blob 的 KiB) 长度。 该值应按 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 (前置条件失败) 。

在版本 2012-02-12 及更高版本中，此值必须为租用的 Blob 指定活动无限期租约。 有限持续时间租约 ID 失败，状态代码为 412 (前置条件失败) 。
x-ms-source-lease-id: <ID> 2012-02-12 及更高版本中不支持 2012-02-12 () 之前的版本可选。 仅当提供的租约 ID 与源 Blob 的活动租约 ID 匹配时，指定此标头才能执行 Copy Blob 操作。

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

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

请求正文

无。

响应

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

状态代码

在版本 2012-02-12 及更高版本中，成功的操作返回状态代码 202 (接受) 。

在 2012-02-12 之前的版本中，成功地操作将返回状态代码 201（已创建）。

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

响应头

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

响应标头 说明
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 Blob Properties 一起使用Get Blob检查此复制操作的状态，或将 传递给 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) 授权 共享密钥授权 (或共享密钥精简版)
目标 Blob 是 是 是
同一存储帐户中的源 Blob 是 是 是
另一个存储帐户中的源 Blob 否 是 否

如果请求在请求标头中 x-ms-tags 指定标记，则调用方必须满足 “设置 Blob 标记” 操作的授权要求。

可以授权操作， Copy Blob 如下所述。 请注意，必须通过 SAS 令牌单独对不同存储帐户中的源 blob 进行授权，该令牌具有 读取 (r) 权限。 有关源 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。 由于复制操作的异步性质，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 或 Get Blob Properties 来检查复制操作的状态。 复制操作完成后，将提交最终 Blob。

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

当 ETag 操作开始和操作完成时 Copy Blob ，块 Blob 的值会更改。 页 ETag 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 会删除所有未提交的块。 如果这种情况下指定元数据，将用新的元数据覆盖现有元数据。

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

标头 x-ms-tags 最多可以包含 2 kb 的标记。 如果需要更多标记，请使用 Set Blob Tags 操作。

x-ms-tags如果标头不提供标记，则不会从源 Blob 复制标记。

复制租用的 Blob

该 Copy Blob 操作仅从源 Blob 读取数据，因此源 Blob 的租用状态无关紧要。 但是，操作会在Copy BlobETag复制操作开始时保存源 Blob 的值。 如果该值在 ETag 复制操作完成之前发生更改，则操作将失败。 不能通过在复制操作期间租用源 Blob 来阻止其更改。

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

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

复制 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：成功 复制操作已成功完成。
202（已接受），x-ms-copy-status：挂起 复制操作尚未完成。 通过使用 Get Blob Properties 轮询目标 Blob，以 x-ms-copy-status 检查标头，直到操作完成或失败。
4xx、500 或 503 复制操作失败。

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

挂起 Copy Blob 的操作超时为两周。 两周后尚未完成的复制尝试超时，并留下一个空 blob， x-ms-copy-status 字段设置为 failedx-ms-copy-status-description ， (OperationCancelled) 。 复制操作期间可能发生的间歇性非致命错误可能会妨碍操作的进度，但不会导致操作失败。 这种情况下，x-ms-copy-status-description 说明间发错误。

复制操作期间修改或快照目标 blob 的任何尝试都将失败，状态代码为 409 (冲突) “复制 Blob 正在进行”。

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

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

状态代码 含义
202（已接受），x-ms-copy-status：成功 复制操作已成功完成。
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目标帐户针对一个事务收费以启动写入。
2当源对象位于其他帐户中时，源帐户对源对象的每次读取请求都会产生一个事务。

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

对于取消复制操作 (请参阅中止复制 Blob) 或检查复制操作状态 (请参阅获取 Blob 或获取 Blob 属性) ，则每个请求也会产生事务费用。

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

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

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

另请参阅

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