BlobBatchClient class

Med En BlobBatchClient kan du göra batchbaserade begäranden till Azure Storage Blob-tjänsten.

Konstruktorer

BlobBatchClient(string, PipelineLike)

Skapar en instans av BlobBatchClient.

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

Skapar en instans av BlobBatchClient.

Metoder

createBatch()

Skapar en <xref:BlobBatch>. En BlobBatch representerar en aggregerad uppsättning åtgärder på blobar.

deleteBlobs(BlobClient[], BlobDeleteOptions)

Skapa flera borttagningsåtgärder för att markera de angivna blobarna eller ögonblicksbilderna för borttagning. Observera att du måste ta bort alla ögonblicksbilder för att kunna ta bort en blob. Du kan ta bort båda samtidigt. Se information om borttagningsåtgärder. Åtgärden (underbegäran) autentiseras och auktoriseras med angiven autentiseringsuppgift. Se information om batchauktorisering för blobar.

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

Skapa flera borttagningsåtgärder för att markera de angivna blobarna eller ögonblicksbilderna för borttagning. Observera att du måste ta bort alla ögonblicksbilder för att kunna ta bort en blob. Du kan ta bort båda samtidigt. Se information om borttagningsåtgärder. Åtgärderna autentiseras och auktoriseras med angivna autentiseringsuppgifter. Se information om batchauktorisering för blobar.

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Skapa åtgärder på flera uppsättningsnivåer för att ange nivån på en blob. Åtgärden tillåts på en sidblob i ett Premium Storage-konto och på en blockblob i ett Blob Storage-konto (endast lokalt redundant lagring). Nivån för en premium-sidblob avgör tillåten storlek, IOPS och bandbredd för bloben. Blockblobens nivå avgör lagringstypen Frekvent/Lågfrekvent/Arkivlagring. Den här åtgärden uppdaterar inte blobens ETag. Se ange information om blobnivå. Åtgärden (underbegäran) autentiseras och auktoriseras med angivna autentiseringsuppgifter. Se auktoriseringsinformation för blobbatch.

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

Skapa åtgärder på flera uppsättningsnivåer för att ange nivån på en blob. Åtgärden tillåts på en sidblob i ett Premium Storage-konto och på en blockblob i ett Blob Storage-konto (endast lokalt redundant lagring). Nivån för en premium-sidblob avgör tillåten storlek, IOPS och bandbredd för bloben. Blockblobens nivå avgör lagringstypen Frekvent/Lågfrekvent/Arkivlagring. Den här åtgärden uppdaterar inte blobens ETag. Se ange information om blobnivå. Åtgärden (underbegäran) autentiseras och auktoriseras med angivna autentiseringsuppgifter. Se auktoriseringsinformation för blobbatch.

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Skicka batchbegäran som består av flera underbegäranden. Hämta blobBatchClient och annan information innan du kör kodfragmenten. blobServiceClient.getBlobBatchClient() ger blobBatchClient

Exempel på användning:

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

Exempel med ett lån:

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

Konstruktorinformation

BlobBatchClient(string, PipelineLike)

Skapar en instans av BlobBatchClient.

new BlobBatchClient(url: string, pipeline: PipelineLike)

Parametrar

url

string

En URL som pekar på Azure Storage-blobtjänsten, till exempel "https://myaccount.blob.core.windows.net". Du kan lägga till en SAS om du använder AnonymousCredential, till exempel "https://myaccount.blob.core.windows.net?sasString".

pipeline
PipelineLike

Anropa newPipeline() för att skapa en standardpipeline eller ange en anpassad pipeline.

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

Skapar en instans av BlobBatchClient.

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

Parametrar

url

string

En URL som pekar på Azure Storage-blobtjänsten, till exempel "https://myaccount.blob.core.windows.net". Du kan lägga till en SAS om du använder AnonymousCredential, till exempel "https://myaccount.blob.core.windows.net?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Till exempel AnonymousCredential, StorageSharedKeyCredential eller autentiseringsuppgifter från paketet för att autentisera @azure/identity begäranden till tjänsten. Du kan också ange ett objekt som implementerar TokenCredential-gränssnittet. Om det inte anges används AnonymousCredential.

options
StoragePipelineOptions

Alternativ för att konfigurera HTTP-pipelinen.

Metodinformation

createBatch()

Skapar en <xref:BlobBatch>. En BlobBatch representerar en aggregerad uppsättning åtgärder på blobar.

function createBatch()

Returer

deleteBlobs(BlobClient[], BlobDeleteOptions)

Skapa flera borttagningsåtgärder för att markera de angivna blobarna eller ögonblicksbilderna för borttagning. Observera att du måste ta bort alla ögonblicksbilder för att kunna ta bort en blob. Du kan ta bort båda samtidigt. Se information om borttagningsåtgärder. Åtgärden (underbegäran) autentiseras och auktoriseras med angiven autentiseringsuppgift. Se information om batchauktorisering för blobar.

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

Parametrar

blobClients

BlobClient[]

BlobClients som blobarna ska ta bort.

Returer

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

Skapa flera borttagningsåtgärder för att markera de angivna blobarna eller ögonblicksbilderna för borttagning. Observera att du måste ta bort alla ögonblicksbilder för att kunna ta bort en blob. Du kan ta bort båda samtidigt. Se information om borttagningsåtgärder. Åtgärderna autentiseras och auktoriseras med angivna autentiseringsuppgifter. Se information om batchauktorisering för blobar.

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

Parametrar

urls

string[]

URL:erna för de blobresurser som ska tas bort.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Till exempel AnonymousCredential, StorageSharedKeyCredential eller autentiseringsuppgifter från paketet för att autentisera @azure/identity begäranden till tjänsten. Du kan också ange ett -objekt som implementerar TokenCredential-gränssnittet. Om inget anges används AnonymousCredential.

Returer

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Skapa åtgärder på flera uppsättningsnivåer för att ange nivån på en blob. Åtgärden tillåts på en sidblob i ett Premium Storage-konto och på en blockblob i ett Blob Storage-konto (endast lokalt redundant lagring). Nivån för en premium-sidblob avgör tillåten storlek, IOPS och bandbredd för bloben. Blockblobens nivå avgör lagringstypen Frekvent/Lågfrekvent/Arkivlagring. Den här åtgärden uppdaterar inte blobens ETag. Se ange information om blobnivå. Åtgärden (underbegäran) autentiseras och auktoriseras med angivna autentiseringsuppgifter. Se auktoriseringsinformation för blobbatch.

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

Parametrar

blobClients

BlobClient[]

BlobClients för blobarna som ska ha en ny nivåuppsättning.

tier
AccessTier

Returer

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

Skapa åtgärder på flera uppsättningsnivåer för att ange nivån på en blob. Åtgärden tillåts på en sidblob i ett Premium Storage-konto och på en blockblob i ett Blob Storage-konto (endast lokalt redundant lagring). Nivån för en premium-sidblob avgör tillåten storlek, IOPS och bandbredd för bloben. Blockblobens nivå avgör lagringstypen Frekvent/Lågfrekvent/Arkivlagring. Den här åtgärden uppdaterar inte blobens ETag. Se ange information om blobnivå. Åtgärden (underbegäran) autentiseras och auktoriseras med angivna autentiseringsuppgifter. Se auktoriseringsinformation för blobbatch.

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

Parametrar

urls

string[]

URL:erna för blobresursen som ska tas bort.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Till exempel AnonymousCredential, StorageSharedKeyCredential eller autentiseringsuppgifter från paketet för att autentisera @azure/identity begäranden till tjänsten. Du kan också ange ett -objekt som implementerar TokenCredential-gränssnittet. Om inget anges används AnonymousCredential.

tier
AccessTier

Returer

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Skicka batchbegäran som består av flera underbegäranden. Hämta blobBatchClient och annan information innan du kör kodfragmenten. blobServiceClient.getBlobBatchClient() ger blobBatchClient

Exempel på användning:

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

Exempel med ett lån:

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)

Parametrar

batchRequest
BlobBatch

En uppsättning åtgärder för Delete eller SetTier.

Returer