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

追加 Blob 印章

该操作的目的是 Append Blob Seal 允许用户和应用程序密封追加 Blob，并将其标记为只读。 本文档概述了此功能的建议 REST API 规范。

请求

可以按如下所示构造 Append Blob Seal 请求。 建议使用 HTTPS。 将 myaccount 替换为存储帐户的名称。

PUT 方法请求 URI	HTTP 版本
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=seal	HTTP/1.1

标头

Append Blob Seal返回常见的 API 标头， ETag/LMT (上次修改时间) 、x-ms-request-id、x-ms-versioncontent-length、 和 。Date Append Blob Seal 不会更改 ETag/LMT。

响应头	值	说明
x-ms-blob-sealed	true/false	可选。 默认值为 False。 如果 blob 已密封，则当你密封并获取 Blob 的属性时，此标头将包含在响应中。 对于追加 Blob，此标头应出现在 GetBlob、 GetBlobProperties、 AppendBlobSeal和 ListBlobs 中。

查询参数

没有其他 URI 参数。

请求正文

无。

响应

响应包括 HTTP 状态代码和响应标头列表。

状态代码

你可能会收到以下任何状态代码：

• 200 (成功) ：Blob 已密封。 调用是幂等的，如果 Blob 已密封，则调用将成功。

• 409 (InvalidBlobType) ：如果调用位于现有页 Blob 或块 Blob 上，则服务返回此状态代码。

• 404 (BlobNotFound) ：如果调用在不存在的 blob 上，则服务返回此状态代码。

授权

在 Azure 存储中调用任何数据访问操作时，都需要授权。 可以授权操作， Append Blob Seal 如下所述。

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用户、组或服务主体调用Append Blob Seal操作所需的 RBAC 操作，以及包含此操作的最小特权内置 Azure RBAC 角色：

• Azure RBAC 操作：Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
• 最低特权内置角色：存储 Blob 数据参与者

若要详细了解如何使用 Azure RBAC 分配角色，请参阅 分配 Azure 角色以访问 Blob 数据。

共享访问签名 (SAS)

共享访问签名 (SAS) 提供对存储帐户中资源的安全委派访问。 使用 SAS，可以精细控制客户端访问数据的方式。 可以指定客户端可以访问的资源、它们对这些资源拥有的权限，以及 SAS 的有效期。

该 Append Blob Seal 操作支持三种类型的共享访问签名： 用户委派 SAS、 服务 SAS 和 帐户 SAS。

作为安全最佳做法，我们建议使用Microsoft Entra凭据而不是存储帐户密钥，这可能会更容易泄露。 如果应用程序设计需要共享访问签名，请尽可能使用Microsoft Entra凭据创建用户委托 SAS。

如果存储帐户不允许共享密钥访问，则对 Blob 存储的请求不允许使用服务 SAS 令牌或帐户 SAS 令牌。 若要了解详细信息，请参阅 了解不允许共享密钥如何影响 SAS 令牌。

用户委托 SAS

用户委托 SAS 使用Microsoft Entra凭据以及为 SAS 指定的权限进行保护。

Append Blob Seal使用委托给容器或 Blob 资源的 SAS 令牌调用操作需要具有写入 () 权限，作为用户委托 SAS 令牌的一部分。

若要详细了解用户委托 SAS，请参阅 创建用户委托 SAS。

服务 SAS

使用存储帐户密钥保护的服务 SAS。 服务 SAS 委托对单个 Azure 存储服务（例如 Blob 存储）中的资源的访问权限。

Append Blob Seal使用委托给容器或 Blob 资源的 SAS 令牌调用操作需要具有写入 (权限，) 权限作为服务 SAS 令牌的一部分。

若要了解有关服务 SAS 的详细信息，请参阅 创建服务 SAS。

帐户 SAS

帐户 SAS 使用存储帐户密钥进行保护。 帐户 SAS 可委派对一个或多个存储服务中的资源的访问权限。 通过服务或用户委托 SAS 提供的所有操作也可以通过帐户 SAS 提供。

下表指示在委派访问权限时要指定的已签名资源类型和已签名权限：

操作	已签名服务	已签名的资源类型	已签名的权限
追加 Blob 印章	Blob (b)	对象 (o)	使用) 编写 (

若要了解有关帐户 SAS 的详细信息，请参阅 创建帐户 SAS。

共享密钥

操作 Append Blob Seal 支持 共享密钥授权。 在大多数情况下，不建议使用帐户密钥进行授权，因为它不太安全。

Microsoft 建议尽可能禁止对存储帐户进行共享密钥授权。 有关详细信息，请参阅阻止通过共享密钥进行授权。

注解

如果追加 Blob 具有租约，则需要租约 ID 来密封 Blob。

密封 Blob 后，仍可以更新属性、Blob 索引标记和元数据。 软删除密封的 Blob 会保留密封状态。 可以覆盖密封的 Blob。  

如果获取密封 blob 的快照，则快照包括密封标志。 对于新版本中的现有快照，Microsoft 返回 属性。

复制密封的 Blob 时，默认情况下会传播密封标志。 公开允许覆盖标志的标头。

新的 XML 元素将添加到响应中 ListBlob ，名为 Sealed。 值可以是 true 或 false。

如果对已密封的 Blob 调用 AppendBlock ，该服务将返回下表中显示的错误消息。 这适用于旧版 API。

错误代码	HTTP 状态代码	用户消息
BlobIsSealed	冲突 (409)	指定的 Blob 已密封，除非在删除后重新创建 Blob，否则无法修改其内容。

如果调用 Append Blob Seal 已密封的追加 blob，则只会看到状态代码 200 (成功) 。

计费

定价请求可以源自使用 Blob 存储 API 的客户端，可以直接通过 Blob 存储 REST API 或 Azure 存储客户端库。 这些请求按事务产生费用。 事务类型会影响帐户的计费方式。 例如，读取事务应计为与写入事务不同的计费类别。 下表显示了基于存储帐户类型的请求的计费类别 Append Blob Seal ：

操作	存储帐户类型	计费类别
追加 Blob 密封	高级块 blob 标准常规用途 v2 标准常规用途 v1	写入操作

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

另请参阅

Azure Blob 存储错误代码