BlobBatchClient class

创建 BlobBatchClient 的实例。

new BlobBatchClient(url: string, pipeline: PipelineLike)

参数

创建 BlobBatchClient 的实例。

new BlobBatchClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

参数

创建 BlobBatch。 BlobBatch 表示对 Blob 的聚合作集。

function createBatch(): BlobBatch

返回

创建多个删除作以标记要删除的指定 Blob 或快照。 请注意，若要删除 Blob，必须删除其所有快照。 可以同时删除两者。 请参阅 删除作详细信息。 作（subrequest）将通过指定的凭据进行身份验证和授权。 请参阅 blob 批处理授权详细信息。

function deleteBlobs(blobClients: BlobClient[], options?: BlobDeleteOptions): Promise<BlobBatchSubmitBatchResponse>

参数

返回

创建多个删除作以标记要删除的指定 Blob 或快照。 请注意，若要删除 Blob，必须删除其所有快照。 可以同时删除两者。 请参阅 删除作详细信息。 作将通过指定的凭据进行身份验证和授权。 请参阅 blob 批处理授权详细信息。

function deleteBlobs(urls: string[], credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: BlobDeleteOptions): Promise<BlobBatchSubmitBatchResponse>

参数

返回

创建多个集层作以设置 Blob 上的层。 该作允许在高级存储帐户中的页 Blob 和 Blob 存储帐户中的块 Blob 上（仅限本地冗余存储）。 高级页 Blob 层确定 Blob 允许的大小、IOPS 和带宽。 块 Blob 层确定热/冷/存档存储类型。 此作不会更新 Blob 的 ETag。 请参阅 设置 blob 层详细信息。 作（subrequest）将通过指定的凭据进行身份验证和授权。请参阅 blob 批处理授权详细信息。

function setBlobsAccessTier(blobClients: BlobClient[], tier: AccessTier, options?: BlobSetTierOptions): Promise<BlobBatchSubmitBatchResponse>

参数

返回

创建多个集层作以设置 Blob 上的层。 该作允许在高级存储帐户中的页 Blob 和 Blob 存储帐户中的块 Blob 上（仅限本地冗余存储）。 高级页 Blob 层确定 Blob 允许的大小、IOPS 和带宽。 块 Blob 层确定热/冷/存档存储类型。 此作不会更新 Blob 的 ETag。 请参阅 设置 blob 层详细信息。 作（subrequest）将通过指定的凭据进行身份验证和授权。请参阅 blob 批处理授权详细信息。

function setBlobsAccessTier(urls: string[], credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, tier: AccessTier, options?: BlobSetTierOptions): Promise<BlobBatchSubmitBatchResponse>

参数

返回

提交包含多个子请求的批处理请求。

在运行代码片段之前，先获取 blobBatchClient 和其他详细信息。 blobServiceClient.getBlobBatchClient() 提供 blobBatchClient

示例用法：

import { DefaultAzureCredential } from "@azure/identity";
import { BlobServiceClient, BlobBatch } from "@azure/storage-blob";

const account = "<account>";
const credential = new DefaultAzureCredential();
const blobServiceClient = new BlobServiceClient(
  `https://${account}.blob.core.windows.net`,
  credential,
);

const containerName = "<container name>";
const containerClient = blobServiceClient.getContainerClient(containerName);
const blobBatchClient = containerClient.getBlobBatchClient();

const batchRequest = new BlobBatch();
await batchRequest.deleteBlob("<blob-url-1>", credential);
await batchRequest.deleteBlob("<blob-url-2>", credential, {
  deleteSnapshots: "include",
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

使用租约的示例：

import { DefaultAzureCredential } from "@azure/identity";
import { BlobServiceClient, BlobBatch } from "@azure/storage-blob";

const account = "<account>";
const credential = new DefaultAzureCredential();
const blobServiceClient = new BlobServiceClient(
  `https://${account}.blob.core.windows.net`,
  credential,
);

const containerName = "<container name>";
const containerClient = blobServiceClient.getContainerClient(containerName);
const blobBatchClient = containerClient.getBlobBatchClient();
const blobClient = containerClient.getBlobClient("<blob name>");

const batchRequest = new BlobBatch();
await batchRequest.setBlobAccessTier(blobClient, "Cool");
await batchRequest.setBlobAccessTier(blobClient, "Cool", {
  conditions: { leaseId: "<lease-id>" },
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

请参阅 https://free.blessedness.top/rest/api/storageservices/blob-batch

function submitBatch(batchRequest: BlobBatch, options?: BlobBatchSubmitBatchOptionalParams): Promise<BlobBatchSubmitBatchResponse>

参数

返回