您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

Blob 服务REST API

Blob 服务将文本和二进制数据存储为云中的对象。 BLOB 服务提供以下三种资源:存储帐户、容器和 Blob。 在存储帐户中,容器提供组织 Blob 集的方法。

可以在以下几种类型的 Blob 之一中存储文本和二进制数据:

  • 块 Blob,针对流进行了优化。

  • 追加 Blob,已针对追加操作进行优化。

  • 页 Blob,针对随机读取/写入操作进行了优化,并提供了在 Blob 中写入一定范围字节的功能。

有关块 Blob 和页 Blob 详细信息,请参阅了解块 Blob、追加 Blob 和页 Blob。

Blob REST API定义针对存储帐户、容器和 Blob 的 HTTP 操作。 该 API 包括下表中列出的操作。

操作 资源类型 说明
列出容器 帐户 列出存储帐户中的所有容器。
设置 Blob 服务属性 帐户 设置 BLOB 服务的属性,包括日志记录和度量设置以及默认服务版本。
获取 Blob 服务属性 帐户 获 BLOB 服务的属性,包括日志记录和度量设置以及默认服务版本。
预检 Blob 请求 帐户 在发送实际请求之前,查询 Blob 服务的跨域资源共享 (CORS) 规则。
获取 Blob 服务统计信息 帐户 检索与 Blob 服务的复制有关的统计信息。 仅在为存储帐户启用了读访问的地域冗余复制时,才能在辅助位置的终结点上使用此操作。
获取帐户信息 帐户 返回指定帐户的 SKU 名称和帐户类型。
获取用户委派密钥 帐户 获取一个密钥,该密钥可用于在共享访问签名 (用户委派 SAS) 。 用户委派 SAS 使用凭据授予对 Blob 服务Azure Active Directory (Azure AD) 的访问权限。
创建容器 容器 在存储帐户中新建一个容器。
获取容器属性 容器 返回容器的所有用户定义的元数据和系统属性。
获取容器元数据 容器 仅返回容器的用户定义的元数据。
设置容器元数据 容器 设置容器的用户定义元数据。
获取容器 ACL 容器 为容器获取公共访问策略和任何存储访问策略。
Set Container ACL 容器 为容器设置公共访问策略和任何存储访问策略。
租赁容器 容器 针对删除操作建立并管理容器上的锁。
删除容器 容器 删除容器及它所包含的所有 Blob。
列出 Blob 容器 列出容器中的所有 Blob。
放置 Blob 块、追加和页 blob 在容器中创建新的 Blob 或替换现有的 Blob。
获取 Blob 块、追加和页 blob 从 BLOB 服务读取或下载 Blob,包括其用户定义的元数据和系统属性。
获取 Blob 属性 块、追加和页 blob 返回 Blob 中的所有系统属性和用户定义元数据。
设置 Blob 属性 块、追加和页 blob 设置为现有 Blob 定义的系统属性。
设置 Blob 过期时间 块 Blob 设置现有 Blob 的过期时间。
获取 Blob 元数据 块、追加和页 blob 检索现有 Blob 或快照的所有用户定义元数据。
设置 Blob 元数据 块、追加和页 blob 设置现有 Blob 的用户定义元数据。
获取 Blob 标记 块、追加和页 blob 检索现有 Blob 的用户定义标记。
设置 Blob 标记 块、追加和页 blob 设置构成辅助索引的现有 Blob 的用户定义标记。
按标记查找 Blob 块、追加和页 blob 按用户定义的标记列出 Blob。
删除 Blob 块 Blob、追加 Blob 和页 Blob 标记 Blob 以供删除。
取消删除 Blob 块 Blob、追加 Blob 和页 Blob 还原软删除 blob 的内容和元数据和/或所有关联的软删除快照。
Lease Blob(租用 Blob) 块、追加和页 blob 在写入和删除操作上设置和管理锁定。 要删除或写入到锁定的 Blob,客户端必须提供租约 ID。
快照 Blob 块、追加和页 blob 创建 Blob 的只读快照。
复制 Blob 块、追加和页 blob 将源 Blob 复制到此存储帐户或另一个存储帐户中的目标 Blob。
中止复制 Blob 块、追加和页 blob 中止挂起的Copy Blob 操作,并使目标 Blob 具有零长度和完整元数据。
放置块 仅块 Blob 创建新块,作为块 blob 的一部分进行提交。
从 URL 放置块 仅块 Blob 创建一个新块作为块 blob 的一部分提交,其中的内容是从 URL 中读取的。
放置块列表 仅块 Blob 通过指定构成块 blob 的块 ID 集来提交 blob。
获取阻止列表 仅块 Blob 检索作为块 Blob 一部分上载的块的列表。
查询 Blob 内容 仅块 Blob 对 blob 的内容应用一个简单的结构化查询语言 (SQL) 语句,并仅返回查询的数据子集。
设置 Blob 层 块和页 Blob 设置 blob 的层。
放置页 仅页 Blob 将一定范围的页面写入到页 Blob 中。
获取页面范围 仅页 Blob 返回页 Blob 或页 Blob 快照的有效页面范围的列表。
增量复制 Blob 仅页 Blob 将源页 blob 的快照复制到目标页 blob。 仅传输差异更改。
追加块 仅追加 Blob 将数据块写入追加 blob 的末尾。

本节内容

Blob 服务概念

对帐户的操作(BLOB 服务)

容器上的操作

Blob 上的操作

Blob 上的操作 (已启用分层命名空间的帐户)

请参阅

存储服务 REST