Delen via

BlobBatchClient class

Pakket:
@azure/storage-blob

Met een BlobBatchClient kunt u batchaanvragen indienen bij de Azure Storage Blob-service.

Constructors

BlobBatchClient(string, PipelineLike)

Hiermee maakt u een exemplaar van BlobBatchClient.
BlobBatchClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Hiermee maakt u een exemplaar van BlobBatchClient.

Methoden

createBatch()

Hiermee maakt u een <xref:BlobBatch>. Een BlobBatch vertegenwoordigt een geaggregeerde set bewerkingen op blobs.
deleteBlobs(BlobClient[], BlobDeleteOptions)

Maak meerdere verwijderbewerkingen om de opgegeven blobs of momentopnamen te markeren voor verwijdering. Als u een blob wilt verwijderen, moet u alle momentopnamen ervan verwijderen. U kunt beide tegelijk verwijderen. Zie details van de verwijderbewerking. De bewerking (subrequest) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van blobbatchautorisatie.
deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions)

Maak meerdere verwijderbewerkingen om de opgegeven blobs of momentopnamen te markeren voor verwijdering. Als u een blob wilt verwijderen, moet u alle momentopnamen ervan verwijderen. U kunt beide tegelijk verwijderen. Zie details van de verwijderbewerking. De bewerkingen worden geverifieerd en geautoriseerd met opgegeven referenties. Zie details van blobbatchautorisatie.
setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Maak meerdere setlaagbewerkingen om de laag in te stellen op een blob. De bewerking is toegestaan op een pagina-blob in een Premium Storage-account en op een blok-blob in een blobopslagaccount (alleen lokaal redundante opslag). De laag van een Premium-pagina-blob bepaalt de toegestane grootte, IOPS en bandbreedte van de blob. De laag van een blok-blob bepaalt dynamisch/statisch/archiefopslagtype. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. Zie details van de bloblaag instellen. De bewerking (subrequest) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van blobbatchautorisatie.
setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions)

Maak meerdere setlaagbewerkingen om de laag in te stellen op een blob. De bewerking is toegestaan op een pagina-blob in een Premium Storage-account en op een blok-blob in een blobopslagaccount (alleen lokaal redundante opslag). De laag van een Premium-pagina-blob bepaalt de toegestane grootte, IOPS en bandbreedte van de blob. De laag van een blok-blob bepaalt dynamisch/statisch/archiefopslagtype. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. Zie details van de bloblaag instellen. De bewerking (subrequest) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van blobbatchautorisatie.
submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Dien een batchaanvraag in die bestaat uit meerdere subaanvragen. Haal blobBatchClient en andere details op voordat u de fragmenten uitvoert. blobServiceClient.getBlobBatchClient() geeft de blobBatchClient

Voorbeeldgebruik:

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);

Voorbeeld van een lease:

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);

Constructordetails

BlobBatchClient(string, PipelineLike)

Hiermee maakt u een exemplaar van BlobBatchClient.

new BlobBatchClient(url: string, pipeline: PipelineLike)

Parameters

url

string

Een URL die verwijst naar de Azure Storage-blobservice, zoals 'https://myaccount.blob.core.windows.net". U kunt een SAS toevoegen als u AnonymousCredential gebruikt, zoals 'https://myaccount.blob.core.windows.net?sasString".

pipeline
PipelineLike

Roep newPipeline() aan om een standaardpijplijn te maken of geef een aangepaste pijplijn op.

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

Hiermee maakt u een exemplaar van BlobBatchClient.

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

Parameters

url

string

Een URL die verwijst naar de Azure Storage-blobservice, zoals 'https://myaccount.blob.core.windows.net". U kunt een SAS toevoegen als u AnonymousCredential gebruikt, zoals 'https://myaccount.blob.core.windows.net?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Zoals AnonymousCredential, StorageSharedKeyCredential of referenties van het @azure/identity-pakket om aanvragen voor de service te verifiëren. U kunt ook een object opgeven waarmee de TokenCredential-interface wordt geïmplementeerd. Als dit niet is opgegeven, wordt AnonymousCredential gebruikt.

options
StoragePipelineOptions

Opties voor het configureren van de HTTP-pijplijn.

Methodedetails

createBatch()

Hiermee maakt u een <xref:BlobBatch>. Een BlobBatch vertegenwoordigt een geaggregeerde set bewerkingen op blobs.

function createBatch()

Retouren

BlobBatch

deleteBlobs(BlobClient[], BlobDeleteOptions)

Maak meerdere verwijderbewerkingen om de opgegeven blobs of momentopnamen te markeren voor verwijdering. Als u een blob wilt verwijderen, moet u alle momentopnamen ervan verwijderen. U kunt beide tegelijk verwijderen. Zie details van de verwijderbewerking. De bewerking (subrequest) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van blobbatchautorisatie.

function deleteBlobs(blobClients: BlobClient[], options?: BlobDeleteOptions)

Parameters

blobClients

BlobClient[]

De BlobClients voor de blobs die moeten worden verwijderd.

options
BlobDeleteOptions

Retouren

Promise<BlobBatchDeleteBlobsResponse>

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

Maak meerdere verwijderbewerkingen om de opgegeven blobs of momentopnamen te markeren voor verwijdering. Als u een blob wilt verwijderen, moet u alle momentopnamen ervan verwijderen. U kunt beide tegelijk verwijderen. Zie details van de verwijderbewerking. De bewerkingen worden geverifieerd en geautoriseerd met opgegeven referenties. Zie details van blobbatchautorisatie.

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

Parameters

urls

string[]

De URL's van de blob-resources die u wilt verwijderen.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Zoals AnonymousCredential, StorageSharedKeyCredential of referenties van het @azure/identity-pakket om aanvragen voor de service te verifiëren. U kunt ook een object opgeven waarmee de TokenCredential-interface wordt geïmplementeerd. Als dit niet is opgegeven, wordt AnonymousCredential gebruikt.

options
BlobDeleteOptions

Retouren

Promise<BlobBatchDeleteBlobsResponse>

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Maak meerdere setlaagbewerkingen om de laag in te stellen op een blob. De bewerking is toegestaan op een pagina-blob in een Premium Storage-account en op een blok-blob in een blobopslagaccount (alleen lokaal redundante opslag). De laag van een Premium-pagina-blob bepaalt de toegestane grootte, IOPS en bandbreedte van de blob. De laag van een blok-blob bepaalt dynamisch/statisch/archiefopslagtype. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. Zie details van de bloblaag instellen. De bewerking (subrequest) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van blobbatchautorisatie.

function setBlobsAccessTier(blobClients: BlobClient[], tier: AccessTier, options?: BlobSetTierOptions)

Parameters

blobClients

BlobClient[]

De BlobClients voor de blobs waarvoor een nieuwe laag moet zijn ingesteld.

tier
AccessTier
options
BlobSetTierOptions

Retouren

Promise<BlobBatchSetBlobsAccessTierResponse>

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

Maak meerdere setlaagbewerkingen om de laag in te stellen op een blob. De bewerking is toegestaan op een pagina-blob in een Premium Storage-account en op een blok-blob in een blobopslagaccount (alleen lokaal redundante opslag). De laag van een Premium-pagina-blob bepaalt de toegestane grootte, IOPS en bandbreedte van de blob. De laag van een blok-blob bepaalt dynamisch/statisch/archiefopslagtype. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. Zie details van de bloblaag instellen. De bewerking (subrequest) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van blobbatchautorisatie.

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

Parameters

urls

string[]

De URL's van de blobresource die u wilt verwijderen.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Zoals AnonymousCredential, StorageSharedKeyCredential of referenties van het @azure/identity-pakket om aanvragen voor de service te verifiëren. U kunt ook een object opgeven waarmee de TokenCredential-interface wordt geïmplementeerd. Als dit niet is opgegeven, wordt AnonymousCredential gebruikt.

tier
AccessTier
options
BlobSetTierOptions

Retouren

Promise<BlobBatchSetBlobsAccessTierResponse>

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Dien een batchaanvraag in die bestaat uit meerdere subaanvragen. Haal blobBatchClient en andere details op voordat u de fragmenten uitvoert. blobServiceClient.getBlobBatchClient() geeft de blobBatchClient

Voorbeeldgebruik:

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);

Voorbeeld van een lease:

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);

function submitBatch(batchRequest: BlobBatch, options?: BlobBatchSubmitBatchOptionalParams)

Parameters

batchRequest
BlobBatch

Een set bewerkingen verwijderen of instellen.

options
BlobBatchSubmitBatchOptionalParams

Retouren

Promise<BlobBatchSubmitBatchResponse>