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

Blob Batch

项目
03/05/2024

此操作 Blob Batch 允许将多个 API 调用嵌入到单个 HTTP 请求中。此 API 支持两种类型的子请求：为块 Blob 设置 Blob 层和删除 Blob。服务器为批处理请求返回的响应包含批处理中每个子请求的结果。批处理请求和响应使用批处理规范的 OData 语法，并修改语义。此 API 从版本 2018-11-09 开始可用。

请求

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

方法	请求 URI	HTTP 版本
`POST`	`https://myaccount.blob.core.windows.net/?comp=batch` `https://myaccount.blob.core.windows.net/containername?restype=container&comp=batch`	HTTP/1.1

URI 参数

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

参数	说明
`timeout`	可选。 timeout 参数以秒表示，最大值为 120 秒。有关详细信息，请参阅设置 Blob 存储操作的超时。
`restype`	可选版本 2020-04-08 及更高版本。参数支持 `restype` 的唯一值是 `container`。指定此参数时，URI 必须包含容器名称。任何子请求都必须限定为同一容器。

请求标头

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

请求标头	说明
`Authorization`	必需。指定授权方案、存储帐户名称和签名。有关详细信息，请参阅授权对 Azure 存储的请求。
`Date` 或 `x-ms-date`	必需。指定请求的协调世界时 (UTC)。有关详细信息，请参阅授权对 Azure 存储的请求。
`x-ms-version`	对于所有已授权的请求是必需的。指定用于此请求的操作的版本。此版本将用于所有子请求。有关详细信息，请参阅 Azure 存储服务的版本控制。
`Content-Length`	必需。请求的长度。
`Content-Type`	必需。此标头的值必须是 `multipart/mixed`，具有批处理边界。示例标头值： `multipart/mixed; boundary=batch_a81786c8-e301-4e42-a729-a32ca24ae252`。
`x-ms-client-request-id`	可选。提供客户端生成的不透明值，其中包含 1-kiB (KiB) 配置日志记录时记录在日志中的字符限制。强烈建议使用此标头将客户端活动与服务器接收的请求相关联。有关详细信息，请参阅监视Azure Blob 存储。

请求正文

Blob 批处理的请求正文包含所有子请求的列表。格式使用批处理规范的 OData 语法，并修改语义。

请求正文以批处理边界开头，后跟两个必需标头： Content-Type 值为 application/http的标头和 Content-Transfer-Encoding 值为 binary的标头。后跟一个可选 Content-ID 标头，其中包含用于跟踪每个子请求的字符串值。响应包含 Content-ID 要用于跟踪的每个相应子请求响应的标头。

这些请求标头后跟一个必需的空行，然后是每个子请求的定义。每个子请求的正文是一个完整的 HTTP 请求，其中包含请求所需的谓词、URL、标头和正文。请注意以下注意事项：

子请求不应具有 x-ms-version header。所有子请求都使用顶级批处理请求版本运行。
子请求 URL 应仅具有 URL (的路径，而主机) 。
每个批处理请求最多支持 256 个子请求。
所有子请求都必须具有相同的请求类型。
每个子请求都单独授权，并在子请求中提供的信息。
请求正文中的每一行都应以 \r\n 个字符结尾。

示例请求

POST http://account.blob.core.windows.net/?comp=batch HTTP/1.1 
Content-Type: multipart/mixed; boundary=batch_357de4f7-6d0b-4e02-8cd2-6361411a9525 
x-ms-version: 2018-11-09 
Authorization: SharedKey account:QvaoYDQ+0VcaA/hKFjUmQmIxXv2RT3XwwTsOTHL39HI=
Host: 127.0.0.1:10000 
Content-Length: 1569 

--batch_357de4f7-6d0b-4e02-8cd2-6361411a9525 
Content-Type: application/http 
Content-Transfer-Encoding: binary 
Content-ID: 0 

DELETE /container0/blob0 HTTP/1.1 
x-ms-date: Thu, 14 Jun 2018 16:46:54 GMT 
Authorization: SharedKey account:G4jjBXA7LI/RnWKIOQ8i9xH4p76pAQ+4Fs4R1VxasaE= 
Content-Length: 0 

--batch_357de4f7-6d0b-4e02-8cd2-6361411a9525 
Content-Type: application/http 
Content-Transfer-Encoding: binary 
Content-ID: 1 

DELETE /container1/blob1 HTTP/1.1 
x-ms-date: Thu, 14 Jun 2018 16:46:54 GMT 
Authorization: SharedKey account:IvCoYDQ+0VcaA/hKFjUmQmIxXv2RT3XwwTsOTHL39HI= 
Content-Length: 0 

--batch_357de4f7-6d0b-4e02-8cd2-6361411a9525 
Content-Type: application/http 
Content-Transfer-Encoding: binary 
Content-ID: 2 

DELETE /container2/blob2 HTTP/1.1 
x-ms-date: Thu, 14 Jun 2018 16:46:54 GMT 
Authorization: SharedKey account:S37N2JTjcmOQVLHLbDmp2johz+KpTJvKhbVc4M7+UqI= 
Content-Length: 0 

--batch_357de4f7-6d0b-4e02-8cd2-6361411a9525--

响应

响应包括 HTTP 状态代码和顶级批处理请求的一组响应标头。响应还包括其所有子请求的响应信息。

响应正文

批处理响应是一个 multipart/mixed 响应，其中包含每个子请求的响应。响应是分块的。每个子响应都以 Content-Type: application/http 标头开头。 Content-ID如果请求中提供了标头，则标头如下所示。随后是 HTTP 响应状态代码和每个子请求的响应标头。

有关每个子请求返回的标头的信息，请参阅删除 Blob 和设置 Blob 层操作的文档。

示例响应

HTTP/1.1 202 Accepted 
Transfer-Encoding: chunked 
Content-Type: multipart/mixed; boundary=batchresponse_66925647-d0cb-4109-b6d3-28efe3e1e5ed 
x-ms-request-id: 778fdc83-801e-0000-62ff-033467000000 
x-ms-version: 2018-11-09 

409
--batchresponse_66925647-d0cb-4109-b6d3-28efe3e1e5ed 
Content-Type: application/http 
Content-ID: 0 

HTTP/1.1 202 Accepted 
x-ms-delete-type-permanent: true
x-ms-request-id: 778fdc83-801e-0000-62ff-0334671e284f 
x-ms-version: 2018-11-09 

--batchresponse_66925647-d0cb-4109-b6d3-28efe3e1e5ed 
Content-Type: application/http 
Content-ID: 1 

HTTP/1.1 202 Accepted 
x-ms-delete-type-permanent: true
x-ms-request-id: 778fdc83-801e-0000-62ff-0334671e2851 
x-ms-version: 2018-11-09 

--batchresponse_66925647-d0cb-4109-b6d3-28efe3e1e5ed 
Content-Type: application/http 
Content-ID: 2 

HTTP/1.1 404 The specified blob does not exist. 
x-ms-error-code: BlobNotFound 
x-ms-request-id: 778fdc83-801e-0000-62ff-0334671e2852 
x-ms-version: 2018-11-09 
Content-Length: 216 
Content-Type: application/xml 

<?xml version="1.0" encoding="utf-8"?> 
<Error><Code>BlobNotFound</Code><Message>The specified blob does not exist. 
RequestId:778fdc83-801e-0000-62ff-0334671e2852 
Time:2018-06-14T16:46:54.6040685Z</Message></Error> 
--batchresponse_66925647-d0cb-4109-b6d3-28efe3e1e5ed-- 
0

状态代码

如果批处理请求格式正确且已授权，则操作返回状态代码 202 (“已接受”) 。每个子请求都有自己的响应，具体取决于操作的结果。子请求状态在响应正文中返回。

有关详细信息，请参阅状态和错误代码。

响应头

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

授权

省略时 restype=container ，必须使用共享密钥授权父批处理请求。可以使用帐户访问密钥、帐户共享访问签名或 Azure Active Directory。有关特定授权机制的详细信息，如下所示。

请求中包含时 restype=container ，可以通过共享密钥或 Azure Active Directory 授权父批处理请求。还可以使用由其中任一授权机制签名的共享访问签名进行授权。有关特定授权机制的详细信息，如下所示。

每个子请求单独授权。当子请求不是批处理操作的一部分时，子请求支持该操作所支持的相同授权机制。

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用户、组或服务主体发出Blob Batch父请求所需的 RBAC 操作，以及包含此操作的最低特权内置 Azure RBAC 角色：

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

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

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

父 Blob Batch 请求支持以下方案的共享访问签名：

省略时restype=container：支持帐户 SAS
请求restype=container中包含时：支持用户委派 SAS、服务 SAS 和帐户 SAS

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

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

用户委托 SAS

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

Blob Batch使用委托给容器或 Blob 资源的 SAS 令牌的父请求需要写入 () 权限作为用户委派 SAS 令牌的一部分。

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

服务 SAS

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

Blob Batch使用委托给容器或 Blob 资源的 SAS 令牌的父请求需要写入 () 权限作为服务 SAS 令牌的一部分。

若要详细了解服务 SAS，请参阅创建服务 SAS。

帐户 SAS

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

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

操作	已签名服务	已签名资源类型	已签名权限
Blob Batch (父请求)	Blob (b)	对象 (o)	使用) 编写 (

若要详细了解帐户 SAS，请参阅创建帐户 SAS。

计费

Blob Batch REST 请求计为一个事务，每个单独的子请求也计为一个事务。若要详细了解各个子请求的计费，请参阅删除 Blob 和设置 Blob 层操作的文档。

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

操作	存储帐户类型	计费类别
Blob 批处理 (设置 Blob 层)	高级块 blob 标准常规用途 v2	其他操作

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

注解

使用批处理请求main好处之一是减少了客户端必须打开的连接数。请注意以下限制：

批处理中支持的子请求 (Set Blob Tier 块 blob) 和 Delete Blob。
在单个批处理中最多仅支持 256 个子请求。批处理请求的正文大小不能超过 4 MB。
空批处理请求失败，代码为 400 (错误的请求) 。
无法保证批处理子请求的执行顺序。
Batch 子请求执行不是原子的。每个子请求独立运行。
每个子请求都必须针对同一存储帐户中的资源。单个批处理请求不支持从不同存储帐户运行请求。
不支持嵌套请求正文。
如果服务器无法分析请求正文，则整个批处理会失败，并且不会运行任何请求。
请注意，当批处理不使用 restype=container时，帐户 SAS 是唯一Blob Batch支持的共享访问签名类型。

将所有子请求范围限定为特定容器

从 REST 版本 2020-04-08 开始， Blob Batch API 支持将子请求的范围限定为指定容器。当请求 URI 包含容器名称和参数时 restype=container ，每个子请求都必须应用于同一容器。如果为子请求指定的容器名称与 URI 中提供的容器名称不匹配，则服务将返回错误代码 400 (错误的请求) 。

容器支持的所有授权机制对于范围限定为 Blob Batch 容器的操作都有效。每个子请求都会向服务发送一个授权标头。

另请参阅

授权对 Azure 存储状态和错误代码的请求 Blob 存储错误代码设置 Blob 存储操作的超时