Udostępnij za pośrednictwem

PageBlobClient class

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

PageBlobClient definiuje zestaw operacji mających zastosowanie do stronicowych obiektów blob.

Extends
BlobClient

Konstruktory

PageBlobClient(string, PipelineLike)

Tworzy wystąpienie elementu PageBlobClient.
PageBlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Tworzy wystąpienie elementu PageBlobClient. Ta metoda akceptuje zakodowany adres URL lub niekodowany adres URL wskazujący obiekt blob. Zakodowany ciąg adresu URL nie zostanie uniknięci dwa razy. Tylko znaki specjalne w ścieżce adresu URL zostaną zmienione. Jeśli nazwa obiektu blob zawiera wartość ? lub %, nazwa obiektu blob musi być zakodowana w adresie URL.
PageBlobClient(string, string, string, StoragePipelineOptions)

Tworzy wystąpienie elementu PageBlobClient.

Właściwości

containerName

Nazwa kontenera magazynu, z który jest skojarzony obiekt blob.
name

Nazwa obiektu blob.

Właściwości dziedziczone

accountName
credential

Takie jak AnonymousCredential, StorageSharedKeyCredential lub dowolne poświadczenia z pakietu w @azure/identity celu uwierzytelnienia żą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.
url

Zakodowana wartość ciągu adresu URL.

Metody

clearPages(number, number, PageBlobClearPagesOptions)

Zwalnia określone strony ze stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/put-page
create(number, PageBlobCreateOptions)

Tworzy stronicowy obiekt blob o określonej długości. Wywołaj metodę uploadPages, aby przekazać dane do stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/put-blob
createIfNotExists(number, PageBlobCreateIfNotExistsOptions)

Tworzy stronicowy obiekt blob o określonej długości. Wywołaj metodę uploadPages, aby przekazać dane do stronicowego obiektu blob. Jeśli obiekt blob o tej samej nazwie już istnieje, zawartość istniejącego obiektu blob pozostanie niezmieniona.

Zobacz https://docs.microsoft.com/rest/api/storageservices/put-blob
getPageRanges(number, number, PageBlobGetPageRangesOptions)

Zwraca listę prawidłowych zakresów stron dla stronicowego obiektu blob lub migawki stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges
getPageRangesDiff(number, number, string, PageBlobGetPageRangesDiffOptions)

Pobiera kolekcję zakresów stron, które różnią się między określoną migawką a tym stronicowym obiektem blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges
getPageRangesDiffForManagedDisks(number, number, string, PageBlobGetPageRangesDiffOptions)

Pobiera kolekcję zakresów stron, które różnią się między określoną migawką a tym stronicowym obiektem blob dla dysków zarządzanych.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges
listPageRanges(number, number, PageBlobListPageRangesOptions)

Zwraca iterator asynchroniczny do listy zakresów stron dla stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges

Funkcja .byPage() zwraca iterator asynchroniczny do listy zakresów stron dla stronicowego obiektu blob.

Przykład użycia for await składni:

// Get the pageBlobClient before you run these snippets,
// Can be obtained from `blobServiceClient.getContainerClient("<your-container-name>").getPageBlobClient("<your-blob-name>");`
let i = 1;
for await (const pageRange of pageBlobClient.listPageRanges()) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

Przykład użycia polecenia iter.next():

let i = 1;
let iter = pageBlobClient.listPageRanges();
let pageRangeItem = await iter.next();
while (!pageRangeItem.done) {
  console.log(`Page range ${i++}: ${pageRangeItem.value.start} - ${pageRangeItem.value.end}, IsClear: ${pageRangeItem.value.isClear}`);
  pageRangeItem = await iter.next();
}

Przykład użycia polecenia byPage():

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of pageBlobClient.listPageRanges().byPage({ maxPageSize: 20 })) {
  for (const pageRange of response) {
    console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
  }
}

Przykład użycia stronicowania ze znacznikiem:

let i = 1;
let iterator = pageBlobClient.listPageRanges().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

// Prints 2 page ranges
for (const pageRange of response) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

// Gets next marker
let marker = response.continuationToken;

// Passing next marker as continuationToken

iterator = pageBlobClient.listPageRanges().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints 10 page ranges
for (const blob of response) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
listPageRangesDiff(number, number, string, PageBlobListPageRangesDiffOptions)

Zwraca iterator asynchroniczny do listy zakresów stron, które różnią się między określoną migawką a tym stronicowym obiektem blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges

Funkcja .byPage() zwraca iterator asynchroniczny do listy zakresów stron, które różnią się między określoną migawką a tym stronicowym obiektem blob.

Przykład użycia for await składni:

// Get the pageBlobClient before you run these snippets,
// Can be obtained from `blobServiceClient.getContainerClient("<your-container-name>").getPageBlobClient("<your-blob-name>");`
let i = 1;
for await (const pageRange of pageBlobClient.listPageRangesDiff()) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

Przykład użycia polecenia iter.next():

let i = 1;
let iter = pageBlobClient.listPageRangesDiff();
let pageRangeItem = await iter.next();
while (!pageRangeItem.done) {
  console.log(`Page range ${i++}: ${pageRangeItem.value.start} - ${pageRangeItem.value.end}, IsClear: ${pageRangeItem.value.isClear}`);
  pageRangeItem = await iter.next();
}

Przykład użycia polecenia byPage():

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of pageBlobClient.listPageRangesDiff().byPage({ maxPageSize: 20 })) {
  for (const pageRange of response) {
    console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
  }
}

Przykład użycia stronicowania ze znacznikiem:

let i = 1;
let iterator = pageBlobClient.listPageRangesDiff().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

// Prints 2 page ranges
for (const pageRange of response) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

// Gets next marker
let marker = response.continuationToken;

// Passing next marker as continuationToken

iterator = pageBlobClient.listPageRangesDiff().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints 10 page ranges
for (const blob of response) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
resize(number, PageBlobResizeOptions)

Zmienia rozmiar stronicowego obiektu blob na określony rozmiar (który musi mieć wielokrotność 512).

Zobacz https://docs.microsoft.com/rest/api/storageservices/set-blob-properties
startCopyIncremental(string, PageBlobStartCopyIncrementalOptions)

Rozpoczyna operację uruchamiania przyrostowej kopii z migawki jednego stronicowego obiektu blob do tego stronicowego obiektu blob. Migawka jest kopiowana w taki sposób, że tylko zmiany różnicowe między wcześniej skopiowaną migawką są przenoszone do miejsca docelowego. Skopiowane migawki są kompletnymi kopiami oryginalnej migawki i można je odczytywać lub kopiować ze zwykłych.

Zobacz https://docs.microsoft.com/rest/api/storageservices/incremental-copy-blobhttps://docs.microsoft.com/en-us/azure/virtual-machines/windows/incremental-snapshots
updateSequenceNumber(SequenceNumberActionType, number, PageBlobUpdateSequenceNumberOptions)

Ustawia numer sekwencji stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
uploadPages(RequestBodyType, number, number, PageBlobUploadPagesOptions)

Zapisuje co najmniej 1 strony w stronicowym obiekcie blob. Przesunięcia początkowe i końcowe muszą mieć wielokrotność 512.

Zobacz https://docs.microsoft.com/rest/api/storageservices/put-page
uploadPagesFromURL(string, number, number, number, PageBlobUploadPagesFromURLOptions)

Operacja Przekazywania stron zapisuje zakres stron do stronicowego obiektu blob, w którym zawartość jest odczytywana z adresu URL.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/put-page-from-url
withSnapshot(string)

Tworzy nowy obiekt PageBlobClient identyczny ze źródłem, ale z określonym znacznikiem czasu migawki. Podaj wartość "" spowoduje usunięcie migawki i zwrócenie klienta do podstawowego obiektu blob.

Metody dziedziczone

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

Przerywa oczekującą asynchroniczną operację kopiowania obiektu blob i pozostawia docelowy obiekt blob o zerowej długości i pełnych metadanych. Wersja 2012-02-12 i nowsze.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-blob
beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

Asynchronicznie kopiuje obiekt blob do miejsca docelowego na koncie magazynu. Ta metoda zwraca długotrwałą operację poller, która umożliwia oczekiwanie na czas nieokreślony do ukończenia kopiowania. Możesz również anulować kopię przed jej ukończeniem, wywołując cancelOperation narzędzie poller. Pamiętaj, że wywołanie zwrotne onProgress nie zostanie wywołane, jeśli operacja zakończy się w pierwszym żądaniu, a próba anulowania ukończonej kopii spowoduje zgłoszenie błędu.

W wersji 2012-02-12 lub nowszej źródło operacji kopiowania obiektu blob może być zatwierdzonym obiektem blob na dowolnym koncie usługi Azure Storage. Począwszy od wersji 2015-02-21, źródłem operacji kopiowania obiektu blob może być plik platformy Azure na dowolnym koncie usługi Azure Storage. Tylko konta magazynu utworzone w dniu 7 czerwca 2012 r. zezwalają na kopiowanie kopii obiektu blob z innego konta magazynu lub po tym, jak 7 czerwca 2012 r.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob

Przykład użycia automatycznego sondowania:

const copyPoller = await blobClient.beginCopyFromURL('url');
const result = await copyPoller.pollUntilDone();

Przykład użycia ręcznego sondowania:

const copyPoller = await blobClient.beginCopyFromURL('url');
while (!poller.isDone()) {
   await poller.poll();
}
const result = copyPoller.getResult();

Przykład użycia aktualizacji postępu:

const copyPoller = await blobClient.beginCopyFromURL('url', {
  onProgress(state) {
    console.log(`Progress: ${state.copyProgress}`);
  }
});
const result = await copyPoller.pollUntilDone();

Przykład użycia zmieniającego się interwału sondowania (domyślnie 15 sekund):

const copyPoller = await blobClient.beginCopyFromURL('url', {
  intervalInMs: 1000 // poll blob every 1 second for copy progress
});
const result = await copyPoller.pollUntilDone();

Przykład użycia anulowania kopiowania:

const copyPoller = await blobClient.beginCopyFromURL('url');
// cancel operation after starting it.
try {
  await copyPoller.cancelOperation();
  // calls to get the result now throw PollerCancelledError
  await copyPoller.getResult();
} catch (err) {
  if (err.name === 'PollerCancelledError') {
    console.log('The copy was cancelled.');
  }
}
createSnapshot(BlobCreateSnapshotOptions)

Tworzy migawkę obiektu blob tylko do odczytu.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob
delete(BlobDeleteOptions)

Oznacza określony obiekt blob lub migawkę do usunięcia. Obiekt blob zostanie później usunięty podczas odzyskiwania pamięci. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba te elementy można usunąć jednocześnie za pomocą operacji Usuń obiekt blob.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
deleteIfExists(BlobDeleteOptions)

Oznacza określony obiekt blob lub migawkę do usunięcia, jeśli istnieje. Obiekt blob zostanie później usunięty podczas odzyskiwania pamięci. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba te elementy można usunąć jednocześnie za pomocą operacji Usuń obiekt blob.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

Usuń zasady niezmienności w obiekcie blob.
download(number, number, BlobDownloadOptions)

Odczytuje lub pobiera obiekt blob z systemu, w tym jego metadane i właściwości. Możesz również wywołać metodę Pobierz obiekt blob, aby odczytać migawkę.

  • W Node.js dane są zwracane w strumieniu czytelnym do odczytuStreamBody
  • W przeglądarkach dane są zwracane w obiekcie blob Promise

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob
downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

DOSTĘPNE TYLKO W ŚRODOWISKU URUCHOMIENIOWYM NODE.JS.

Pobiera obiekt blob platformy Azure równolegle do buforu. Przesunięcie i liczba są opcjonalne, pobiera cały obiekt blob, jeśli nie zostały podane.

Ostrzeżenie: Bufory mogą obsługiwać tylko pliki do około jednego gigabajta w systemach 32-bitowych lub około dwóch gigabajtów w systemach 64-bitowych z powodu ograniczeń Node.js/V8. W przypadku obiektów blob większych niż ten rozmiar rozważ pobranie pliku DownloadToFile.
downloadToBuffer(number, number, BlobDownloadToBufferOptions)

DOSTĘPNE TYLKO W ŚRODOWISKU URUCHOMIENIOWYM NODE.JS.

Pobiera obiekt blob platformy Azure równolegle do buforu. Przesunięcie i liczba są opcjonalne, pobiera cały obiekt blob, jeśli nie zostały podane.

Ostrzeżenie: Bufory mogą obsługiwać tylko pliki do około jednego gigabajta w systemach 32-bitowych lub około dwóch gigabajtów w systemach 64-bitowych z powodu ograniczeń Node.js/V8. W przypadku obiektów blob większych niż ten rozmiar rozważ pobranie PlikuToFile.
downloadToFile(string, number, number, BlobDownloadOptions)

DOSTĘPNE TYLKO W ŚRODOWISKU URUCHOMIENIOWYM NODE.JS.

Pobiera obiekt blob platformy Azure do pliku lokalnego. Nie powiedzie się, jeśli dana ścieżka pliku zostanie już zakończona. Przesunięcie i liczba są opcjonalne, przekaż odpowiednio 0 i niezdefiniowane, aby pobrać cały obiekt blob.
exists(BlobExistsOptions)

Zwraca wartość true, jeśli istnieje zasób obiektu blob platformy Azure reprezentowany przez tego klienta; false w przeciwnym razie.

UWAGA: użyj tej funkcji z opieką, ponieważ istniejący obiekt blob może zostać usunięty przez innych klientów lub aplikacji. Na odwrót nowe obiekty blob mogą zostać dodane przez innych klientów lub aplikacje po zakończeniu tej funkcji.
generateSasUrl(BlobGenerateSasUrlOptions)

Jest dostępny tylko dla obiektu BlobClient skonstruowanego przy użyciu poświadczeń klucza współdzielonego.

Generuje identyfikator URI sygnatury dostępu współdzielonego (SAS) usługi Blob Service na podstawie właściwości i parametrów klienta przekazanych. Sygnatura dostępu współdzielonego jest podpisana przez poświadczenia klucza współdzielonego klienta.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
getAppendBlobClient()

Tworzy obiekt AppendBlobClient.
getBlobLeaseClient(string)

Pobierz obiekt BlobLeaseClient , który zarządza dzierżawami obiektu blob.
getBlockBlobClient()

Tworzy obiekt BlockBlobClient.
getPageBlobClient()

Tworzy obiekt PageBlobClient.
getProperties(BlobGetPropertiesOptions)

Zwraca wszystkie metadane zdefiniowane przez użytkownika, standardowe właściwości HTTP i właściwości systemu dla obiektu blob. Nie zwraca zawartości obiektu blob.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties

OSTRZEŻENIE: metadata Obiekt zwrócony w odpowiedzi będzie miał swoje klucze w małych literach, nawet jeśli pierwotnie zawierał wielkie litery. Różni się to od kluczy metadanych zwracanych przez metody ContainerClient , które wyświetlają listę obiektów blob przy użyciu includeMetadata opcji , która zachowa oryginalną wielkość liter.
getTags(BlobGetTagsOptions)

Pobiera tagi skojarzone z bazowym obiektem blob.
setAccessTier(string, BlobSetTierOptions)

Ustawia warstwę obiektu 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 https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier
setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

Ustawia właściwości systemowe obiektu blob.

Jeśli nie podano żadnej wartości lub nie podano żadnej wartości dla określonych nagłówków HTTP obiektu blob, te nagłówki HTTP obiektu blob bez wartości zostaną wyczyszczone.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

Ustaw zasady niezmienności w obiekcie blob.
setLegalHold(boolean, BlobSetLegalHoldOptions)

Ustaw blokadę prawną obiektu blob.
setMetadata(Metadata, BlobSetMetadataOptions)

Ustawia metadane zdefiniowane przez użytkownika dla określonego obiektu blob jako jedną lub więcej par name-value.

Jeśli nie podano żadnej opcji lub żadne metadane zdefiniowane w parametrze, metadane obiektu blob zostaną usunięte.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
setTags(Tags, BlobSetTagsOptions)

Ustawia tagi w bazowym obiekcie blob. Obiekt blob może mieć maksymalnie 10 tagów. Klucze tagów muszą zawierać od 1 do 128 znaków. Wartości tagów muszą zawierać od 0 do 256 znaków. Prawidłowe znaki klucza tagu i wartości obejmują małe i wielkie litery, cyfry (0–9), spację (' '), plus ('+'), minus ('-'), kropkę ('.'), ukośnik ('/'), dwukropek (':'), równe ('=') i podkreślenie ('_') .
syncCopyFromURL(string, BlobSyncCopyFromURLOptions)

Synchroniczna operacja kopiowania z adresu URL kopiuje obiekt blob lub zasób internetowy do nowego obiektu blob. Nie zwróci odpowiedzi, dopóki kopia nie zostanie ukończona.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url
undelete(BlobUndeleteOptions)

Przywraca zawartość i metadane nietrwałego usuniętego obiektu blob oraz wszystkie skojarzone nietrwale usunięte migawki. Cofanie obiektu blob jest obsługiwane tylko w wersji 2017-07-29 lub nowszej.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob
withVersion(string)

Tworzy nowy obiekt BlobClient wskazujący wersję tego obiektu blob. Podaj wartość "" spowoduje usunięcie identyfikatora versionId i zwrócenie klienta do podstawowego obiektu blob.

Szczegóły konstruktora

PageBlobClient(string, PipelineLike)

Tworzy wystąpienie elementu PageBlobClient.

new PageBlobClient(url: string, pipeline: PipelineLike)

Parametry

url

string

Ciąg adresu URL wskazujący stronicowy obiekt blob usługi Azure Storage, taki jak "https://myaccount.blob.core.windows.net/mycontainer/pageblob". Sygnaturę dostępu współdzielonego można dołączyć, jeśli używasz elementu AnonymousCredential, takiego jak "https://myaccount.blob.core.windows.net/mycontainer/pageblob?sasString". Ta metoda akceptuje zakodowany adres URL lub niekodowany adres URL wskazujący obiekt blob. Zakodowany ciąg adresu URL nie zostanie uniknięci dwa razy. Tylko znaki specjalne w ścieżce adresu URL zostaną zmienione. Jeśli jednak nazwa obiektu blob zawiera wartość ? lub %, nazwa obiektu blob musi być zakodowana w adresie URL. Taki jak obiekt blob o nazwie "my?blob%", adres URL powinien mieć wartość "https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25"".

pipeline
PipelineLike

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

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

Tworzy wystąpienie elementu PageBlobClient. Ta metoda akceptuje zakodowany adres URL lub niekodowany adres URL wskazujący obiekt blob. Zakodowany ciąg adresu URL nie zostanie uniknięci dwa razy. Tylko znaki specjalne w ścieżce adresu URL zostaną zmienione. Jeśli nazwa obiektu blob zawiera wartość ? lub %, nazwa obiektu blob musi być zakodowana w adresie URL.

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

Parametry

url

string

Ciąg klienta wskazujący stronicowy obiekt blob usługi Azure Storage, taki jak "https://myaccount.blob.core.windows.net/mycontainer/pageblob". Sygnaturę dostępu współdzielonego można dołączyć, jeśli używasz elementu AnonymousCredential, takiego jak "https://myaccount.blob.core.windows.net/mycontainer/pageblob?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Takie jak AnonymousCredential, StorageSharedKeyCredential lub dowolne poświadczenia z pakietu w @azure/identity celu uwierzytelnienia żą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

Opcjonalny. Opcje konfigurowania potoku HTTP.

PageBlobClient(string, string, string, StoragePipelineOptions)

Tworzy wystąpienie elementu PageBlobClient.

new PageBlobClient(connectionString: string, containerName: string, blobName: string, options?: StoragePipelineOptions)

Parametry

connectionString

string

Parametry połączenia konta lub parametry połączenia sygnatury dostępu współdzielonego konta usługi Azure Storage. [ Uwaga — parametry połączenia konta mogą być używane tylko w środowisku uruchomieniowym NODE.JS. ] Przykład parametrów połączenia konta —DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net Przykład parametrów połączenia sygnatury dostępu współdzielonego — BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString

containerName

string

Nazwa kontenera.

blobName

string

Nazwa obiektu blob.

options
StoragePipelineOptions

Opcjonalny. Opcje konfigurowania potoku HTTP.

Szczegóły właściwości

containerName

Nazwa kontenera magazynu, z który jest skojarzony obiekt blob.

string containerName

Wartość właściwości

string

name

Nazwa obiektu blob.

string name

Wartość właściwości

string

Szczegóły właściwości dziedziczonej

accountName 

accountName: string

Wartość właściwości

string

Dziedziczone zobiektu BlobClient.accountName

credential

Takie jak AnonymousCredential, StorageSharedKeyCredential lub dowolne poświadczenia z pakietu w @azure/identity celu uwierzytelnienia żą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.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Wartość właściwości

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Dziedziczone zobiektu BlobClient.credential

url

Zakodowana wartość ciągu adresu URL.

url: string

Wartość właściwości

string

Dziedziczone zobiektu BlobClient.url

Szczegóły metody

clearPages(number, number, PageBlobClearPagesOptions)

Zwalnia określone strony ze stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/put-page

function clearPages(offset?: number, count?: number, options?: PageBlobClearPagesOptions): Promise<PageBlobClearPagesResponse>

Parametry

offset

number

Rozpoczynanie położenia bajtów stron w celu wyczyszczenia.

count

number

Liczba bajtów do wyczyszczenia.

options
PageBlobClearPagesOptions

Opcje operacji stronicowego obiektu blob Wyczyść strony.

Zwraca

Promise<PageBlobClearPagesResponse>

Dane odpowiedzi dla operacji stronicowego obiektu blob Wyczyść strony.

create(number, PageBlobCreateOptions)

Tworzy stronicowy obiekt blob o określonej długości. Wywołaj metodę uploadPages, aby przekazać dane do stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/put-blob

function create(size: number, options?: PageBlobCreateOptions): Promise<PageBlobCreateResponse>

Parametry

size

number

rozmiar stronicowego obiektu blob.

options
PageBlobCreateOptions

Opcje operacji tworzenia stronicowego obiektu blob.

Zwraca

Promise<PageBlobCreateResponse>

Dane odpowiedzi dla operacji tworzenia stronicowego obiektu blob.

createIfNotExists(number, PageBlobCreateIfNotExistsOptions)

Tworzy stronicowy obiekt blob o określonej długości. Wywołaj metodę uploadPages, aby przekazać dane do stronicowego obiektu blob. Jeśli obiekt blob o tej samej nazwie już istnieje, zawartość istniejącego obiektu blob pozostanie niezmieniona.

Zobacz https://docs.microsoft.com/rest/api/storageservices/put-blob

function createIfNotExists(size: number, options?: PageBlobCreateIfNotExistsOptions): Promise<PageBlobCreateIfNotExistsResponse>

Parametry

size

number

rozmiar stronicowego obiektu blob.

options
PageBlobCreateIfNotExistsOptions

Zwraca

Promise<PageBlobCreateIfNotExistsResponse>

getPageRanges(number, number, PageBlobGetPageRangesOptions)

Zwraca listę prawidłowych zakresów stron dla stronicowego obiektu blob lub migawki stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges

function getPageRanges(offset?: number, count?: number, options?: PageBlobGetPageRangesOptions): Promise<PageBlobGetPageRangesResponse>

Parametry

offset

number

Pozycja bajtów początkowych zakresów stron.

count

number

Liczba bajtów do pobrania.

options
PageBlobGetPageRangesOptions

Opcje operacji Pobierz zakresy stronicowego obiektu blob.

Zwraca

Promise<PageBlobGetPageRangesResponse>

Dane odpowiedzi dla operacji Pobierz zakresy stronicowego obiektu blob.

getPageRangesDiff(number, number, string, PageBlobGetPageRangesDiffOptions)

Pobiera kolekcję zakresów stron, które różnią się między określoną migawką a tym stronicowym obiektem blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges

function getPageRangesDiff(offset: number, count: number, prevSnapshot: string, options?: PageBlobGetPageRangesDiffOptions): Promise<PageBlobGetPageRangesDiffResponse>

Parametry

offset

number

Rozpoczynanie pozycji bajtów stronicowego obiektu blob

count

number

Liczba bajtów w celu uzyskania różnic zakresów.

prevSnapshot

string

Sygnatura czasowa migawki w celu pobrania różnicy.

options
PageBlobGetPageRangesDiffOptions

Opcje operacji różnicowania stronicowego obiektu blob Pobierania zakresów stron.

Zwraca

Promise<PageBlobGetPageRangesDiffResponse>

Dane odpowiedzi dla operacji Różnice zakresu stron dla stronicowego obiektu blob.

getPageRangesDiffForManagedDisks(number, number, string, PageBlobGetPageRangesDiffOptions)

Pobiera kolekcję zakresów stron, które różnią się między określoną migawką a tym stronicowym obiektem blob dla dysków zarządzanych.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges

function getPageRangesDiffForManagedDisks(offset: number, count: number, prevSnapshotUrl: string, options?: PageBlobGetPageRangesDiffOptions): Promise<PageBlobGetPageRangesDiffResponse>

Parametry

offset

number

Rozpoczynanie pozycji bajtów stronicowego obiektu blob

count

number

Liczba bajtów w celu uzyskania różnic zakresów.

prevSnapshotUrl

string

Adres URL migawki w celu pobrania różnicy.

options
PageBlobGetPageRangesDiffOptions

Opcje operacji różnicowania stronicowego obiektu blob Pobierania zakresów stron.

Zwraca

Promise<PageBlobGetPageRangesDiffResponse>

Dane odpowiedzi dla operacji Różnice zakresu stron dla stronicowego obiektu blob.

listPageRanges(number, number, PageBlobListPageRangesOptions)

Zwraca iterator asynchroniczny do listy zakresów stron dla stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges

Funkcja .byPage() zwraca iterator asynchroniczny do listy zakresów stron dla stronicowego obiektu blob.

Przykład użycia for await składni:

// Get the pageBlobClient before you run these snippets,
// Can be obtained from `blobServiceClient.getContainerClient("<your-container-name>").getPageBlobClient("<your-blob-name>");`
let i = 1;
for await (const pageRange of pageBlobClient.listPageRanges()) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

Przykład użycia polecenia iter.next():

let i = 1;
let iter = pageBlobClient.listPageRanges();
let pageRangeItem = await iter.next();
while (!pageRangeItem.done) {
  console.log(`Page range ${i++}: ${pageRangeItem.value.start} - ${pageRangeItem.value.end}, IsClear: ${pageRangeItem.value.isClear}`);
  pageRangeItem = await iter.next();
}

Przykład użycia polecenia byPage():

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of pageBlobClient.listPageRanges().byPage({ maxPageSize: 20 })) {
  for (const pageRange of response) {
    console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
  }
}

Przykład użycia stronicowania ze znacznikiem:

let i = 1;
let iterator = pageBlobClient.listPageRanges().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

// Prints 2 page ranges
for (const pageRange of response) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

// Gets next marker
let marker = response.continuationToken;

// Passing next marker as continuationToken

iterator = pageBlobClient.listPageRanges().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints 10 page ranges
for (const blob of response) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

function listPageRanges(offset?: number, count?: number, options?: PageBlobListPageRangesOptions): PagedAsyncIterableIterator<PageRangeInfo, PageBlobGetPageRangesResponseModel, PageSettings>

Parametry

offset

number

Pozycja bajtów początkowych zakresów stron.

count

number

Liczba bajtów do pobrania.

options
PageBlobListPageRangesOptions

Opcje operacji Pobierz zakresy stronicowego obiektu blob.

Zwraca

PagedAsyncIterableIterator<PageRangeInfo, PageBlobGetPageRangesResponseModel, PageSettings>

AsyncIterableIterator, który obsługuje stronicowanie.

listPageRangesDiff(number, number, string, PageBlobListPageRangesDiffOptions)

Zwraca iterator asynchroniczny do listy zakresów stron, które różnią się między określoną migawką a tym stronicowym obiektem blob.

Zobacz https://docs.microsoft.com/rest/api/storageservices/get-page-ranges

Funkcja .byPage() zwraca iterator asynchroniczny do listy zakresów stron, które różnią się między określoną migawką a tym stronicowym obiektem blob.

Przykład użycia for await składni:

// Get the pageBlobClient before you run these snippets,
// Can be obtained from `blobServiceClient.getContainerClient("<your-container-name>").getPageBlobClient("<your-blob-name>");`
let i = 1;
for await (const pageRange of pageBlobClient.listPageRangesDiff()) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

Przykład użycia polecenia iter.next():

let i = 1;
let iter = pageBlobClient.listPageRangesDiff();
let pageRangeItem = await iter.next();
while (!pageRangeItem.done) {
  console.log(`Page range ${i++}: ${pageRangeItem.value.start} - ${pageRangeItem.value.end}, IsClear: ${pageRangeItem.value.isClear}`);
  pageRangeItem = await iter.next();
}

Przykład użycia polecenia byPage():

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of pageBlobClient.listPageRangesDiff().byPage({ maxPageSize: 20 })) {
  for (const pageRange of response) {
    console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
  }
}

Przykład użycia stronicowania ze znacznikiem:

let i = 1;
let iterator = pageBlobClient.listPageRangesDiff().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

// Prints 2 page ranges
for (const pageRange of response) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

// Gets next marker
let marker = response.continuationToken;

// Passing next marker as continuationToken

iterator = pageBlobClient.listPageRangesDiff().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints 10 page ranges
for (const blob of response) {
  console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}

function listPageRangesDiff(offset: number, count: number, prevSnapshot: string, options?: PageBlobListPageRangesDiffOptions): PagedAsyncIterableIterator<PageRangeInfo, PageBlobGetPageRangesDiffResponseModel, PageSettings>

Parametry

offset

number

Pozycja bajtów początkowych zakresów stron.

count

number

Liczba bajtów do pobrania.

prevSnapshot

string

Sygnatura czasowa migawki w celu pobrania różnicy.

options
PageBlobListPageRangesDiffOptions

Opcje operacji Pobierz zakresy stronicowego obiektu blob.

Zwraca

PagedAsyncIterableIterator<PageRangeInfo, PageBlobGetPageRangesDiffResponseModel, PageSettings>

AsyncIterableIterator, który obsługuje stronicowanie.

resize(number, PageBlobResizeOptions)

Zmienia rozmiar stronicowego obiektu blob na określony rozmiar (który musi mieć wielokrotność 512).

Zobacz https://docs.microsoft.com/rest/api/storageservices/set-blob-properties

function resize(size: number, options?: PageBlobResizeOptions): Promise<PageBlobResizeResponse>

Parametry

size

number

Rozmiar docelowy

options
PageBlobResizeOptions

Opcje operacji zmiany rozmiaru stronicowego obiektu blob.

Zwraca

Promise<PageBlobResizeResponse>

Dane odpowiedzi dla operacji zmiany rozmiaru stronicowego obiektu blob.

startCopyIncremental(string, PageBlobStartCopyIncrementalOptions)

Rozpoczyna operację uruchamiania przyrostowej kopii z migawki jednego stronicowego obiektu blob do tego stronicowego obiektu blob. Migawka jest kopiowana w taki sposób, że tylko zmiany różnicowe między wcześniej skopiowaną migawką są przenoszone do miejsca docelowego. Skopiowane migawki są kompletnymi kopiami oryginalnej migawki i można je odczytywać lub kopiować ze zwykłych.

Zobacz https://docs.microsoft.com/rest/api/storageservices/incremental-copy-blobhttps://docs.microsoft.com/en-us/azure/virtual-machines/windows/incremental-snapshots

function startCopyIncremental(copySource: string, options?: PageBlobStartCopyIncrementalOptions): Promise<PageBlobCopyIncrementalResponse>

Parametry

copySource

string

Określa nazwę migawki stronicowego obiektu blob źródłowego. Na przykład https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

options
PageBlobStartCopyIncrementalOptions

Opcje operacji przyrostowej kopiowania stronicowych obiektów blob.

Zwraca

Promise<PageBlobCopyIncrementalResponse>

Dane odpowiedzi dla operacji przyrostowej kopiowania stronicowych obiektów blob.

updateSequenceNumber(SequenceNumberActionType, number, PageBlobUpdateSequenceNumberOptions)

Ustawia numer sekwencji stronicowego obiektu blob.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties

function updateSequenceNumber(sequenceNumberAction: SequenceNumberActionType, sequenceNumber?: number, options?: PageBlobUpdateSequenceNumberOptions): Promise<PageBlobUpdateSequenceNumberResponse>

Parametry

sequenceNumberAction
SequenceNumberActionType

Wskazuje, jak usługa powinna modyfikować numer sekwencji obiektu blob.

sequenceNumber

number

Wymagane, jeśli właściwość sequenceNumberAction ma wartość maksymalną lub aktualizację

options
PageBlobUpdateSequenceNumberOptions

Opcje operacji stronicowego numeru sekwencji aktualizacji obiektu blob.

Zwraca

Promise<PageBlobUpdateSequenceNumberResponse>

Dane odpowiedzi dla operacji numer sekwencji aktualizacji stronicowego obiektu blob.

uploadPages(RequestBodyType, number, number, PageBlobUploadPagesOptions)

Zapisuje co najmniej 1 strony w stronicowym obiekcie blob. Przesunięcia początkowe i końcowe muszą mieć wielokrotność 512.

Zobacz https://docs.microsoft.com/rest/api/storageservices/put-page

function uploadPages(body: RequestBodyType, offset: number, count: number, options?: PageBlobUploadPagesOptions): Promise<PageBlobUploadPagesResponse>

Parametry

body
HttpRequestBody

Dane do przekazania

offset

number

Przesunięcie docelowego stronicowego obiektu blob

count

number

Długość treści, również liczba bajtów do przekazania

options
PageBlobUploadPagesOptions

Opcje operacji stronicowego przekazywania stron obiektów blob.

Zwraca

Promise<PageBlobUploadPagesResponse>

Dane odpowiedzi dla operacji przekazywania stron stronicowych obiektów blob.

uploadPagesFromURL(string, number, number, number, PageBlobUploadPagesFromURLOptions)

Operacja Przekazywania stron zapisuje zakres stron do stronicowego obiektu blob, w którym zawartość jest odczytywana z adresu URL.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/put-page-from-url

function uploadPagesFromURL(sourceURL: string, sourceOffset: number, destOffset: number, count: number, options?: PageBlobUploadPagesFromURLOptions): Promise<PageBlobUploadPagesFromURLResponse>

Parametry

sourceURL

string

Określ adres URL źródła kopii, sygnaturę dostępu współdzielonego (SAS) może być wymaganą do uwierzytelniania

sourceOffset

number

Przesunięcie źródła do skopiowania. Przekaż 0, aby skopiować od początku źródłowego stronicowego obiektu blob

destOffset

number

Przesunięcie docelowego stronicowego obiektu blob

count

number

Liczba bajtów do przekazania ze źródłowego stronicowego obiektu blob

options
PageBlobUploadPagesFromURLOptions

Zwraca

Promise<PageBlobUploadPagesFromURLResponse>

withSnapshot(string)

Tworzy nowy obiekt PageBlobClient identyczny ze źródłem, ale z określonym znacznikiem czasu migawki. Podaj wartość "" spowoduje usunięcie migawki i zwrócenie klienta do podstawowego obiektu blob.

function withSnapshot(snapshot: string): PageBlobClient

Parametry

snapshot

string

Sygnatura czasowa migawki.

Zwraca

PageBlobClient

Nowy obiekt PageBlobClient identyczny ze źródłem, ale z określonym znacznikiem czasu migawki.

Szczegóły metody dziedziczonej

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

Przerywa oczekującą asynchroniczną operację kopiowania obiektu blob i pozostawia docelowy obiekt blob o zerowej długości i pełnych metadanych. Wersja 2012-02-12 i nowsze.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-blob

function abortCopyFromURL(copyId: string, options?: BlobAbortCopyFromURLOptions): Promise<BlobAbortCopyFromURLResponse>

Parametry

copyId

string

Identyfikator operacji Kopiuj z adresu URL.

options
BlobAbortCopyFromURLOptions

Opcjonalne opcje operacji Abort Copy From URL (Przerwanie kopiowania z adresu URL obiektu blob).

Zwraca

Promise<BlobAbortCopyFromURLResponse>

Dziedziczone zobiektu BlobClient.abortCopyFromURL

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

Asynchronicznie kopiuje obiekt blob do miejsca docelowego na koncie magazynu. Ta metoda zwraca długotrwałą operację poller, która umożliwia oczekiwanie na czas nieokreślony do ukończenia kopiowania. Możesz również anulować kopię przed jej ukończeniem, wywołując cancelOperation narzędzie poller. Pamiętaj, że wywołanie zwrotne onProgress nie zostanie wywołane, jeśli operacja zakończy się w pierwszym żądaniu, a próba anulowania ukończonej kopii spowoduje zgłoszenie błędu.

W wersji 2012-02-12 lub nowszej źródło operacji kopiowania obiektu blob może być zatwierdzonym obiektem blob na dowolnym koncie usługi Azure Storage. Począwszy od wersji 2015-02-21, źródłem operacji kopiowania obiektu blob może być plik platformy Azure na dowolnym koncie usługi Azure Storage. Tylko konta magazynu utworzone w dniu 7 czerwca 2012 r. zezwalają na kopiowanie kopii obiektu blob z innego konta magazynu lub po tym, jak 7 czerwca 2012 r.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob

Przykład użycia automatycznego sondowania:

const copyPoller = await blobClient.beginCopyFromURL('url');
const result = await copyPoller.pollUntilDone();

Przykład użycia ręcznego sondowania:

const copyPoller = await blobClient.beginCopyFromURL('url');
while (!poller.isDone()) {
   await poller.poll();
}
const result = copyPoller.getResult();

Przykład użycia aktualizacji postępu:

const copyPoller = await blobClient.beginCopyFromURL('url', {
  onProgress(state) {
    console.log(`Progress: ${state.copyProgress}`);
  }
});
const result = await copyPoller.pollUntilDone();

Przykład użycia zmieniającego się interwału sondowania (domyślnie 15 sekund):

const copyPoller = await blobClient.beginCopyFromURL('url', {
  intervalInMs: 1000 // poll blob every 1 second for copy progress
});
const result = await copyPoller.pollUntilDone();

Przykład użycia anulowania kopiowania:

const copyPoller = await blobClient.beginCopyFromURL('url');
// cancel operation after starting it.
try {
  await copyPoller.cancelOperation();
  // calls to get the result now throw PollerCancelledError
  await copyPoller.getResult();
} catch (err) {
  if (err.name === 'PollerCancelledError') {
    console.log('The copy was cancelled.');
  }
}

function beginCopyFromURL(copySource: string, options?: BlobBeginCopyFromURLOptions): Promise<PollerLikeWithCancellation<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>

Parametry

copySource

string

adres URL do źródłowego obiektu blob/pliku platformy Azure.

options
BlobBeginCopyFromURLOptions

Opcjonalne opcje operacji Rozpocznij kopiowanie z adresu URL obiektu blob.

Zwraca

Promise<PollerLikeWithCancellation<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>

Dziedziczone zobiektu BlobClient.beginCopyFromURL

createSnapshot(BlobCreateSnapshotOptions)

Tworzy migawkę obiektu blob tylko do odczytu.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob

function createSnapshot(options?: BlobCreateSnapshotOptions): Promise<BlobCreateSnapshotResponse>

Parametry

options
BlobCreateSnapshotOptions

Opcjonalne opcje operacji tworzenia migawki obiektu blob.

Zwraca

Promise<BlobCreateSnapshotResponse>

Dziedziczone zobiektu BlobClient.createSnapshot

delete(BlobDeleteOptions)

Oznacza określony obiekt blob lub migawkę do usunięcia. Obiekt blob zostanie później usunięty podczas odzyskiwania pamięci. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba te elementy można usunąć jednocześnie za pomocą operacji Usuń obiekt blob.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob

function delete(options?: BlobDeleteOptions): Promise<BlobDeleteResponse>

Parametry

options
BlobDeleteOptions

Opcjonalne opcje operacji usuwania obiektów blob.

Zwraca

Promise<BlobDeleteResponse>

Dziedziczone zobiektu BlobClient.delete

deleteIfExists(BlobDeleteOptions)

Oznacza określony obiekt blob lub migawkę do usunięcia, jeśli istnieje. Obiekt blob zostanie później usunięty podczas odzyskiwania pamięci. Należy pamiętać, że aby usunąć obiekt blob, należy usunąć wszystkie jego migawki. Oba te elementy można usunąć jednocześnie za pomocą operacji Usuń obiekt blob.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob

function deleteIfExists(options?: BlobDeleteOptions): Promise<BlobDeleteIfExistsResponse>

Parametry

options
BlobDeleteOptions

Opcjonalne opcje operacji usuwania obiektów blob.

Zwraca

Promise<BlobDeleteIfExistsResponse>

Dziedziczone zobiektu BlobClient.deleteIfExists

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

Usuń zasady niezmienności w obiekcie blob.

function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions): Promise<BlobDeleteImmutabilityPolicyResponse>

Parametry

options
BlobDeleteImmutabilityPolicyOptions

Opcjonalne opcje usuwania zasad niezmienności w obiekcie blob.

Zwraca

Promise<BlobDeleteImmutabilityPolicyResponse>

Dziedziczone zobiektu BlobClient.deleteImmutabilityPolicy

download(number, number, BlobDownloadOptions)

Odczytuje lub pobiera obiekt blob z systemu, w tym jego metadane i właściwości. Możesz również wywołać metodę Pobierz obiekt blob, aby odczytać migawkę.

  • W Node.js dane są zwracane w strumieniu czytelnym do odczytuStreamBody
  • W przeglądarkach dane są zwracane w obiekcie blob Promise

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob

function download(offset?: number, count?: number, options?: BlobDownloadOptions): Promise<BlobDownloadResponseParsed>

Parametry

offset

number

Z której pozycji obiektu blob do pobrania, większe lub równe 0

count

number

Ilość danych do pobrania, większa niż 0. Spowoduje pobranie do końca, gdy niezdefiniowane

options
BlobDownloadOptions

Opcjonalne opcje operacji pobierania obiektów blob.

Przykładowe użycie (Node.js):

// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await streamToBuffer(downloadBlockBlobResponse.readableStreamBody);
console.log("Downloaded blob content:", downloaded.toString());

async function streamToBuffer(readableStream) {
return new Promise((resolve, reject) => {
const chunks = [];
readableStream.on("data", (data) => {
chunks.push(data instanceof Buffer ? data : Buffer.from(data));
});
readableStream.on("end", () => {
resolve(Buffer.concat(chunks));
});
readableStream.on("error", reject);
});
}

Przykładowe użycie (przeglądarka):

// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await blobToString(await downloadBlockBlobResponse.blobBody);
console.log(
  "Downloaded blob content",
  downloaded
);

async function blobToString(blob: Blob): Promise<string> {
  const fileReader = new FileReader();
  return new Promise<string>((resolve, reject) => {
    fileReader.onloadend = (ev: any) => {
      resolve(ev.target!.result);
    };
    fileReader.onerror = reject;
    fileReader.readAsText(blob);
  });
}

Zwraca

Promise<BlobDownloadResponseParsed>

Dziedziczone zobiektu BlobClient.download

downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

DOSTĘPNE TYLKO W ŚRODOWISKU URUCHOMIENIOWYM NODE.JS.

Pobiera obiekt blob platformy Azure równolegle do buforu. Przesunięcie i liczba są opcjonalne, pobiera cały obiekt blob, jeśli nie zostały podane.

Ostrzeżenie: Bufory mogą obsługiwać tylko pliki do około jednego gigabajta w systemach 32-bitowych lub około dwóch gigabajtów w systemach 64-bitowych z powodu ograniczeń Node.js/V8. W przypadku obiektów blob większych niż ten rozmiar rozważ pobranie pliku DownloadToFile.

function downloadToBuffer(buffer: Buffer, offset?: number, count?: number, options?: BlobDownloadToBufferOptions): Promise<Buffer>

Parametry

buffer

Buffer

Bufor do wypełnienia, musi mieć długość większą niż liczba

offset

number

Z której pozycji blokowego obiektu blob do pobrania (w bajtach)

count

number

Ilość danych (w bajtach) do pobrania. Pobieranie do końca podczas przekazywania niezdefiniowanych

options
BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

Zwraca

Promise<Buffer>

Dziedziczone zobiektu BlobClient.downloadToBuffer

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

DOSTĘPNE TYLKO W ŚRODOWISKU URUCHOMIENIOWYM NODE.JS.

Pobiera obiekt blob platformy Azure równolegle do buforu. Przesunięcie i liczba są opcjonalne, pobiera cały obiekt blob, jeśli nie zostały podane.

Ostrzeżenie: Bufory mogą obsługiwać tylko pliki do około jednego gigabajta w systemach 32-bitowych lub około dwóch gigabajtów w systemach 64-bitowych z powodu ograniczeń Node.js/V8. W przypadku obiektów blob większych niż ten rozmiar rozważ pobranie PlikuToFile.

function downloadToBuffer(offset?: number, count?: number, options?: BlobDownloadToBufferOptions): Promise<Buffer>

Parametry

offset

number

Z której pozycji blokowego obiektu blob do pobrania (w bajtach)

count

number

Ile danych (w bajtach) ma zostać pobranych. Pobierze na koniec po przekazaniu niezdefiniowanego

options
BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

Zwraca

Promise<Buffer>

Dziedziczone zobiektu BlobClient.downloadToBuffer

downloadToFile(string, number, number, BlobDownloadOptions)

DOSTĘPNE TYLKO W ŚRODOWISKU URUCHOMIENIOWYM NODE.JS.

Pobiera obiekt blob platformy Azure do pliku lokalnego. Nie powiedzie się, jeśli dana ścieżka pliku zostanie już zakończona. Przesunięcie i liczba są opcjonalne, przekaż odpowiednio 0 i niezdefiniowane, aby pobrać cały obiekt blob.

function downloadToFile(filePath: string, offset?: number, count?: number, options?: BlobDownloadOptions): Promise<BlobDownloadResponseParsed>

Parametry

filePath

string

offset

number

Z której pozycji blokowego obiektu blob do pobrania.

count

number

Ile danych należy pobrać. Zostanie pobrany na koniec po przekazaniu niezdefiniowanego.

options
BlobDownloadOptions

Opcje pobierania obiektów blob.

Zwraca

Promise<BlobDownloadResponseParsed>

Dane odpowiedzi dla operacji pobierania obiektów blob, ale z funkcją readableStreamBody ustawioną na niezdefiniowaną, ponieważ jego zawartość jest już odczytywana i zapisywana w pliku lokalnym w określonej ścieżce.

Dziedziczone zobiektu BlobClient.downloadToFile

exists(BlobExistsOptions)

Zwraca wartość true, jeśli istnieje zasób obiektu blob platformy Azure reprezentowany przez tego klienta; false w przeciwnym razie.

UWAGA: użyj tej funkcji z opieką, ponieważ istniejący obiekt blob może zostać usunięty przez innych klientów lub aplikacji. Na odwrót nowe obiekty blob mogą zostać dodane przez innych klientów lub aplikacje po zakończeniu tej funkcji.

function exists(options?: BlobExistsOptions): Promise<boolean>

Parametry

options
BlobExistsOptions

opcje operacji Istnieje.

Zwraca

Promise<boolean>

Dziedziczone zobiektu BlobClient.exists

generateSasUrl(BlobGenerateSasUrlOptions)

Jest dostępny tylko dla obiektu BlobClient skonstruowanego przy użyciu poświadczeń klucza współdzielonego.

Generuje identyfikator URI sygnatury dostępu współdzielonego (SAS) usługi Blob Service na podstawie właściwości i parametrów klienta przekazanych. Sygnatura dostępu współdzielonego jest podpisana przez poświadczenia klucza współdzielonego klienta.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas

function generateSasUrl(options: BlobGenerateSasUrlOptions): Promise<string>

Parametry

options
BlobGenerateSasUrlOptions

Parametry opcjonalne.

Zwraca

Promise<string>

Identyfikator URI sygnatury dostępu współdzielonego składający się z identyfikatora URI zasobu reprezentowanego przez tego klienta, a następnie wygenerowany token SAS.

Dziedziczone zobiektu BlobClient.generateSasUrl

getAppendBlobClient()

Tworzy obiekt AppendBlobClient.

function getAppendBlobClient(): AppendBlobClient

Zwraca

AppendBlobClient

Dziedziczone z obiektuBlobClient.getAppendBlobClient

getBlobLeaseClient(string)

Pobierz obiekt BlobLeaseClient , który zarządza dzierżawami obiektu blob.

function getBlobLeaseClient(proposeLeaseId?: string): BlobLeaseClient

Parametry

proposeLeaseId

string

Początkowy proponowany identyfikator dzierżawy.

Zwraca

BlobLeaseClient

Nowy obiekt BlobLeaseClient do zarządzania dzierżawami w obiekcie blob.

Dziedziczone z obiektuBlobClient.getBlobLeaseClient

getBlockBlobClient()

Tworzy obiekt BlockBlobClient.

function getBlockBlobClient(): BlockBlobClient

Zwraca

BlockBlobClient

Dziedziczone z obiektuBlobClient.getBlockBlobClient

getPageBlobClient()

Tworzy obiekt PageBlobClient.

function getPageBlobClient(): PageBlobClient

Zwraca

PageBlobClient

Dziedziczone z obiektuBlobClient.getPageBlobClient

getProperties(BlobGetPropertiesOptions)

Zwraca wszystkie metadane zdefiniowane przez użytkownika, standardowe właściwości HTTP i właściwości systemu dla obiektu blob. Nie zwraca zawartości obiektu blob.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties

OSTRZEŻENIE: metadata Obiekt zwrócony w odpowiedzi będzie miał swoje klucze w małych literach, nawet jeśli pierwotnie zawierał wielkie litery. Różni się to od kluczy metadanych zwracanych przez metody ContainerClient , które wyświetlają listę obiektów blob przy użyciu includeMetadata opcji , która zachowa oryginalną wielkość liter.

function getProperties(options?: BlobGetPropertiesOptions): Promise<BlobGetPropertiesResponse>

Parametry

options
BlobGetPropertiesOptions

Opcjonalne opcje operacji Pobierz właściwości.

Zwraca

Promise<BlobGetPropertiesResponse>

Dziedziczone z obiektuBlobClient.getProperties

getTags(BlobGetTagsOptions)

Pobiera tagi skojarzone z bazowym obiektem blob.

function getTags(options?: BlobGetTagsOptions): Promise<BlobGetTagsResponse>

Parametry

options
BlobGetTagsOptions

Zwraca

Promise<BlobGetTagsResponse>

Dziedziczone zobiektu BlobClient.getTags

setAccessTier(string, BlobSetTierOptions)

Ustawia warstwę obiektu 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 https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier

function setAccessTier(tier: string, options?: BlobSetTierOptions): Promise<BlobSetTierResponse>

Parametry

tier

string

Warstwa, która ma zostać ustawiona na obiekcie blob. Prawidłowe wartości to Gorąca, Chłodna lub Archiwum.

options
BlobSetTierOptions

Opcjonalne opcje operacji Set Tier zestawu obiektów blob.

Zwraca

Promise<BlobSetTierResponse>

Dziedziczone zobiektu BlobClient.setAccessTier

setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

Ustawia właściwości systemowe obiektu blob.

Jeśli nie podano żadnej wartości lub nie podano żadnej wartości dla określonych nagłówków HTTP obiektu blob, te nagłówki HTTP obiektu blob bez wartości zostaną wyczyszczone.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties

function setHTTPHeaders(blobHTTPHeaders?: BlobHTTPHeaders, options?: BlobSetHTTPHeadersOptions): Promise<BlobSetHTTPHeadersResponse>

Parametry

blobHTTPHeaders
BlobHTTPHeaders

Jeśli nie podano żadnej wartości lub nie podano żadnej wartości dla określonych nagłówków HTTP obiektu blob, te nagłówki HTTP obiektu blob bez wartości zostaną wyczyszczone. Typowy nagłówek do ustawienia umożliwia blobContentType przeglądarce zapewnienie funkcjonalności na podstawie typu pliku.

options
BlobSetHTTPHeadersOptions

Opcjonalne opcje operacji Ustawianie nagłówków HTTP dla obiektu blob.

Zwraca

Promise<BlobSetHTTPHeadersResponse>

Dziedziczone zobiektu BlobClient.setHTTPHeaders

setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

Ustaw zasady niezmienności w obiekcie blob.

function setImmutabilityPolicy(immutabilityPolicy: BlobImmutabilityPolicy, options?: BlobSetImmutabilityPolicyOptions): Promise<BlobSetImmutabilityPolicyResponse>

Parametry

immutabilityPolicy
BlobImmutabilityPolicy
options
BlobSetImmutabilityPolicyOptions

Opcjonalne opcje ustawiania zasad niezmienności w obiekcie blob.

Zwraca

Promise<BlobSetImmutabilityPolicyResponse>

Dziedziczone zobiektu BlobClient.setImmutabilityPolicy

setLegalHold(boolean, BlobSetLegalHoldOptions)

Ustaw blokadę prawną obiektu blob.

function setLegalHold(legalHoldEnabled: boolean, options?: BlobSetLegalHoldOptions): Promise<BlobSetLegalHoldResponse>

Parametry

legalHoldEnabled

boolean

options
BlobSetLegalHoldOptions

Opcjonalne opcje ustawiania blokady prawnej obiektu blob.

Zwraca

Promise<BlobSetLegalHoldResponse>

Dziedziczone zobiektu BlobClient.setLegalHold

setMetadata(Metadata, BlobSetMetadataOptions)

Ustawia metadane zdefiniowane przez użytkownika dla określonego obiektu blob jako jedną lub więcej par name-value.

Jeśli nie podano żadnej opcji lub żadne metadane zdefiniowane w parametrze, metadane obiektu blob zostaną usunięte.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata

function setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions): Promise<BlobSetMetadataResponse>

Parametry

metadata
Metadata

Zastąp istniejące metadane tą wartością. Jeśli żadna wartość nie zostanie podana, istniejące metadane zostaną usunięte.

options
BlobSetMetadataOptions

Opcjonalne opcje ustawiania operacji metadanych.

Zwraca

Promise<BlobSetMetadataResponse>

Dziedziczone z obiektuBlobClient.setMetadata

setTags(Tags, BlobSetTagsOptions)

Ustawia tagi w bazowym obiekcie blob. Obiekt blob może mieć maksymalnie 10 tagów. Klucze tagów muszą zawierać od 1 do 128 znaków. Wartości tagów muszą zawierać od 0 do 256 znaków. Prawidłowe znaki klucza tagu i wartości obejmują małe i wielkie litery, cyfry (0–9), spację (' '), plus ('+'), minus ('-'), kropkę ('.'), ukośnik ('/'), dwukropek (':'), równe ('=') i podkreślenie ('_') .

function setTags(tags: Tags, options?: BlobSetTagsOptions): Promise<BlobSetTagsResponse>

Parametry

tags
Tags
options
BlobSetTagsOptions

Zwraca

Promise<BlobSetTagsResponse>

Dziedziczone zobiektu BlobClient.setTags

syncCopyFromURL(string, BlobSyncCopyFromURLOptions)

Synchroniczna operacja kopiowania z adresu URL kopiuje obiekt blob lub zasób internetowy do nowego obiektu blob. Nie zwróci odpowiedzi, dopóki kopia nie zostanie ukończona.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url

function syncCopyFromURL(copySource: string, options?: BlobSyncCopyFromURLOptions): Promise<BlobCopyFromURLResponse>

Parametry

copySource

string

Źródłowy adres URL do skopiowania sygnatury dostępu współdzielonego (SAS) może być potrzebny do uwierzytelniania

options
BlobSyncCopyFromURLOptions

Zwraca

Promise<BlobCopyFromURLResponse>

Dziedziczone zobiektu BlobClient.syncCopyFromURL

undelete(BlobUndeleteOptions)

Przywraca zawartość i metadane nietrwałego usuniętego obiektu blob oraz wszystkie skojarzone nietrwale usunięte migawki. Cofanie obiektu blob jest obsługiwane tylko w wersji 2017-07-29 lub nowszej.

Zobacz https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob

function undelete(options?: BlobUndeleteOptions): Promise<BlobUndeleteResponse>

Parametry

options
BlobUndeleteOptions

Opcjonalne opcje operacji cofania operacji cofania obiektu blob.

Zwraca

Promise<BlobUndeleteResponse>

Dziedziczone zobiektu BlobClient.undelete

withVersion(string)

Tworzy nowy obiekt BlobClient wskazujący wersję tego obiektu blob. Podaj wartość "" spowoduje usunięcie identyfikatora versionId i zwrócenie klienta do podstawowego obiektu blob.

function withVersion(versionId: string): BlobClient

Parametry

versionId

string

VersionId.

Zwraca

BlobClient

Nowy obiekt BlobClient wskazujący wersję tego obiektu blob.

Dziedziczone zobiektu BlobClient.withVersion