Udostępnij za pośrednictwem

BlobBatchClient class

  • Odwołanie
Pakiet:
@azure/storage-blob

Obiekt BlobBatchClient umożliwia wykonywanie wsadowych żądań do usługi Azure Storage Blob Service.

Konstruktory

BlobBatchClient(string, PipelineLike)

Tworzy wystąpienie obiektu BlobBatchClient.
BlobBatchClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Tworzy wystąpienie obiektu BlobBatchClient.

Metody

createBatch()

Tworzy <xref:BlobBatch>. Obiekt BlobBatch reprezentuje zagregowany zestaw operacji na obiektach blob.
deleteBlobs(BlobClient[], BlobDeleteOptions)

Utwórz wiele operacji usuwania, aby oznaczyć określone obiekty blob lub migawki do usunięcia. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba można usunąć w tym samym czasie. Zobacz szczegóły operacji usuwania. Operacja(subrequest) zostanie uwierzytelniona i autoryzowana przy użyciu określonych poświadczeń. Zobacz szczegóły autoryzacji wsadowej obiektu blob.
deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions)

Utwórz wiele operacji usuwania, aby oznaczyć określone obiekty blob lub migawki do usunięcia. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba można usunąć w tym samym czasie. Zobacz szczegóły operacji usuwania. Operacje zostaną uwierzytelnione i autoryzowane przy użyciu określonych poświadczeń. Zobacz szczegóły autoryzacji wsadowej obiektu blob.
setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Utwórz wiele operacji warstwy zestawu, aby ustawić warstwę w obiekcie blob. Operacja jest dozwolona na stronicowym obiekcie blob na koncie usługi Premium Storage i na blokowym obiekcie blob na koncie magazynu obiektów blob (tylko magazyn lokalnie nadmiarowy). Warstwa stronicowego obiektu blob w warstwie Premium określa dozwolony rozmiar, liczbę operacji we/wy na sekundę i przepustowość obiektu blob. Warstwa blokowego obiektu blob określa typ magazynu Gorąca/Chłodna/Archiwum. Ta operacja nie aktualizuje elementu ETag obiektu blob. Zobacz ustawianie szczegółów warstwy obiektów blob. Operacja(subrequest) zostanie uwierzytelniona i autoryzowana przy użyciu określonych poświadczeń. Zobacz szczegóły autoryzacji wsadowej obiektu blob.
setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions)

Utwórz wiele operacji warstwy zestawu, aby ustawić warstwę w obiekcie blob. Operacja jest dozwolona na stronicowym obiekcie blob na koncie usługi Premium Storage i na blokowym obiekcie blob na koncie magazynu obiektów blob (tylko magazyn lokalnie nadmiarowy). Warstwa stronicowego obiektu blob w warstwie Premium określa dozwolony rozmiar, liczbę operacji we/wy na sekundę i przepustowość obiektu blob. Warstwa blokowego obiektu blob określa typ magazynu Gorąca/Chłodna/Archiwum. Ta operacja nie aktualizuje elementu ETag obiektu blob. Zobacz ustawianie szczegółów warstwy obiektów blob. Operacja(subrequest) zostanie uwierzytelniona i autoryzowana przy użyciu określonych poświadczeń. Zobacz szczegóły autoryzacji wsadowej obiektu blob.
submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Prześlij żądanie wsadowe, które składa się z wielu podkwestni. Pobierz blobBatchClient i inne szczegóły przed uruchomieniem fragmentów kodu. blobServiceClient.getBlobBatchClient() daje blobBatchClient

Przykładowe użycie:

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

Przykład użycia dzierżawy:

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

Szczegóły konstruktora

BlobBatchClient(string, PipelineLike)

Tworzy wystąpienie obiektu BlobBatchClient.

new BlobBatchClient(url: string, pipeline: PipelineLike)

Parametry

url

string

Adres URL wskazujący usługę Azure Storage blob Service, taką jak "https://myaccount.blob.core.windows.net". Sygnaturę dostępu współdzielonego można dołączyć, jeśli jest używana funkcja AnonymousCredential, na przykład "https://myaccount.blob.core.windows.net?sasString".

pipeline
PipelineLike

Wywołaj metodę newPipeline(), aby utworzyć domyślny potok lub podaj dostosowany potok.

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

Tworzy wystąpienie obiektu BlobBatchClient.

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

Parametry

url

string

Adres URL wskazujący usługę Azure Storage blob Service, taką jak "https://myaccount.blob.core.windows.net". Sygnaturę dostępu współdzielonego można dołączyć, jeśli jest używana funkcja AnonymousCredential, na przykład "https://myaccount.blob.core.windows.net?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Takie jak AnonymousCredential, StorageSharedKeyCredential lub dowolne poświadczenia z pakietu @azure/identity do uwierzytelniania żądań do usługi. Można również podać obiekt, który implementuje interfejs TokenCredential. Jeśli nie zostanie określony, zostanie użyty parametr AnonymousCredential.

options
StoragePipelineOptions

Opcje konfigurowania potoku HTTP.

Szczegóły metody

createBatch()

Tworzy <xref:BlobBatch>. Obiekt BlobBatch reprezentuje zagregowany zestaw operacji na obiektach blob.

function createBatch()

Zwraca

BlobBatch

deleteBlobs(BlobClient[], BlobDeleteOptions)

Utwórz wiele operacji usuwania, aby oznaczyć określone obiekty blob lub migawki do usunięcia. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba można usunąć w tym samym czasie. Zobacz szczegóły operacji usuwania. Operacja(subrequest) zostanie uwierzytelniona i autoryzowana przy użyciu określonych poświadczeń. Zobacz szczegóły autoryzacji wsadowej obiektu blob.

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

Parametry

blobClients

BlobClient[]

Obiekty blobClients dla obiektów blob do usunięcia.

options
BlobDeleteOptions

Zwraca

Promise<BlobBatchDeleteBlobsResponse>

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

Utwórz wiele operacji usuwania, aby oznaczyć określone obiekty blob lub migawki do usunięcia. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba można usunąć w tym samym czasie. Zobacz szczegóły operacji usuwania. Operacje zostaną uwierzytelnione i autoryzowane przy użyciu określonych poświadczeń. Zobacz szczegóły autoryzacji wsadowej obiektu blob.

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

Parametry

urls

string[]

Adresy URL zasobów obiektów blob do usunięcia.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Takie jak AnonymousCredential, StorageSharedKeyCredential lub dowolne poświadczenia z pakietu @azure/identity do uwierzytelniania żądań do usługi. Można również podać obiekt, który implementuje interfejs TokenCredential. Jeśli nie zostanie określony, zostanie użyty parametr AnonymousCredential.

options
BlobDeleteOptions

Zwraca

Promise<BlobBatchDeleteBlobsResponse>

setBlobsAccessTier(BlobClient[], AccessTier, BlobSetTierOptions)

Utwórz wiele operacji warstwy zestawu, aby ustawić warstwę w obiekcie blob. Operacja jest dozwolona na stronicowym obiekcie blob na koncie usługi Premium Storage i na blokowym obiekcie blob na koncie magazynu obiektów blob (tylko magazyn lokalnie nadmiarowy). Warstwa stronicowego obiektu blob w warstwie Premium określa dozwolony rozmiar, liczbę operacji we/wy na sekundę i przepustowość obiektu blob. Warstwa blokowego obiektu blob określa typ magazynu Gorąca/Chłodna/Archiwum. Ta operacja nie aktualizuje elementu ETag obiektu blob. Zobacz ustawianie szczegółów warstwy obiektów blob. Operacja(subrequest) zostanie uwierzytelniona i autoryzowana przy użyciu określonych poświadczeń. Zobacz szczegóły autoryzacji wsadowej obiektu blob.

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

Parametry

blobClients

BlobClient[]

Obiekty blobClient dla obiektów blob, które powinny mieć nowy zestaw warstw.

tier
AccessTier
options
BlobSetTierOptions

Zwraca

Promise<BlobBatchSetBlobsAccessTierResponse>

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

Utwórz wiele operacji warstwy zestawu, aby ustawić warstwę w obiekcie blob. Operacja jest dozwolona na stronicowym obiekcie blob na koncie usługi Premium Storage i na blokowym obiekcie blob na koncie magazynu obiektów blob (tylko magazyn lokalnie nadmiarowy). Warstwa stronicowego obiektu blob w warstwie Premium określa dozwolony rozmiar, liczbę operacji we/wy na sekundę i przepustowość obiektu blob. Warstwa blokowego obiektu blob określa typ magazynu Gorąca/Chłodna/Archiwum. Ta operacja nie aktualizuje elementu ETag obiektu blob. Zobacz ustawianie szczegółów warstwy obiektów blob. Operacja(subrequest) zostanie uwierzytelniona i autoryzowana przy użyciu określonych poświadczeń. Zobacz szczegóły autoryzacji wsadowej obiektu blob.

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

Parametry

urls

string[]

Adresy URL zasobu obiektu blob do usunięcia.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Takie jak AnonymousCredential, StorageSharedKeyCredential lub dowolne poświadczenia z pakietu @azure/identity do uwierzytelniania żądań do usługi. Można również podać obiekt, który implementuje interfejs TokenCredential. Jeśli nie zostanie określony, zostanie użyty parametr AnonymousCredential.

tier
AccessTier
options
BlobSetTierOptions

Zwraca

Promise<BlobBatchSetBlobsAccessTierResponse>

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

Prześlij żądanie wsadowe, które składa się z wielu podkwestni. Pobierz blobBatchClient i inne szczegóły przed uruchomieniem fragmentów kodu. blobServiceClient.getBlobBatchClient() daje blobBatchClient

Przykładowe użycie:

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

Przykład użycia dzierżawy:

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)

Parametry

batchRequest
BlobBatch

Zestaw operacji Delete lub SetTier.

options
BlobBatchSubmitBatchOptionalParams

Zwraca

Promise<BlobBatchSubmitBatchResponse>