销售电话: 1-800-867-1380

中止复制 Blob (REST API)

更新时间: 2015年4月

Abort Copy Blob 操作中止挂起的Copy Blob 操作,并使目标 Blob 具有零长度和完整元数据。2012-02-12 和更高版本。

按如下所示构造Abort Copy Blob。建议使用 HTTPS。将 myaccount 替换为你的存储帐户名称,将 mycontainer 替换为你的容器名称,将 myblob 替换为你的目标 Blob 名称,并将 <id> 替换为在原始 Copy Blob 操作的 x-ms-copy-id 标头中提供的复制标识符:

 

PUT 方法请求 URI HTTP 版本

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=copy&copyid=<id>

HTTP/1.1

在针对本地存储服务发出请求时,请将本地主机名和 BLOB 服务端口指定为 127.0.0.1:10000,后跟本地存储帐户名称:

 

PUT 方法请求 URI HTTP 版本

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=copy&copyid=<id>

HTTP/1.1

有关详细信息,请参阅Using the Azure Storage Emulator for Development and Testing

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

 

Parameter 说明

timeout

可选。timeout 参数以秒表示。有关详细信息,请参阅为 Blob 服务操作设置超时

下表介绍必需的和可选的请求标头。

 

请求标头 说明

Authorization

必需。指定身份验证方案、帐户名和签名。有关详细信息,请参阅Azure 存储服务身份验证

Datex-ms-date

必需。为请求指定协调世界时 (UTC)。有关详细信息,请参阅Azure 存储服务身份验证

x-ms-version

对于所有验证的请求是必需的。有关详细信息,请参阅Windows Azure 中 BLOB 服务、队列服务和表服务的版本管理

x-ms-lease-id:<ID>

如果目标 Blob 具有活动无限期租约,则是必需的。

x-ms-copy-action: abort

必需。

x-ms-client-request-id

可选。提供客户端生成的、附带 1 KB 字符限制的不透明值,在启用存储分析日志记录时,将在分析日志中记录该值。强烈建议使用此标头将客户端活动与服务器接收的请求相关联。有关详细信息,请参阅 关于存储分析日志记录Azure 日志记录:使用日志跟踪存储请求

无。

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

成功的操作将返回状态代码 204(无内容)。

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

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

 

请求标头 说明

x-ms-request-id

此标头唯一地标识发出的请求,并且可用于解决请求问题。有关详细信息,请参阅API 操作故障排除

x-ms-version

指示用于执行请求的 BLOB 服务的版本。

Date

服务生成的 UTC 日期/时间值指示启动响应的时间。

只有帐户所有者可以调用此操作。

在中止挂起的Copy Blob 操作时,目标 Blob 的 x-ms-copy-status 标头将设置为 aborted。中止复制操作将导致目标 Blob 具有零长度的块 Blob 和页 Blob。不过,目标 Blob 的元数据具有从源 Blob 中复制的新值,或者具有在Copy Blob 操作调用中显式设置的值。要在复制之前保留原始的元数据,请在调用Copy Blob 之前创建目标 Blob 的快照。

你只能中止挂起的复制操作。尝试中止已完成或失败的复制将导致 409 冲突。尝试使用不正确的复制 ID 中止复制操作也会导致 409 冲突

本文是否对您有所帮助?
(1500 个剩余字符)
感谢您的反馈
Microsoft 正在进行一项网上调查,以了解您对 MSDN 网站的意见。 如果您选择参加,我们将会在您离开 MSDN 网站时向您显示该网上调查。

是否要参加?
显示:
© 2015 Microsoft