你当前正在访问 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 包括下表中列出的操作。
| 操作 | 资源类型 | 说明 |
|---|---|---|
| 列出容器 | 帐户 | 列出存储帐户中的所有容器。 |
| 设置 Blob 存储属性 | 帐户 | 设置 Blob 存储的属性，包括日志记录和指标设置，以及默认服务版本。 |
| 获取 Blob 存储属性 | 帐户 | 获取属性 Blob 存储，包括日志记录和指标设置，以及默认服务版本。 |
| 预检 Blob 请求 | 帐户 | 在发送实际请求之前，查询 Blob 存储的跨域资源共享 (CORS) 规则。 |
| 获取 Blob 存储统计信息 | 帐户 | 检索与 Blob 存储的复制相关的统计信息。 仅在为存储帐户启用了读访问的地域冗余复制时，才能在辅助位置的终结点上使用此操作。 |
| 获取帐户信息 | 帐户 | 返回指定帐户的 SKU 名称和帐户类型。 |
| 获取用户委派密钥 | 帐户 | 获取可用于对用户委派共享访问签名进行签名的密钥。 此签名通过使用Microsoft Entra凭据授予对 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 | 按用户定义的标记Lists 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 的末尾。 |