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

Azure Blob Storage REST API(Azure blob 存储 REST API)

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

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

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

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

  • 页 Blob,针对随机读/写操作进行优化,并且能够写入 Blob 中的字节范围。

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

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

Operation 资源类型 说明
列出容器 帐户 列出存储帐户中的所有容器。
设置 Blob 存储属性 帐户 设置 Blob 存储的属性,包括日志记录和指标设置,以及默认服务版本。
获取 Blob 存储属性 帐户 获取属性 Blob 存储,包括日志记录和指标设置,以及默认服务版本。
预检 Blob 请求 帐户 在发送实际请求之前,查询 Blob 存储的跨域资源共享 (CORS) 规则。
获取 Blob 存储统计信息 帐户 检索与 Blob 存储的复制相关的统计信息。 仅在为存储帐户启用了读访问的地域冗余复制时,才能在辅助位置的终结点上使用此操作。
获取帐户信息 帐户 返回指定帐户的 SKU 名称和帐户类型。
获取用户委派密钥 帐户 获取可用于对用户委派共享访问签名进行签名的密钥。 此签名使用 Azure Active Directory (Azure AD) 凭据授予对 Blob 存储中的资源的访问权限。
创建容器 容器 在存储帐户中新建一个容器。
获取容器属性 容器 返回容器的所有用户定义的元数据和系统属性。
获取容器元数据 容器 仅返回容器的用户定义的元数据。
设置容器元数据 容器 设置容器的用户定义元数据。
获取容器 ACL 容器 为容器获取公共访问策略和任何存储访问策略。
Set Container ACL 容器 为容器设置公共访问策略和任何存储访问策略。
Lease Container(租赁容器) 容器 针对删除操作建立并管理容器上的锁。
删除容器 容器 删除容器及它所包含的所有 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,客户端必须提供租约 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