Megosztás a következőn keresztül:


BlobBatchClient class

A BlobBatchClient lehetővé teszi, hogy kötegelt kéréseket küldjön az Azure Storage Blob szolgáltatásnak.

Lásd: https://learn.microsoft.com/rest/api/storageservices/blob-batch

Konstruktorok

BlobBatchClient(string, PipelineLike)

Létrehozza a BlobBatchClient egy példányát.

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

Létrehozza a BlobBatchClient egy példányát.

Metódusok

createBatch()

Létrehoz egy BlobBatch. A BlobBatch a blobokon végzett műveletek összesített készletét jelöli.

deleteBlobs(BlobClient[], BlobDeleteOptions)

Több törlési művelet létrehozása a megadott blobok vagy pillanatképek megjelöléséhez a törléshez. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. Egyszerre mindkettő törölhető. Lásd törlési művelet részleteit. A művelet (subrequest) hitelesítése és engedélyezése meghatározott hitelesítő adatokkal történik. Lásd blob köteg-engedélyezési adatait.

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

Több törlési művelet létrehozása a megadott blobok vagy pillanatképek megjelöléséhez a törléshez. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. Egyszerre mindkettő törölhető. Lásd törlési művelet részleteit. A műveletek hitelesítése és engedélyezése meghatározott hitelesítő adatokkal történik. Lásd blob köteg-engedélyezési adatait.

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Hozzon létre több csoportszintű műveletet a réteg blobon való beállításához. A művelet engedélyezett egy prémium szintű tárfiók lapblobján és egy blobtároló fiók blokkblobján (csak helyileg redundáns tárolás esetén). A prémium szintű lapblobok szintje határozza meg a blob engedélyezett méretét, IOPS-ját és sávszélességét. A blokkblobok szintje határozza meg a gyakori elérésű/ritka elérésű/archív tárolási típust. Ez a művelet nem frissíti a blob ETagjét. Lásd: blobszintek beállítása. A művelet (subrequest) hitelesítése és engedélyezése meghatározott hitelesítő adatokkal történik. Lásd blob köteg-engedélyezési adatait.

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

Hozzon létre több csoportszintű műveletet a réteg blobon való beállításához. A művelet engedélyezett egy prémium szintű tárfiók lapblobján és egy blobtároló fiók blokkblobján (csak helyileg redundáns tárolás esetén). A prémium szintű lapblobok szintje határozza meg a blob engedélyezett méretét, IOPS-ját és sávszélességét. A blokkblobok szintje határozza meg a gyakori elérésű/ritka elérésű/archív tárolási típust. Ez a művelet nem frissíti a blob ETagjét. Lásd: blobszintek beállítása. A művelet (subrequest) hitelesítése és engedélyezése meghatározott hitelesítő adatokkal történik. Lásd blob köteg-engedélyezési adatait.

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Több részbefoglalásból álló kötegkérelem elküldése.

A kódrészletek futtatása előtt lekérheti blobBatchClient és egyéb részleteket. blobServiceClient.getBlobBatchClient() ad a blobBatchClient

Példahasználat:

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

Példa bérlet használatával:

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

Lásd: https://learn.microsoft.com/rest/api/storageservices/blob-batch

Konstruktor adatai

BlobBatchClient(string, PipelineLike)

Létrehozza a BlobBatchClient egy példányát.

new BlobBatchClient(url: string, pipeline: PipelineLike)

Paraméterek

url

string

Az Azure Storage blobszolgáltatásra mutató URL-cím, például "https://myaccount.blob.core.windows.net". Az SAS hozzáfűzhető, ha AnonymousCredentialt használ, például "https://myaccount.blob.core.windows.net?sasString".

pipeline
PipelineLike

A newPipeline() hívása egy alapértelmezett folyamat létrehozásához vagy egy testreszabott folyamat megadásához.

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

Létrehozza a BlobBatchClient egy példányát.

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

Paraméterek

url

string

Az Azure Storage blobszolgáltatásra mutató URL-cím, például "https://myaccount.blob.core.windows.net". Az SAS hozzáfűzhető, ha AnonymousCredentialt használ, például "https://myaccount.blob.core.windows.net?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Ilyen például az AnonymousCredential, a StorageSharedKeyCredential vagy a @azure/identity csomag bármely hitelesítő adata a szolgáltatás felé irányuló kérések hitelesítéséhez. Olyan objektumot is megadhat, amely implementálja a TokenCredential interfészt. Ha nincs megadva, az AnonymousCredential lesz használva.

options
StoragePipelineOptions

A HTTP-folyamat konfigurálására vonatkozó beállítások.

Metódus adatai

createBatch()

Létrehoz egy BlobBatch. A BlobBatch a blobokon végzett műveletek összesített készletét jelöli.

function createBatch(): BlobBatch

Válaszok

deleteBlobs(BlobClient[], BlobDeleteOptions)

Több törlési művelet létrehozása a megadott blobok vagy pillanatképek megjelöléséhez a törléshez. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. Egyszerre mindkettő törölhető. Lásd törlési művelet részleteit. A művelet (subrequest) hitelesítése és engedélyezése meghatározott hitelesítő adatokkal történik. Lásd blob köteg-engedélyezési adatait.

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

Paraméterek

blobClients

BlobClient[]

A törölni kívánt blobok BlobClientjei.

Válaszok

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

Több törlési művelet létrehozása a megadott blobok vagy pillanatképek megjelöléséhez a törléshez. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. Egyszerre mindkettő törölhető. Lásd törlési művelet részleteit. A műveletek hitelesítése és engedélyezése meghatározott hitelesítő adatokkal történik. Lásd blob köteg-engedélyezési adatait.

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

Paraméterek

urls

string[]

A törölni kívánt blob-erőforrások URL-címei.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Ilyen például az AnonymousCredential, a StorageSharedKeyCredential vagy a @azure/identity csomag bármely hitelesítő adata a szolgáltatás felé irányuló kérések hitelesítéséhez. Olyan objektumot is megadhat, amely implementálja a TokenCredential interfészt. Ha nincs megadva, az AnonymousCredential lesz használva.

Válaszok

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Hozzon létre több csoportszintű műveletet a réteg blobon való beállításához. A művelet engedélyezett egy prémium szintű tárfiók lapblobján és egy blobtároló fiók blokkblobján (csak helyileg redundáns tárolás esetén). A prémium szintű lapblobok szintje határozza meg a blob engedélyezett méretét, IOPS-ját és sávszélességét. A blokkblobok szintje határozza meg a gyakori elérésű/ritka elérésű/archív tárolási típust. Ez a művelet nem frissíti a blob ETagjét. Lásd: blobszintek beállítása. A művelet (subrequest) hitelesítése és engedélyezése meghatározott hitelesítő adatokkal történik. Lásd blob köteg-engedélyezési adatait.

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

Paraméterek

blobClients

BlobClient[]

A blobok BlobClient-jeinek új rétegkészlettel kell rendelkezniük.

tier
AccessTier

Válaszok

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

Hozzon létre több csoportszintű műveletet a réteg blobon való beállításához. A művelet engedélyezett egy prémium szintű tárfiók lapblobján és egy blobtároló fiók blokkblobján (csak helyileg redundáns tárolás esetén). A prémium szintű lapblobok szintje határozza meg a blob engedélyezett méretét, IOPS-ját és sávszélességét. A blokkblobok szintje határozza meg a gyakori elérésű/ritka elérésű/archív tárolási típust. Ez a művelet nem frissíti a blob ETagjét. Lásd: blobszintek beállítása. A művelet (subrequest) hitelesítése és engedélyezése meghatározott hitelesítő adatokkal történik. Lásd blob köteg-engedélyezési adatait.

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

Paraméterek

urls

string[]

A törölni kívánt bloberőforrás URL-címei.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Ilyen például az AnonymousCredential, a StorageSharedKeyCredential vagy a @azure/identity csomag bármely hitelesítő adata a szolgáltatás felé irányuló kérések hitelesítéséhez. Olyan objektumot is megadhat, amely implementálja a TokenCredential interfészt. Ha nincs megadva, az AnonymousCredential lesz használva.

tier
AccessTier

Válaszok

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Több részbefoglalásból álló kötegkérelem elküldése.

A kódrészletek futtatása előtt lekérheti blobBatchClient és egyéb részleteket. blobServiceClient.getBlobBatchClient() ad a blobBatchClient

Példahasználat:

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

Példa bérlet használatával:

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

Lásd: https://learn.microsoft.com/rest/api/storageservices/blob-batch

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

Paraméterek

batchRequest
BlobBatch

Törlési vagy SetTier-műveletek készlete.

Válaszok