BlobBatchClient class

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 element <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, musisz 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, musisz 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 obiektu 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 obiektu 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 składające się z wielu podkwestni. Pobierz blobBatchClient i inne szczegóły przed uruchomieniem fragmentów kodu. blobServiceClient.getBlobBatchClient() daje blobBatchClient

Przykład użycia:

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ę Obiektów blob usługi Azure Storage, taką jak "https://myaccount.blob.core.windows.net". Sygnaturę dostępu współdzielonego można dołączyć, jeśli używasz funkcji AnonymousCredential, na przykład "https://myaccount.blob.core.windows.net?sasString"".

pipeline
PipelineLike

Wywołaj metodę newPipeline() w celu utworzenia potoku domyślnego 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ę Obiektów blob usługi Azure Storage, taką jak "https://myaccount.blob.core.windows.net". Sygnaturę dostępu współdzielonego można dołączyć, jeśli używasz funkcji AnonymousCredential, na przykład "https://myaccount.blob.core.windows.net?sasString"".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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

options
StoragePipelineOptions

Opcje konfigurowania potoku HTTP.

Szczegóły metody

createBatch()

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

function createBatch()

Zwraca

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, musisz 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[]

Obiekt BlobClients dla obiektów blob do usunięcia.

Zwraca

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, musisz 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 @azure/identity pakietu w celu uwierzytelnienia żądań do usługi. Można również podać obiekt implementujący interfejs TokenCredential. Jeśli nie zostanie określony, zostanie użyty parametr AnonymousCredential.

Zwraca

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 obiektu 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

Zwraca

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 obiektu 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 @azure/identity pakietu w celu uwierzytelnienia żądań do usługi. Można również podać obiekt implementujący interfejs TokenCredential. Jeśli nie zostanie określony, zostanie użyty parametr AnonymousCredential.

tier
AccessTier

Zwraca

submitBatch(BlobBatch, BlobBatchSubmitBatchOptionalParams)

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

Przykład użycia:

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.

Zwraca