Compartilhar via

BlobBatchClient class

  • Referência
Pacote:
@azure/storage-blob

Um BlobBatchClient permite que você faça solicitações em lote para o serviço de Blob de Armazenamento do Azure.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch

Construtores

BlobBatchClient(string, PipelineLike)

Cria uma instância de BlobBatchClient.
BlobBatchClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Cria uma instância de BlobBatchClient.

Métodos

createBatch()

Cria um BlobBatch. Um BlobBatch representa um conjunto agregado de operações em blobs.
deleteBlobs(BlobClient[], BlobDeleteOptions)

Crie várias operações de exclusão para marcar os blobs ou instantâneos especificados para exclusão. Observe que para excluir um blob, você deve excluir todos os seus instantâneos. Você pode excluir ambos ao mesmo tempo. Confira os detalhes da operação de exclusão. A operação(subrequest) será autenticada e autorizada com a credencial especificada. Confira os detalhes de autorização do lote de blobs.
deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions)

Crie várias operações de exclusão para marcar os blobs ou instantâneos especificados para exclusão. Observe que para excluir um blob, você deve excluir todos os seus instantâneos. Você pode excluir ambos ao mesmo tempo. Confira os detalhes da operação de exclusão. As operações serão autenticadas e autorizadas com a credencial especificada. Confira os detalhes de autorização do lote de blobs.
setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Crie várias operações de camada de conjunto para definir a camada em um blob. A operação é permitida em um blob de páginas em uma conta de armazenamento premium e em um blob de blocos em uma conta de armazenamento de blobs (somente armazenamento com redundância local). A camada de um blob de páginas premium determina o tamanho, o IOPS e a largura de banda permitidos do blob. A camada de um blob de blocos determina o tipo de armazenamento Frequente/Esporádico/Arquivo Morto. Essa operação não atualiza a ETag do blob. Confira definir detalhes da camada de blob. A operação(subrequest) será autenticada e autorizada com a credencial especificada. Confira os detalhes de autorização do lote de blobs.
setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions)

Crie várias operações de camada de conjunto para definir a camada em um blob. A operação é permitida em um blob de páginas em uma conta de armazenamento premium e em um blob de blocos em uma conta de armazenamento de blobs (somente armazenamento com redundância local). A camada de um blob de páginas premium determina o tamanho, o IOPS e a largura de banda permitidos do blob. A camada de um blob de blocos determina o tipo de armazenamento Frequente/Esporádico/Arquivo Morto. Essa operação não atualiza a ETag do blob. Confira definir detalhes da camada de blob. A operação(subrequest) será autenticada e autorizada com a credencial especificada. Confira os detalhes de autorização do lote de blobs.
submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Enviar solicitação em lote que consiste em várias sub-solicitações.

Obtenha blobBatchClient e outros detalhes antes de executar os snippets. blobServiceClient.getBlobBatchClient() dá o blobBatchClient

Exemplo de uso:

let batchRequest = new BlobBatch();
await batchRequest.deleteBlob(urlInString0, credential0);
await batchRequest.deleteBlob(urlInString1, credential1, {
 deleteSnapshots: "include"
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

Exemplo usando uma concessão:

let batchRequest = new BlobBatch();
await batchRequest.setBlobAccessTier(blockBlobClient0, "Cool");
await batchRequest.setBlobAccessTier(blockBlobClient1, "Cool", {
 conditions: { leaseId: leaseId }
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

Veja https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch

Detalhes do construtor

BlobBatchClient(string, PipelineLike)

Cria uma instância de BlobBatchClient.

new BlobBatchClient(url: string, pipeline: PipelineLike)

Parâmetros

url

string

Uma URL que aponta para o serviço de blob do Armazenamento do Azure, como "https://myaccount.blob.core.windows.net". Você pode acrescentar uma SAS se estiver usando AnonymousCredential, como "https://myaccount.blob.core.windows.net?sasString".

pipeline
PipelineLike

Chame newPipeline() para criar um pipeline padrão ou forneça um pipeline personalizado.

BlobBatchClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Cria uma instância de BlobBatchClient.

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

Parâmetros

url

string

Uma URL que aponta para o serviço de blob do Armazenamento do Azure, como "https://myaccount.blob.core.windows.net". Você pode acrescentar uma SAS se estiver usando AnonymousCredential, como "https://myaccount.blob.core.windows.net?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do @azure/identity pacote para autenticar solicitações para o serviço. Você também pode fornecer um objeto que implementa a interface TokenCredential. Se não for especificado, AnonymousCredential será usado.

options
StoragePipelineOptions

Opções para configurar o pipeline HTTP.

Detalhes do método

createBatch()

Cria um BlobBatch. Um BlobBatch representa um conjunto agregado de operações em blobs.

function createBatch(): BlobBatch

Retornos

BlobBatch

deleteBlobs(BlobClient[], BlobDeleteOptions)

Crie várias operações de exclusão para marcar os blobs ou instantâneos especificados para exclusão. Observe que para excluir um blob, você deve excluir todos os seus instantâneos. Você pode excluir ambos ao mesmo tempo. Confira os detalhes da operação de exclusão. A operação(subrequest) será autenticada e autorizada com a credencial especificada. Confira os detalhes de autorização do lote de blobs.

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

Parâmetros

blobClients

BlobClient[]

Os BlobClients para os blobs a serem excluídos.

options
BlobDeleteOptions

Retornos

Promise<BlobBatchSubmitBatchResponse>

deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions)

Crie várias operações de exclusão para marcar os blobs ou instantâneos especificados para exclusão. Observe que para excluir um blob, você deve excluir todos os seus instantâneos. Você pode excluir ambos ao mesmo tempo. Confira os detalhes da operação de exclusão. As operações serão autenticadas e autorizadas com a credencial especificada. Confira os detalhes de autorização do lote de blobs.

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

Parâmetros

urls

string[]

As URLs dos recursos de blob a serem excluídos.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do @azure/identity pacote para autenticar solicitações para o serviço. Você também pode fornecer um objeto que implementa a interface TokenCredential. Se não for especificado, AnonymousCredential será usado.

options
BlobDeleteOptions

Retornos

Promise<BlobBatchSubmitBatchResponse>

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Crie várias operações de camada de conjunto para definir a camada em um blob. A operação é permitida em um blob de páginas em uma conta de armazenamento premium e em um blob de blocos em uma conta de armazenamento de blobs (somente armazenamento com redundância local). A camada de um blob de páginas premium determina o tamanho, o IOPS e a largura de banda permitidos do blob. A camada de um blob de blocos determina o tipo de armazenamento Frequente/Esporádico/Arquivo Morto. Essa operação não atualiza a ETag do blob. Confira definir detalhes da camada de blob. A operação(subrequest) será autenticada e autorizada com a credencial especificada. Confira os detalhes de autorização do lote de blobs.

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

Parâmetros

blobClients

BlobClient[]

Os BlobClients para os blobs que devem ter uma nova camada definida.

tier
AccessTier
options
BlobSetTierOptions

Retornos

Promise<BlobBatchSubmitBatchResponse>

setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions)

Crie várias operações de camada de conjunto para definir a camada em um blob. A operação é permitida em um blob de páginas em uma conta de armazenamento premium e em um blob de blocos em uma conta de armazenamento de blobs (somente armazenamento com redundância local). A camada de um blob de páginas premium determina o tamanho, o IOPS e a largura de banda permitidos do blob. A camada de um blob de blocos determina o tipo de armazenamento Frequente/Esporádico/Arquivo Morto. Essa operação não atualiza a ETag do blob. Confira definir detalhes da camada de blob. A operação(subrequest) será autenticada e autorizada com a credencial especificada. Confira os detalhes de autorização do lote de blobs.

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

Parâmetros

urls

string[]

As URLs do recurso de blob a ser excluído.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do @azure/identity pacote para autenticar solicitações para o serviço. Você também pode fornecer um objeto que implementa a interface TokenCredential. Se não for especificado, AnonymousCredential será usado.

tier
AccessTier
options
BlobSetTierOptions

Retornos

Promise<BlobBatchSubmitBatchResponse>

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Enviar solicitação em lote que consiste em várias sub-solicitações.

Obtenha blobBatchClient e outros detalhes antes de executar os snippets. blobServiceClient.getBlobBatchClient() dá o blobBatchClient

Exemplo de uso:

let batchRequest = new BlobBatch();
await batchRequest.deleteBlob(urlInString0, credential0);
await batchRequest.deleteBlob(urlInString1, credential1, {
 deleteSnapshots: "include"
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

Exemplo usando uma concessão:

let batchRequest = new BlobBatch();
await batchRequest.setBlobAccessTier(blockBlobClient0, "Cool");
await batchRequest.setBlobAccessTier(blockBlobClient1, "Cool", {
 conditions: { leaseId: leaseId }
});
const batchResp = await blobBatchClient.submitBatch(batchRequest);
console.log(batchResp.subResponsesSucceededCount);

Veja https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch

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

Parâmetros

batchRequest
BlobBatch

Um conjunto de operações Delete ou SetTier.

options
BlobBatchSubmitBatchOptionalParams

Retornos

Promise<BlobBatchSubmitBatchResponse>