Delen via

BlobBatchClient class

  • Referentie
Pakket:
@azure/storage-blob

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

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

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 BlobBatch. Een BlobBatch vertegenwoordigt een geaggregeerde set bewerkingen op blobs.
deleteBlobs(BlobClient[], BlobDeleteOptions)

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

Maak meerdere verwijderingsbewerkingen om de opgegeven blobs of momentopnamen te markeren voor verwijdering. Als u een blob wilt verwijderen, moet u alle momentopnamen verwijderen. U kunt beide tegelijk verwijderen. Zie Details van verwijderbewerking. De bewerkingen worden geverifieerd en geautoriseerd met de opgegeven referenties. Zie details van de 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-opslagaccount en op een blok-blob in een blob-opslagaccount (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 het opslagtype Dynamisch/Statisch/Archief. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. Zie Details van bloblaag instellen. De bewerking (subaanvraag) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van de 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-opslagaccount en op een blok-blob in een blob-opslagaccount (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 het opslagtype Dynamisch/Statisch/Archief. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. Zie Details van bloblaag instellen. De bewerking (subaanvraag) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van de blobbatchautorisatie.
submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Dien een batchaanvraag in die uit meerdere subaanvragen bestaat.

Haal blobBatchClient en andere details op voordat u de fragmenten uitvoert. blobServiceClient.getBlobBatchClient() geeft de blobBatchClient

Gebruiksvoorbeeld:

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

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

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 een aangepaste pijplijn op te geven.

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 een referentie uit het @azure/identity pakket om aanvragen voor de service te verifiëren. U kunt ook een -object opgeven waarmee de interface TokenCredential 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 BlobBatch. Een BlobBatch vertegenwoordigt een geaggregeerde set bewerkingen op blobs.

function createBatch(): BlobBatch

Retouren

BlobBatch

deleteBlobs(BlobClient[], BlobDeleteOptions)

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

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

Parameters

blobClients

BlobClient[]

De BlobClients voor de blobs die moeten worden verwijderd.

options
BlobDeleteOptions

Retouren

Promise<BlobBatchSubmitBatchResponse>

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

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

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

Parameters

urls

string[]

De URL's van de blobresources die moeten worden verwijderd.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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

options
BlobDeleteOptions

Retouren

Promise<BlobBatchSubmitBatchResponse>

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-opslagaccount en op een blok-blob in een blob-opslagaccount (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 het opslagtype Dynamisch/Statisch/Archief. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. Zie Details van bloblaag instellen. De bewerking (subaanvraag) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van de blobbatchautorisatie.

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

Parameters

blobClients

BlobClient[]

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

tier
AccessTier
options
BlobSetTierOptions

Retouren

Promise<BlobBatchSubmitBatchResponse>

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-opslagaccount en op een blok-blob in een blob-opslagaccount (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 het opslagtype Dynamisch/Statisch/Archief. Met deze bewerking wordt de ETag van de blob niet bijgewerkt. Zie Details van bloblaag instellen. De bewerking (subaanvraag) wordt geverifieerd en geautoriseerd met de opgegeven referentie. Zie details van de blobbatchautorisatie.

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

Parameters

urls

string[]

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

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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

tier
AccessTier
options
BlobSetTierOptions

Retouren

Promise<BlobBatchSubmitBatchResponse>

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Dien een batchaanvraag in die uit meerdere subaanvragen bestaat.

Haal blobBatchClient en andere details op voordat u de fragmenten uitvoert. blobServiceClient.getBlobBatchClient() geeft de blobBatchClient

Gebruiksvoorbeeld:

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

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

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

Parameters

batchRequest
BlobBatch

Een set delete- of SetTier-bewerkingen.

options
BlobBatchSubmitBatchOptionalParams

Retouren

Promise<BlobBatchSubmitBatchResponse>