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


BlockBlobClient class

A BlockBlobClient a blokkblobokra alkalmazható műveletek halmazát határozza meg.

Extends

Konstruktorok

BlockBlobClient(string, PipelineLike)

Létrehozza a BlockBlobClient egy példányát. Ez a metódus egy kódolt VAGY nem kódolt URL-címet fogad el, amely egy blokkblobra mutat. A kódolt URL-sztring NEM lesz kétszer feloldva, csak az URL-elérési út speciális karakterei lesznek feloldva. Ha egy blobnév tartalmazza a következőt: ? vagy %, a blob nevét az URL-címben kell kódolni.

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

Létrehozza a BlockBlobClient egy példányát. Ez a metódus egy kódolt VAGY nem kódolt URL-címet fogad el, amely egy blokkblobra mutat. A kódolt URL-sztring NEM lesz kétszer feloldva, csak az URL-elérési út speciális karakterei lesznek feloldva. Ha egy blobnév tartalmazza a következőt: ? vagy %, a blob nevét az URL-címben kell kódolni.

BlockBlobClient(string, string, string, StoragePipelineOptions)

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

Tulajdonságok

accountName
containerName

Annak a tárolónak a neve, amelyhez a blob társítva van.

credential

Például AnonymousCredential, StorageSharedKeyCredential vagy bármilyen hitelesítő adat a csomagból a @azure/identity szolgáltatás felé irányuló kérések hitelesítéséhez. Megadhat egy objektumot is, amely implementálja a TokenCredential felületet. Ha nincs megadva, a rendszer AnonymousCredential értéket használ.

name

A blob neve.

url

Kódolt URL-sztringérték.

Metódusok

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

Megszakít egy függőben lévő aszinkron blobmásolási műveletet, és egy nulla hosszúságú és teljes metaadatokat tartalmazó célblobot hagy. 2012-02-12-es és újabb verzió.

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

Aszinkron módon másol egy blobot a tárfiókon belüli célhelyre. Ez a metódus egy hosszú ideig futó műveletet ad vissza, amely lehetővé teszi, hogy határozatlan ideig várjon, amíg a másolás befejeződik. A másolatot a lekérdező hívásával cancelOperation is megszakíthatja, mielőtt befejeződik. Vegye figyelembe, hogy az onProgress visszahívás nem lesz meghívva, ha a művelet az első kérelemben befejeződik, és a befejezett másolat visszavonásának megkísérlése hibát eredményez. A 2012-02-12-es és újabb verzióban a Másolási blob művelet forrása bármely Azure-tárfiókban véglegesített blob lehet. A 2015-02-21-es verziótól kezdődően a Blob másolása művelet forrása egy Azure-fájl lehet bármely Azure-tárfiókban. Csak a 2012. június 7-én vagy azt követően létrehozott tárfiókok engedélyezik a Blob másolása művelet másolását egy másik tárfiókból.

commitBlockList(string[], BlockBlobCommitBlockListOptions)

Blob írása a blobot alkotó blokkazonosítók listájának megadásával. Ahhoz, hogy egy blob részeként lehessen írni, egy blokkot sikeresen meg kell írni a kiszolgálóra egy korábbi <xref:stageBlock> művelet során. A blob frissítéséhez hívhatja <xref:commitBlockList> meg, ha csak azokat a blokkokat tölti fel, amelyek módosultak, majd véglegesíti az új és a meglévő blokkokat. A blokklistában nem megadott és véglegesen törölt blokkok.

createSnapshot(BlobCreateSnapshotOptions)

Egy blob írásvédett pillanatképét hozza létre.

delete(BlobDeleteOptions)

Megjelöli a megadott blobot vagy pillanatképet a törléshez. A blob később törlődik a szemétgyűjtés során. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. Mindkettőt egyszerre törölheti a Blob törlése művelettel.

deleteIfExists(BlobDeleteOptions)

Megjelöli a megadott blobot vagy pillanatképet a törléshez, ha létezik. A blob később törlődik a szemétgyűjtés során. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. Mindkettőt egyszerre törölheti a Blob törlése művelettel.

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

Törölje az immutablility szabályzatot a blobon.

download(number, number, BlobDownloadOptions)

Egy blobot olvas be vagy tölt le a rendszerből, beleértve annak metaadatait és tulajdonságait. A Pillanatképek olvasásához meghívhatja a Blob lekérése parancsot is.

  • A Node.js az adatok egy olvasható adatfolyamban, olvashatóStreamBody-ban térnek vissza
  • A böngészőkben az adatok egy ígéret blobBody-ban térnek vissza
downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Egy Azure-blobot tölt le párhuzamosan egy pufferrel. Az eltolás és a darabszám megadása nem kötelező, a teljes blobot letölti, ha nincsenek megadva.

Figyelmeztetés: A pufferek legfeljebb egy gigabájt méretű fájlokat támogatnak 32 bites rendszereken, vagy körülbelül két gigabájtot a 64 bites rendszereken a Node.js/V8 korlátozásai miatt. Az ennél nagyobb méretű blobok esetében vegye figyelembe a következőt <xref:downloadToFile>: .

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Egy Azure-blobot tölt le párhuzamosan egy pufferrel. Az eltolás és a darabszám megadása nem kötelező, a teljes blobot letölti, ha nincsenek megadva.

Figyelmeztetés: A pufferek legfeljebb egy gigabájt méretű fájlokat támogatnak 32 bites rendszereken, vagy körülbelül két gigabájtot a 64 bites rendszereken a Node.js/V8 korlátozásai miatt. Az ennél nagyobb méretű blobok esetében vegye figyelembe a következőt <xref:downloadToFile>: .

downloadToFile(string, number, number, BlobDownloadOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Letölt egy Azure Blobot egy helyi fájlba. Sikertelen, ha a megadott fájl elérési útja már kilép. Az eltolás és a darabszám megadása nem kötelező, a teljes blob letöltéséhez pass 0 és undefined értéket ad meg.

exists(BlobExistsOptions)

Igaz értéket ad vissza, ha az ügyfél által képviselt Azure Blob-erőforrás létezik; máskülönben hamis. MEGJEGYZÉS: Ezt a függvényt körültekintően használja, mivel előfordulhat, hogy egy meglévő blobot más ügyfelek vagy alkalmazások törölnek. Fordítva, előfordulhat, hogy más ügyfelek vagy alkalmazások új blobokat adnak hozzá a függvény befejezése után.

generateSasUrl(BlobGenerateSasUrlOptions)

Csak megosztott kulcsú hitelesítő adatokkal létrehozott BlobClient esetén érhető el. Létrehoz egy Blob Service megosztott hozzáférésű jogosultságkód (SAS) URI-t a megadott ügyféltulajdonságok és paraméterek alapján. Az SAS-t az ügyfél megosztott kulcsú hitelesítő adatai írták alá.

getAppendBlobClient()

Létrehoz egy AppendBlobClient objektumot.

getBlobLeaseClient(string)

Szerezzen be egy olyant <xref:BlobLeaseClient> , amely kezeli a blob bérleteit.

getBlockBlobClient()

Létrehoz egy BlockBlobClient objektumot.

getBlockList(BlockListType, BlockBlobGetBlockListOptions)

A blokkblob részeként a megadott blokklistaszűrővel feltöltött blokkok listáját adja vissza.

getPageBlobClient()

Létrehoz egy PageBlobClient objektumot.

getProperties(BlobGetPropertiesOptions)

A blob összes felhasználó által definiált metaadatát, szabványos HTTP-tulajdonságát és rendszertulajdonságát adja vissza. Nem adja vissza a blob tartalmát.

getTags(BlobGetTagsOptions)

Lekéri a mögöttes blobhoz társított címkéket.

query(string, BlockBlobQueryOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. JSON- vagy CSV-formátumú blob gyors lekérdezése.

Példahasználat (Node.js):

// Query and convert a blob to a string
const queryBlockBlobResponse = await blockBlobClient.query("select * from BlobStorage");
const downloaded = (await streamToBuffer(queryBlockBlobResponse.readableStreamBody)).toString();
console.log("Query blob content:", downloaded);

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);
  });
}
setAccessTier(BlockBlobTier | PremiumPageBlobTier | string, BlobSetTierOptions)

Beállítja a szintet egy blobon. A művelet egy prémium szintű tárfiók lapblobján és blobtároló-fiók blokkblobján engedélyezett (csak helyileg redundáns tárolás). A prémium szintű lapblobok szintje határozza meg a blob megengedett 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.

setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

Beállítja a blob rendszertulajdonságokat. Ha nincs megadva érték, vagy a megadott blob HTTP-fejléceihez nincs megadva érték, ezek a blob HTTP-fejlécek érték nélkül törlődnek.

setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

Állítsa be az immutablility szabályzatot a blobon.

setLegalHold(boolean, BlobSetLegalHoldOptions)

Jogi célú visszatartás beállítása a blobon.

setMetadata(Metadata, BlobSetMetadataOptions)

A megadott blob felhasználó által definiált metaadatait egy vagy több név-érték párként állítja be. Ha nincs megadva lehetőség, vagy nincs megadva metaadat a paraméterben, a blob metaadatai el lesznek távolítva.

setTags(Tags, BlobSetTagsOptions)

Beállítja a címkéket a mögöttes blobon. Egy blob legfeljebb 10 címkével rendelkezhet. A címkebillentyűknek 1 és 128 karakter közöttinek kell lenniük. A címkeértékek 0 és 256 karakter közöttiek lehetnek. Az érvényes címkekulcs- és értékkarakterek közé tartoznak az alsó és nagybetűk, a számjegyek (0-9), a szóköz (' '), a plusz ('+'), a mínusz ('-'), a pont ('.'), a perjel ('/'), a kettőspont (':'), az egyenlő ('=') és az aláhúzásjel ('_').

stageBlock(string, HttpRequestBody, number, BlockBlobStageBlockOptions)

Feltölti a megadott blokkot a blokkblob "előkészítési területére", hogy később véglegesítse a commitBlockList hívása.

stageBlockFromURL(string, string, number, number, BlockBlobStageBlockFromURLOptions)

A Fázisblokk url-címből művelet létrehoz egy új blokkot, amely egy blob részeként lesz véglegesítve, ahol a tartalom egy URL-címről lesz beolvasva. Ez az API a 2018-03-28-es verziótól érhető el.

syncCopyFromURL(string, BlobSyncCopyFromURLOptions)

A szinkron Másolás URL-címről művelet egy blobot vagy internetes erőforrást másol egy új blobba. Nem ad vissza választ, amíg a másolat be nem fejeződik.

syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)

Létrehoz egy új blokkblobot, amelyben a blob tartalma egy adott URL-címről lesz beolvasva. Ez az API a 2020.04.08-i verziótól kezdve támogatott. A részleges frissítések nem támogatottak a Put Blob from URL-címmel; egy meglévő blob tartalma felülíródik az új blob tartalmával. Ha részleges frissítéseket szeretne végrehajtani egy blokkblob tartalmának egy forrás URL-cím használatával, használja a és <xref:commitBlockList>a parancsot<xref:stageBlockFromURL>.

undelete(BlobUndeleteOptions)

Visszaállítja a helyreállíthatóan törölt blobok és a kapcsolódó helyreállíthatóan törölt pillanatképek tartalmát és metaadatait. A Blob törlése csak a 2017-07-29-es vagy újabb verzióban támogatott.

upload(HttpRequestBody, number, BlockBlobUploadOptions)

Új blokkblobot hoz létre, vagy frissíti egy meglévő blokkblob tartalmát. Egy meglévő blokkblob frissítése felülírja a blob meglévő metaadatait. A részleges frissítések nem támogatottak; a meglévő blob tartalma felülíródik az új tartalommal. A blokkblobok részleges frissítéséhez használja <xref:stageBlock> a és <xref:commitBlockList>a parancsot. Ez egy nem párhuzamos feltöltési módszer. Használja <xref:uploadFile><xref:uploadStream> a vagy <xref:uploadBrowserData> a parancsot az egyidejű feltöltés jobb teljesítményéhez.

uploadBrowserData(Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

CSAK BÖNGÉSZŐKBEN ÉRHETŐ EL. Feltölt egy böngészőblobot/fájlt/tömbbuffert/tömbbufferView objektumot a blob blokkolásához.

Ha a puffer hossza kisebb vagy egyenlő 256 MB-nál, ez a metódus 1 feltöltési hívást használ a feltöltés befejezéséhez. Ellenkező esetben ez a metódus meghívja <xref:stageBlock> a blokkok feltöltését, és végül meghívja <xref:commitBlockList> a blokklista véglegesítését.

A beállítás gyakori <xref:BlockBlobParallelUploadOptions.blobHTTPHeaders> lehetősége a blobContentType, amely lehetővé teszi, hogy a böngésző a fájltípus alapján biztosítson funkciókat.

uploadData(Buffer | Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

Feltölt egy Buffer(Node.js)/Blob(browsers)/ArrayBuffer/ArrayBufferView objektumot egy BlockBlobba. Ha az adathossz nem nagyobb, mint a specifiled <xref:BlockBlobParallelUploadOptions.maxSingleShotSize> (alapértelmezés szerint <xref:BLOCK_BLOB_MAX_UPLOAD_BLOB_BYTES>), ez a metódus 1 <xref:upload> hívást használ a feltöltés befejezéséhez. Ellenkező esetben ez a metódus meghívja <xref:stageBlock> a blokkok feltöltését, és végül meghívja <xref:commitBlockList> a blokklista véglegesítését.

A beállítás gyakori <xref:BlockBlobParallelUploadOptions.blobHTTPHeaders> lehetősége a blobContentType, amely lehetővé teszi, hogy a böngésző a fájltípus alapján biztosítson funkciókat.

uploadFile(string, BlockBlobParallelUploadOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Blokkokban lévő helyi fájlt tölt fel egy blokkblobba.

Ha a fájlméret kisebb vagy egyenlő 256 MB-nál, ez a metódus 1 feltöltési hívást használ a feltöltés befejezéséhez. Ellenkező esetben ez a metódus meghívja a stageBlock metódust blokkok feltöltéséhez, és végül meghívja a commitBlockList metódust a blokklista véglegesítéséhez.

uploadStream(Readable, number, number, BlockBlobUploadStreamOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Egy Node.js olvasható streamet tölt fel blokkblobba.

TELJESÍTMÉNNYEL KAPCSOLATOS TIPPEK:

  • A highWaterMark bemeneti adatfolyam jobb, ha ugyanazt az értéket a bufferSize paraméterrel állítja be, így elkerülhetők a Buffer.concat() műveletek.
withSnapshot(string)

Létrehoz egy új BlockBlobClient objektumot, amely megegyezik a forrással, de a megadott pillanatkép-időbélyeggel. Adja meg a "" lehetőséget, amely eltávolítja a pillanatképet, és visszaad egy URL-címet az alapblobnak.

withVersion(string)

Létrehoz egy új BlobClient objektumot, amely ennek a blobnak egy verziójára mutat. A "" megadása eltávolítja a versionId azonosítót, és egy ügyfelet ad vissza az alapblobnak.

Konstruktor adatai

BlockBlobClient(string, PipelineLike)

Létrehozza a BlockBlobClient egy példányát. Ez a metódus egy kódolt VAGY nem kódolt URL-címet fogad el, amely egy blokkblobra mutat. A kódolt URL-sztring NEM lesz kétszer feloldva, csak az URL-elérési út speciális karakterei lesznek feloldva. Ha egy blobnév tartalmazza a következőt: ? vagy %, a blob nevét az URL-címben kell kódolni.

new BlockBlobClient(url: string, pipeline: PipelineLike)

Paraméterek

url

string

Egy Azure Storage-blokkblobra mutató URL-sztring, például "https://myaccount.blob.core.windows.net/mycontainer/blockblob". Sas hozzáfűzhető, ha AnonymousCredential (pl. "https://myaccount.blob.core.windows.net/mycontainer/blockblob?sasString") használatával használja. Ez a metódus egy kódolt VAGY nem kódolt URL-címet fogad el, amely egy blobra mutat. A kódolt URL-sztring NEM lesz kétszer feloldva, csak az URL-elérési út speciális karakterei lesznek feloldva. Ha azonban egy blobnév tartalmazza a következőt: ? vagy %, a blob nevét az URL-címben kell kódolni. A "my?blob%" nevű blobhoz hasonlóan az URL-címnek "https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25"" kell lennie.

pipeline
PipelineLike

Hívja meg a newPipeline() metódust egy alapértelmezett folyamat létrehozásához, vagy adjon meg egy testre szabott folyamatot.

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

Létrehozza a BlockBlobClient egy példányát. Ez a metódus egy kódolt VAGY nem kódolt URL-címet fogad el, amely egy blokkblobra mutat. A kódolt URL-sztring NEM lesz kétszer feloldva, csak az URL-elérési út speciális karakterei lesznek feloldva. Ha egy blobnév tartalmazza a következőt: ? vagy %, a blob nevét az URL-címben kell kódolni.

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

Paraméterek

url

string

Egy Azure Storage-blokkblobra mutató URL-sztring, például "https://myaccount.blob.core.windows.net/mycontainer/blockblob". Sas hozzáfűzhető, ha AnonymousCredential (pl. "https://myaccount.blob.core.windows.net/mycontainer/blockblob?sasString") használatával használja. Ez a metódus egy kódolt VAGY nem kódolt URL-címet fogad el, amely egy blobra mutat. A kódolt URL-sztring NEM lesz kétszer feloldva, csak az URL-elérési út speciális karakterei lesznek feloldva. Ha azonban egy blobnév tartalmazza a következőt: ? vagy %, a blob nevét az URL-címben kell kódolni. A "my?blob%" nevű blobhoz hasonlóan az URL-címnek "https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25"" kell lennie.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Például AnonymousCredential, StorageSharedKeyCredential vagy bármilyen hitelesítő adat a csomagból a @azure/identity szolgáltatás felé irányuló kérések hitelesítéséhez. Megadhat egy objektumot is, amely implementálja a TokenCredential felületet. Ha nincs megadva, a rendszer AnonymousCredential értéket használ.

options
StoragePipelineOptions

Választható. A HTTP-folyamat konfigurálásának lehetőségei.

BlockBlobClient(string, string, string, StoragePipelineOptions)

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

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

Paraméterek

connectionString

string

Fiók kapcsolati sztring vagy egy Azure Storage-fiók SAS-kapcsolati sztring. [ Megjegyzés – A fiók kapcsolati sztring csak NODE.JS futtatókörnyezetben használható. ] Fiók kapcsolati sztring példa –DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.netSAS kapcsolati sztring példa –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

Tároló neve.

blobName

string

Blob neve.

options
StoragePipelineOptions

Választható. A HTTP-folyamat konfigurálásának lehetőségei.

Tulajdonság adatai

accountName

accountName: string

Tulajdonság értéke

string

containerName

Annak a tárolónak a neve, amelyhez a blob társítva van.

string containerName

Tulajdonság értéke

string

credential

Például AnonymousCredential, StorageSharedKeyCredential vagy bármilyen hitelesítő adat a csomagból a @azure/identity szolgáltatás felé irányuló kérések hitelesítéséhez. Megadhat egy objektumot is, amely implementálja a TokenCredential felületet. Ha nincs megadva, a rendszer AnonymousCredential értéket használ.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Tulajdonság értéke

name

A blob neve.

string name

Tulajdonság értéke

string

url

Kódolt URL-sztringérték.

url: string

Tulajdonság értéke

string

Metódus adatai

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

Megszakít egy függőben lévő aszinkron blobmásolási műveletet, és egy nulla hosszúságú és teljes metaadatokat tartalmazó célblobot hagy. 2012-02-12-es és újabb verzió.

function abortCopyFromURL(copyId: string, options?: BlobAbortCopyFromURLOptions)

Paraméterek

copyId

string

A Másolás URL-címről művelet azonosítója.

options
BlobAbortCopyFromURLOptions

Az URL-címről történő blobmásolás megszakítása művelet választható beállításai.

Válaszok

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

Aszinkron módon másol egy blobot a tárfiókon belüli célhelyre. Ez a metódus egy hosszú ideig futó műveletet ad vissza, amely lehetővé teszi, hogy határozatlan ideig várjon, amíg a másolás befejeződik. A másolatot a lekérdező hívásával cancelOperation is megszakíthatja, mielőtt befejeződik. Vegye figyelembe, hogy az onProgress visszahívás nem lesz meghívva, ha a művelet az első kérelemben befejeződik, és a befejezett másolat visszavonásának megkísérlése hibát eredményez. A 2012-02-12-es és újabb verzióban a Másolási blob művelet forrása bármely Azure-tárfiókban véglegesített blob lehet. A 2015-02-21-es verziótól kezdődően a Blob másolása művelet forrása egy Azure-fájl lehet bármely Azure-tárfiókban. Csak a 2012. június 7-én vagy azt követően létrehozott tárfiókok engedélyezik a Blob másolása művelet másolását egy másik tárfiókból.

function beginCopyFromURL(copySource: string, options?: BlobBeginCopyFromURLOptions)

Paraméterek

copySource

string

url-cím a forrás Azure Blob/Fájl címére.

options
BlobBeginCopyFromURLOptions

A Blob Start Copy From URL művelet választható beállításai.

Válaszok

Promise<PollerLike<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>

commitBlockList(string[], BlockBlobCommitBlockListOptions)

Blob írása a blobot alkotó blokkazonosítók listájának megadásával. Ahhoz, hogy egy blob részeként lehessen írni, egy blokkot sikeresen meg kell írni a kiszolgálóra egy korábbi <xref:stageBlock> művelet során. A blob frissítéséhez hívhatja <xref:commitBlockList> meg, ha csak azokat a blokkokat tölti fel, amelyek módosultak, majd véglegesíti az új és a meglévő blokkokat. A blokklistában nem megadott és véglegesen törölt blokkok.

function commitBlockList(blocks: string[], options?: BlockBlobCommitBlockListOptions)

Paraméterek

blocks

string[]

64 bájtos, base64 kódolású tömb

options
BlockBlobCommitBlockListOptions

A Blokkblob véglegesítési blokklista műveletének beállításai.

Válaszok

A Blokkblob véglegesítése blokklista művelet válaszadatai.

createSnapshot(BlobCreateSnapshotOptions)

Egy blob írásvédett pillanatképét hozza létre.

function createSnapshot(options?: BlobCreateSnapshotOptions)

Paraméterek

options
BlobCreateSnapshotOptions

A Blob Create Snapshot (Blob létrehozása pillanatkép létrehozása) művelet választható beállításai.

Válaszok

delete(BlobDeleteOptions)

Megjelöli a megadott blobot vagy pillanatképet a törléshez. A blob később törlődik a szemétgyűjtés során. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. Mindkettőt egyszerre törölheti a Blob törlése művelettel.

function delete(options?: BlobDeleteOptions)

Paraméterek

options
BlobDeleteOptions

A Blob törlése művelet választható lehetőségei.

Válaszok

deleteIfExists(BlobDeleteOptions)

Megjelöli a megadott blobot vagy pillanatképet a törléshez, ha létezik. A blob később törlődik a szemétgyűjtés során. Vegye figyelembe, hogy egy blob törléséhez törölnie kell az összes pillanatképét. Mindkettőt egyszerre törölheti a Blob törlése művelettel.

function deleteIfExists(options?: BlobDeleteOptions)

Paraméterek

options
BlobDeleteOptions

A Blob törlése művelet választható lehetőségei.

Válaszok

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

Törölje az immutablility szabályzatot a blobon.

function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions)

Paraméterek

options
BlobDeleteImmutabilityPolicyOptions

Választható lehetőségek a blob módosíthatósági szabályzatának törlésére.

Válaszok

download(number, number, BlobDownloadOptions)

Egy blobot olvas be vagy tölt le a rendszerből, beleértve annak metaadatait és tulajdonságait. A Pillanatképek olvasásához meghívhatja a Blob lekérése parancsot is.

  • A Node.js az adatok egy olvasható adatfolyamban, olvashatóStreamBody-ban térnek vissza
  • A böngészőkben az adatok egy ígéret blobBody-ban térnek vissza
function download(offset?: number, count?: number, options?: BlobDownloadOptions)

Paraméterek

offset

number

A letölthető blob 0-nál nagyobb vagy egyenlő pozíciója

count

number

A letöltendő adatok száma 0-nál nagyobb. A letöltés a végéig történik, ha nincs meghatározva

options
BlobDownloadOptions

A blobletöltési művelet választható lehetőségei.

Példahasználat (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);
});
}

Példahasználat (böngésző):

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

Válaszok

downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Egy Azure-blobot tölt le párhuzamosan egy pufferrel. Az eltolás és a darabszám megadása nem kötelező, a teljes blobot letölti, ha nincsenek megadva.

Figyelmeztetés: A pufferek legfeljebb egy gigabájt méretű fájlokat támogatnak 32 bites rendszereken, vagy körülbelül két gigabájtot a 64 bites rendszereken a Node.js/V8 korlátozásai miatt. Az ennél nagyobb méretű blobok esetében vegye figyelembe a következőt <xref:downloadToFile>: .

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

Paraméterek

buffer

Buffer

A kitöltendő puffernek a számnál hosszabbnak kell lennie

offset

number

A letöltendő blokkblob pozíciója (bájtban)

count

number

Mennyi adat (bájtban) tölthető le. A letöltés a végéhez ér, amikor nem definiált értéket ad át

options
BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

Válaszok

Promise<Buffer>

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Egy Azure-blobot tölt le párhuzamosan egy pufferrel. Az eltolás és a darabszám megadása nem kötelező, a teljes blobot letölti, ha nincsenek megadva.

Figyelmeztetés: A pufferek legfeljebb egy gigabájt méretű fájlokat támogatnak 32 bites rendszereken, vagy körülbelül két gigabájtot a 64 bites rendszereken a Node.js/V8 korlátozásai miatt. Az ennél nagyobb méretű blobok esetében vegye figyelembe a következőt <xref:downloadToFile>: .

function downloadToBuffer(offset?: number, count?: number, options?: BlobDownloadToBufferOptions)

Paraméterek

offset

number

A letöltendő blokkblob pozíciója (bájtban)

count

number

Mennyi adat (bájtban) tölthető le. A letöltés a végéhez ér, amikor nem definiált értéket ad át

options
BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

Válaszok

Promise<Buffer>

downloadToFile(string, number, number, BlobDownloadOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Letölt egy Azure Blobot egy helyi fájlba. Sikertelen, ha a megadott fájl elérési útja már kilép. Az eltolás és a darabszám megadása nem kötelező, a teljes blob letöltéséhez pass 0 és undefined értéket ad meg.

function downloadToFile(filePath: string, offset?: number, count?: number, options?: BlobDownloadOptions)

Paraméterek

filePath

string

offset

number

A blokkblob letöltésének helye.

count

number

Mennyi adatot kell letölteni. A letöltés a végéhez ér, amikor nem definiált értéket ad át.

options
BlobDownloadOptions

A Blob letöltési beállításai.

Válaszok

A blobletöltési művelet válaszadatai, de a readableStreamBody értéke nincs meghatározva, mivel a tartalma már be van olvasva, és egy helyi fájlba van írva a megadott elérési úton.

exists(BlobExistsOptions)

Igaz értéket ad vissza, ha az ügyfél által képviselt Azure Blob-erőforrás létezik; máskülönben hamis. MEGJEGYZÉS: Ezt a függvényt körültekintően használja, mivel előfordulhat, hogy egy meglévő blobot más ügyfelek vagy alkalmazások törölnek. Fordítva, előfordulhat, hogy más ügyfelek vagy alkalmazások új blobokat adnak hozzá a függvény befejezése után.

function exists(options?: BlobExistsOptions)

Paraméterek

options
BlobExistsOptions

a Exists (Létező) művelet beállításai.

Válaszok

Promise<boolean>

generateSasUrl(BlobGenerateSasUrlOptions)

Csak megosztott kulcsú hitelesítő adatokkal létrehozott BlobClient esetén érhető el. Létrehoz egy Blob Service megosztott hozzáférésű jogosultságkód (SAS) URI-t a megadott ügyféltulajdonságok és paraméterek alapján. Az SAS-t az ügyfél megosztott kulcsú hitelesítő adatai írták alá.

function generateSasUrl(options: BlobGenerateSasUrlOptions)

Paraméterek

options
BlobGenerateSasUrlOptions

Választható paraméterek.

Válaszok

Promise<string>

Az ügyfél által képviselt erőforrás URI-ját tartalmazó SAS URI, amelyet a létrehozott SAS-jogkivonat követ.

getAppendBlobClient()

Létrehoz egy AppendBlobClient objektumot.

function getAppendBlobClient()

Válaszok

getBlobLeaseClient(string)

Szerezzen be egy olyant <xref:BlobLeaseClient> , amely kezeli a blob bérleteit.

function getBlobLeaseClient(proposeLeaseId?: string)

Paraméterek

proposeLeaseId

string

Kezdeti javasolt bérletazonosító.

Válaszok

Egy új BlobLeaseClient objektum a blob bérleteinek kezeléséhez.

getBlockBlobClient()

Létrehoz egy BlockBlobClient objektumot.

function getBlockBlobClient()

Válaszok

getBlockList(BlockListType, BlockBlobGetBlockListOptions)

A blokkblob részeként a megadott blokklistaszűrővel feltöltött blokkok listáját adja vissza.

function getBlockList(listType: BlockListType, options?: BlockBlobGetBlockListOptions)

Paraméterek

listType
BlockListType

Meghatározza, hogy a véglegesített blokkok listáját, a nem véglegesített blokkok listáját vagy mindkét listát együtt adja-e vissza.

options
BlockBlobGetBlockListOptions

A Blokkblobok blokklista lekérése művelet beállításai.

Válaszok

A Blob blokklista lekérése művelet válaszadatai.

getPageBlobClient()

Létrehoz egy PageBlobClient objektumot.

function getPageBlobClient()

Válaszok

getProperties(BlobGetPropertiesOptions)

A blob összes felhasználó által definiált metaadatát, szabványos HTTP-tulajdonságát és rendszertulajdonságát adja vissza. Nem adja vissza a blob tartalmát.

function getProperties(options?: BlobGetPropertiesOptions)

Paraméterek

options
BlobGetPropertiesOptions

A Tulajdonságok lekérése művelet választható lehetőségei.

Válaszok

getTags(BlobGetTagsOptions)

Lekéri a mögöttes blobhoz társított címkéket.

function getTags(options?: BlobGetTagsOptions)

Paraméterek

Válaszok

query(string, BlockBlobQueryOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. JSON- vagy CSV-formátumú blob gyors lekérdezése.

Példahasználat (Node.js):

// Query and convert a blob to a string
const queryBlockBlobResponse = await blockBlobClient.query("select * from BlobStorage");
const downloaded = (await streamToBuffer(queryBlockBlobResponse.readableStreamBody)).toString();
console.log("Query blob content:", downloaded);

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);
  });
}
function query(query: string, options?: BlockBlobQueryOptions)

Paraméterek

query

string

Válaszok

setAccessTier(BlockBlobTier | PremiumPageBlobTier | string, BlobSetTierOptions)

Beállítja a szintet egy blobon. A művelet egy prémium szintű tárfiók lapblobján és blobtároló-fiók blokkblobján engedélyezett (csak helyileg redundáns tárolás). A prémium szintű lapblobok szintje határozza meg a blob megengedett 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.

function setAccessTier(tier: BlockBlobTier | PremiumPageBlobTier | string, options?: BlobSetTierOptions)

Paraméterek

tier

BlockBlobTier | PremiumPageBlobTier | string

A blobon beállítandó szint. Az érvényes értékek a gyakori elérésű, a ritka elérésű vagy az archív.

options
BlobSetTierOptions

A Blobkészlet rétege művelet választható lehetőségei.

Válaszok

setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

Beállítja a blob rendszertulajdonságokat. Ha nincs megadva érték, vagy a megadott blob HTTP-fejléceihez nincs megadva érték, ezek a blob HTTP-fejlécek érték nélkül törlődnek.

function setHTTPHeaders(blobHTTPHeaders?: BlobHTTPHeaders, options?: BlobSetHTTPHeadersOptions)

Paraméterek

blobHTTPHeaders
BlobHTTPHeaders

Ha nincs megadva érték, vagy a megadott blob HTTP-fejléceihez nincs megadva érték, ezek a blob HTTP-fejlécek érték nélkül törlődnek. Gyakori beállítási fejléc, ha blobContentType engedélyezi a böngészőnek, hogy fájltípuson alapuló funkciókat biztosítson.

options
BlobSetHTTPHeadersOptions

A Blob beállítása HTTP-fejlécek művelethez választható lehetőségek.

Válaszok

setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

Állítsa be az immutablility szabályzatot a blobon.

function setImmutabilityPolicy(immutabilityPolicy: BlobImmutabilityPolicy, options?: BlobSetImmutabilityPolicyOptions)

Paraméterek

immutabilityPolicy
BlobImmutabilityPolicy
options
BlobSetImmutabilityPolicyOptions

Nem kötelező beállítások a blob módosíthatósági szabályzatának beállításához.

Válaszok

setLegalHold(boolean, BlobSetLegalHoldOptions)

Jogi célú visszatartás beállítása a blobon.

function setLegalHold(legalHoldEnabled: boolean, options?: BlobSetLegalHoldOptions)

Paraméterek

legalHoldEnabled

boolean

options
BlobSetLegalHoldOptions

Választható lehetőségek a blob jogi célú visszatartására.

Válaszok

setMetadata(Metadata, BlobSetMetadataOptions)

A megadott blob felhasználó által definiált metaadatait egy vagy több név-érték párként állítja be. Ha nincs megadva lehetőség, vagy nincs megadva metaadat a paraméterben, a blob metaadatai el lesznek távolítva.

function setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions)

Paraméterek

metadata
Metadata

Cserélje le a meglévő metaadatokat erre az értékre. Ha nincs megadva érték, a meglévő metaadatok el lesznek távolítva.

options
BlobSetMetadataOptions

A Metaadat-művelet beállítása nem kötelező.

Válaszok

setTags(Tags, BlobSetTagsOptions)

Beállítja a címkéket a mögöttes blobon. Egy blob legfeljebb 10 címkével rendelkezhet. A címkebillentyűknek 1 és 128 karakter közöttinek kell lenniük. A címkeértékek 0 és 256 karakter közöttiek lehetnek. Az érvényes címkekulcs- és értékkarakterek közé tartoznak az alsó és nagybetűk, a számjegyek (0-9), a szóköz (' '), a plusz ('+'), a mínusz ('-'), a pont ('.'), a perjel ('/'), a kettőspont (':'), az egyenlő ('=') és az aláhúzásjel ('_').

function setTags(tags: Tags, options?: BlobSetTagsOptions)

Paraméterek

tags
Tags

Válaszok

stageBlock(string, HttpRequestBody, number, BlockBlobStageBlockOptions)

Feltölti a megadott blokkot a blokkblob "előkészítési területére", hogy később véglegesítse a commitBlockList hívása.

function stageBlock(blockId: string, body: HttpRequestBody, contentLength: number, options?: BlockBlobStageBlockOptions)

Paraméterek

blockId

string

Egy base64 kódolású 64 bájtos érték

body

HttpRequestBody

Az előkészítési területre feltöltendő adatok.

contentLength

number

Feltöltendő bájtok száma.

options
BlockBlobStageBlockOptions

A Blokkblobszakasz blokkolása művelet beállításai.

Válaszok

A Blokkblobszakasz blokkolása művelet válaszadatai.

stageBlockFromURL(string, string, number, number, BlockBlobStageBlockFromURLOptions)

A Fázisblokk url-címből művelet létrehoz egy új blokkot, amely egy blob részeként lesz véglegesítve, ahol a tartalom egy URL-címről lesz beolvasva. Ez az API a 2018-03-28-es verziótól érhető el.

function stageBlockFromURL(blockId: string, sourceURL: string, offset?: number, count?: number, options?: BlockBlobStageBlockFromURLOptions)

Paraméterek

blockId

string

Egy base64 kódolású 64 bájtos érték

sourceURL

string

A blob URL-címét adja meg. Az érték legfeljebb 2 KB hosszúságú URL-cím lehet, amely blobot határoz meg. Az értéknek URL-kódolásúnak kell lennie, ahogy az a kérelem URI-jában is megjelenik. A forrásblobnak nyilvánosnak kell lennie, vagy közös hozzáférésű jogosultságkóddal kell hitelesítenie magát. Ha a forrásblob nyilvános, a művelet végrehajtásához nincs szükség hitelesítésre. Íme néhány példa a forrásobjektum URL-címére: - https://myaccount.blob.core.windows.net/mycontainer/myblob - https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

offset

number

A letöltendő blob 0-nál nagyobb vagy egyenlő pozíciója

count

number

A letöltendő adatok száma 0-nál nagyobb. A végéig letölt, ha nincs meghatározva

options
BlockBlobStageBlockFromURLOptions

A Blobszakasz blokkolása URL-címből művelet beállításai.

Válaszok

A Block Blob Stage Block From URL művelet válaszadatai.

syncCopyFromURL(string, BlobSyncCopyFromURLOptions)

A szinkron Másolás URL-címről művelet egy blobot vagy internetes erőforrást másol egy új blobba. Nem ad vissza választ, amíg a másolat be nem fejeződik.

function syncCopyFromURL(copySource: string, options?: BlobSyncCopyFromURLOptions)

Paraméterek

copySource

string

A hitelesítéshez szükséges forrás URL-cím, amelyből a közös hozzáférésű jogosultságkód (SAS) másolható

Válaszok

syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)

Létrehoz egy új blokkblobot, amelyben a blob tartalma egy adott URL-címről lesz beolvasva. Ez az API a 2020.04.08-i verziótól kezdve támogatott. A részleges frissítések nem támogatottak a Put Blob from URL-címmel; egy meglévő blob tartalma felülíródik az új blob tartalmával. Ha részleges frissítéseket szeretne végrehajtani egy blokkblob tartalmának egy forrás URL-cím használatával, használja a és <xref:commitBlockList>a parancsot<xref:stageBlockFromURL>.

function syncUploadFromURL(sourceURL: string, options?: BlockBlobSyncUploadFromURLOptions)

Paraméterek

sourceURL

string

A blob URL-címét adja meg. Az érték legfeljebb 2 KB hosszúságú URL-cím lehet, amely blobot határoz meg. Az értéknek URL-kódolásúnak kell lennie, ahogy az a kérelem URI-jában is megjelenik. A forrásblobnak nyilvánosnak kell lennie, vagy közös hozzáférésű jogosultságkóddal kell hitelesítenie magát. Ha a forrásblob nyilvános, a művelet végrehajtásához nincs szükség hitelesítésre. Íme néhány példa a forrásobjektum URL-címére: - https://myaccount.blob.core.windows.net/mycontainer/myblob - https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

options
BlockBlobSyncUploadFromURLOptions

Választható paraméterek.

Válaszok

undelete(BlobUndeleteOptions)

Visszaállítja a helyreállíthatóan törölt blobok és a kapcsolódó helyreállíthatóan törölt pillanatképek tartalmát és metaadatait. A Blob törlése csak a 2017-07-29-es vagy újabb verzióban támogatott.

function undelete(options?: BlobUndeleteOptions)

Paraméterek

options
BlobUndeleteOptions

A Blob törlési műveletének választható lehetőségei.

Válaszok

upload(HttpRequestBody, number, BlockBlobUploadOptions)

Új blokkblobot hoz létre, vagy frissíti egy meglévő blokkblob tartalmát. Egy meglévő blokkblob frissítése felülírja a blob meglévő metaadatait. A részleges frissítések nem támogatottak; a meglévő blob tartalma felülíródik az új tartalommal. A blokkblobok részleges frissítéséhez használja <xref:stageBlock> a és <xref:commitBlockList>a parancsot. Ez egy nem párhuzamos feltöltési módszer. Használja <xref:uploadFile><xref:uploadStream> a vagy <xref:uploadBrowserData> a parancsot az egyidejű feltöltés jobb teljesítményéhez.

function upload(body: HttpRequestBody, contentLength: number, options?: BlockBlobUploadOptions)

Paraméterek

body

HttpRequestBody

Blob, sztring, ArrayBuffer, ArrayBufferView vagy olyan függvény, amely egy új olvasható adatfolyamot ad vissza, amelynek eltolása az adatforrás elejéről származik.

contentLength

number

A törzs hossza bájtban. Használja a Buffer.byteLength() függvényt egy sztring törzshosszának kiszámításához, beleértve a nem Base64/Hex kódolású karaktereket is.

options
BlockBlobUploadOptions

A Blokkblob feltöltése művelet beállításai.

Válaszok

A Blokkblob feltöltése művelet válaszadatai.

Példahasználat:

const content = "Hello world!";
const uploadBlobResponse = await blockBlobClient.upload(content, content.length);

uploadBrowserData(Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

Figyelmeztetés

Ez az API már elavult.

Use <xref:uploadData> instead.

CSAK BÖNGÉSZŐKBEN ÉRHETŐ EL. Feltölt egy böngészőblobot/fájlt/tömbbuffert/tömbbufferView objektumot a blob blokkolásához.

Ha a puffer hossza kisebb vagy egyenlő 256 MB-nál, ez a metódus 1 feltöltési hívást használ a feltöltés befejezéséhez. Ellenkező esetben ez a metódus meghívja <xref:stageBlock> a blokkok feltöltését, és végül meghívja <xref:commitBlockList> a blokklista véglegesítését.

A beállítás gyakori <xref:BlockBlobParallelUploadOptions.blobHTTPHeaders> lehetősége a blobContentType, amely lehetővé teszi, hogy a böngésző a fájltípus alapján biztosítson funkciókat.

function uploadBrowserData(browserData: Blob | ArrayBuffer | ArrayBufferView, options?: BlockBlobParallelUploadOptions)

Paraméterek

browserData

Blob | ArrayBuffer | ArrayBufferView

Blob, File, ArrayBuffer vagy ArrayBufferView

options
BlockBlobParallelUploadOptions

Böngészőadatok feltöltésének lehetőségei.

Válaszok

A Blob feltöltése művelet válaszadatai.

uploadData(Buffer | Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

Feltölt egy Buffer(Node.js)/Blob(browsers)/ArrayBuffer/ArrayBufferView objektumot egy BlockBlobba. Ha az adathossz nem nagyobb, mint a specifiled <xref:BlockBlobParallelUploadOptions.maxSingleShotSize> (alapértelmezés szerint <xref:BLOCK_BLOB_MAX_UPLOAD_BLOB_BYTES>), ez a metódus 1 <xref:upload> hívást használ a feltöltés befejezéséhez. Ellenkező esetben ez a metódus meghívja <xref:stageBlock> a blokkok feltöltését, és végül meghívja <xref:commitBlockList> a blokklista véglegesítését.

A beállítás gyakori <xref:BlockBlobParallelUploadOptions.blobHTTPHeaders> lehetősége a blobContentType, amely lehetővé teszi, hogy a böngésző a fájltípus alapján biztosítson funkciókat.

function uploadData(data: Buffer | Blob | ArrayBuffer | ArrayBufferView, options?: BlockBlobParallelUploadOptions)

Paraméterek

data

Buffer | Blob | ArrayBuffer | ArrayBufferView

Buffer(Node.js), Blob, ArrayBuffer vagy ArrayBufferView

Válaszok

uploadFile(string, BlockBlobParallelUploadOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Blokkokban lévő helyi fájlt tölt fel egy blokkblobba.

Ha a fájlméret kisebb vagy egyenlő 256 MB-nál, ez a metódus 1 feltöltési hívást használ a feltöltés befejezéséhez. Ellenkező esetben ez a metódus meghívja a stageBlock metódust blokkok feltöltéséhez, és végül meghívja a commitBlockList metódust a blokklista véglegesítéséhez.

function uploadFile(filePath: string, options?: BlockBlobParallelUploadOptions)

Paraméterek

filePath

string

A helyi fájl teljes elérési útja

options
BlockBlobParallelUploadOptions

A Feltöltés blokkblobba művelet beállításai.

Válaszok

A Blob feltöltése művelet válaszadatai.

uploadStream(Readable, number, number, BlockBlobUploadStreamOptions)

CSAK NODE.JS FUTTATÓKÖRNYEZETBEN ÉRHETŐ EL. Egy Node.js olvasható streamet tölt fel blokkblobba.

TELJESÍTMÉNNYEL KAPCSOLATOS TIPPEK:

  • A highWaterMark bemeneti adatfolyam jobb, ha ugyanazt az értéket a bufferSize paraméterrel állítja be, így elkerülhetők a Buffer.concat() műveletek.
function uploadStream(stream: Readable, bufferSize?: number, maxConcurrency?: number, options?: BlockBlobUploadStreamOptions)

Paraméterek

stream

Readable

Node.js olvasható stream

bufferSize

number

Az összes lefoglalt puffer mérete, valamint a feltöltött blokkblob blokkmérete. Az alapértelmezett érték 8 MB

maxConcurrency

number

A maximális egyidejűség a lefoglalható pufferek maximális számát jelzi, pozitív korrelációt a maximális feltöltési egyidejűséggel. Az alapértelmezett érték 5

options
BlockBlobUploadStreamOptions

A Stream feltöltése blokkblobba művelet beállításai.

Válaszok

A Blob feltöltése művelet válaszadatai.

withSnapshot(string)

Létrehoz egy új BlockBlobClient objektumot, amely megegyezik a forrással, de a megadott pillanatkép-időbélyeggel. Adja meg a "" lehetőséget, amely eltávolítja a pillanatképet, és visszaad egy URL-címet az alapblobnak.

function withSnapshot(snapshot: string)

Paraméterek

snapshot

string

A pillanatkép időbélyege.

Válaszok

Egy új BlockBlobClient objektum, amely megegyezik a forrással, de a megadott pillanatkép-időbélyeggel.

withVersion(string)

Létrehoz egy új BlobClient objektumot, amely ennek a blobnak egy verziójára mutat. A "" megadása eltávolítja a versionId azonosítót, és egy ügyfelet ad vissza az alapblobnak.

function withVersion(versionId: string)

Paraméterek

versionId

string

A verzióazonosító.

Válaszok

Egy új BlobClient objektum, amely ennek a blobnak a verziójára mutat.