AppendBlobClient class

Csomag:

@azure/storage-blob

A AppendBlobClient a hozzáfűző blobokra vonatkozó műveletek halmazát határozza meg.

Extends

BlobClient

Konstruktorok

AppendBlobClient(string, PipelineLike)	Létrehozza a AppendBlobClient egy példányát. Ez a metódus egy hozzáfűző blobra mutató kódolt URL-címet vagy nem kódolt URL-címet fogad el. 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.
AppendBlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)	Létrehozza a AppendBlobClient egy példányát. Ez a metódus egy hozzáfűző blobra mutató kódolt URL-címet vagy nem kódolt URL-címet fogad el. 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.
AppendBlobClient(string, string, string, StoragePipelineOptions)	Létrehozza a AppendBlobClient egy példányát.

Tulajdonságok

accountName
containerName	Annak a tárolónak a neve, amelyhez a blob társítva van.
credential	Ilyen például az AnonymousCredential, a StorageSharedKeyCredential vagy a csomag bármely hitelesítő adata a @azure/identity szolgáltatás felé irányuló kérések hitelesítéséhez. Olyan objektumot is megadhat, amely implementálja a TokenCredential felületet. Ha nincs megadva, az AnonymousCredential lesz használva.
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 másolási blobműveletet, és egy célblobot hagy nulla hosszúságú és teljes metaadatokkal. 2012-02-12-es és újabb verzió.
appendBlock(HttpRequestBody, number, AppendBlobAppendBlockOptions)	Új adatblokkot véglegesíti a meglévő hozzáfűző blob végéig.
appendBlockFromURL(string, number, number, AppendBlobAppendBlockFromURLOptions)	A Hozzáfűzési blokk művelet egy új adatblokkot véglegesíti egy meglévő hozzáfűző blob végéhez, ahol a tartalom egy forrás URL-címről lesz beolvasva.
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.
create(AppendBlobCreateOptions)	Létrehoz egy 0 hosszúságú hozzáfűző blobot. Hívja meg a AppendBlock parancsot, ha adatokat szeretne hozzáfűzni egy hozzáfűző blobhoz.
createIfNotExists(AppendBlobCreateIfNotExistsOptions)	Létrehoz egy 0 hosszúságú hozzáfűző blobot. Hívja meg a AppendBlock parancsot, ha adatokat szeretne hozzáfűzni egy hozzáfűző blobhoz. Ha az azonos nevű blob már létezik, a meglévő blob tartalma változatlan marad.
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.
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.
seal(AppendBlobSealOptions)	Lezárja a hozzáfűző blobot, így csak olvasható.
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 rendszer tulajdonságait a blobon. Ha nincs megadva érték, vagy nincs megadva érték a megadott blob HTTP-fejléceihez, 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)	Állítsa be a jogi mentességet a blobra.
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)	Címkéket állít be 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ékeinek 0 és 256 karakter közöttinek kell lenniük. Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz (' '), plusz ('+'), mínusz ('-'), pont ('.'), perjel ('/'), kettőspont (':'), egyenlőség ('=') és aláhúzás ('_') .
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. Addig nem ad vissza választ, amíg a másolat be nem fejeződik.
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. Az Undelete Blob csak a 2017-07-29-es vagy újabb verzióban támogatott.
withSnapshot(string)	Létrehoz egy új AppendBlobClient 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 egy ügyfelet ad vissza az alapblobba.
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 alapblobba.

Konstruktor adatai

AppendBlobClient(string, PipelineLike)

Létrehozza a AppendBlobClient egy példányát. Ez a metódus egy hozzáfűző blobra mutató kódolt URL-címet vagy nem kódolt URL-címet fogad el. 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 AppendBlobClient(url: string, pipeline: PipelineLike)

Paraméterek

url

string

Az Azure Storage hozzáfűző blobra mutató URL-sztring, például "https://myaccount.blob.core.windows.net/mycontainer/appendblob". Sas hozzáfűzhető, ha AnonymousCredentialt használ, például "https://myaccount.blob.core.windows.net/mycontainer/appendblob?sasString". Ez a metódus egy blobra mutató kódolt VAGY nem kódolt URL-címet fogad el. 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. Például egy "my?blob%" nevű blob esetében az URL-címnek "https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25"" kell lennie.

pipeline

PipelineLike

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

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

Létrehozza a AppendBlobClient egy példányát. Ez a metódus egy hozzáfűző blobra mutató kódolt URL-címet vagy nem kódolt URL-címet fogad el. 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 AppendBlobClient(url: string, credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

Paraméterek

url

string

Az Azure Storage hozzáfűző blobra mutató URL-sztring, például "https://myaccount.blob.core.windows.net/mycontainer/appendblob". Sas hozzáfűzhető, ha AnonymousCredentialt használ, például "https://myaccount.blob.core.windows.net/mycontainer/appendblob?sasString". Ez a metódus egy blobra mutató kódolt VAGY nem kódolt URL-címet fogad el. 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. Például egy "my?blob%" nevű blob esetében az URL-címnek "https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25"" kell lennie.

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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

options

StoragePipelineOptions

Választható. A HTTP-folyamat konfigurálásának beállításai.

AppendBlobClient(string, string, string, StoragePipelineOptions)

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

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

Paraméterek

connectionString

string

Azure Storage-fiók fiók kapcsolati sztring vagy 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 beállításai.

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

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

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Tulajdonság értéke

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

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 másolási blobműveletet, és egy célblobot hagy nulla hosszúságú és teljes metaadatokkal. 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

Promise<BlobAbortCopyFromURLResponse>

appendBlock(HttpRequestBody, number, AppendBlobAppendBlockOptions)

Új adatblokkot véglegesíti a meglévő hozzáfűző blob végéig.

function appendBlock(body: HttpRequestBody, contentLength: number, options?: AppendBlobAppendBlockOptions)

Paraméterek

body

HttpRequestBody

A hozzáfűzendő adatok.

contentLength

number

A törzs hossza bájtban.

options

AppendBlobAppendBlockOptions

A Hozzáfűzési blokk művelet beállításai.

Példahasználat:

const content = "Hello World!";

// Create a new append blob and append data to the blob.
const newAppendBlobClient = containerClient.getAppendBlobClient("<blob name>");
await newAppendBlobClient.create();
await newAppendBlobClient.appendBlock(content, content.length);

// Append data to an existing append blob.
const existingAppendBlobClient = containerClient.getAppendBlobClient("<blob name>");
await existingAppendBlobClient.appendBlock(content, content.length);

Válaszok

Promise<AppendBlobAppendBlockResponse>

appendBlockFromURL(string, number, number, AppendBlobAppendBlockFromURLOptions)

A Hozzáfűzési blokk művelet egy új adatblokkot véglegesíti egy meglévő hozzáfűző blob végéhez, ahol a tartalom egy forrás URL-címről lesz beolvasva.

function appendBlockFromURL(sourceURL: string, sourceOffset: number, count: number, options?: AppendBlobAppendBlockFromURLOptions)

Paraméterek

sourceURL

string

•           The url to the blob that will be the source of the copy. A source blob in the same storage account can
            be authenticated via Shared Key. However, if the source is a blob in another account, the source blob
            must either be public or must be authenticated via a shared access signature. If the source blob is
            public, no authentication is required to perform the operation.
  

sourceOffset

number

Eltolás a hozzáfűzendő forrásban

count

number

Blokkként hozzáfűzendő bájtok száma

options

AppendBlobAppendBlockFromURLOptions

Válaszok

Promise<AppendBlobAppendBlockFromUrlResponse>

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

create(AppendBlobCreateOptions)

Létrehoz egy 0 hosszúságú hozzáfűző blobot. Hívja meg a AppendBlock parancsot, ha adatokat szeretne hozzáfűzni egy hozzáfűző blobhoz.

function create(options?: AppendBlobCreateOptions)

Paraméterek

options

AppendBlobCreateOptions

A Hozzáfűzési blokk létrehozása művelet beállításai.

Példahasználat:

const appendBlobClient = containerClient.getAppendBlobClient("<blob name>");
await appendBlobClient.create();

Válaszok

Promise<AppendBlobCreateResponse>

createIfNotExists(AppendBlobCreateIfNotExistsOptions)

Létrehoz egy 0 hosszúságú hozzáfűző blobot. Hívja meg a AppendBlock parancsot, ha adatokat szeretne hozzáfűzni egy hozzáfűző blobhoz. Ha az azonos nevű blob már létezik, a meglévő blob tartalma változatlan marad.

function createIfNotExists(options?: AppendBlobCreateIfNotExistsOptions)

Paraméterek

options

AppendBlobCreateIfNotExistsOptions

Válaszok

Promise<AppendBlobCreateIfNotExistsResponse>

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

Promise<BlobCreateSnapshotResponse>

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

Promise<BlobDeleteResponse>

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

Promise<BlobDeleteIfExistsResponse>

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

Promise<BlobDeleteImmutabilityPolicyResponse>

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

Promise<BlobDownloadResponseParsed>

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

Promise<BlobDownloadResponseParsed>

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

AppendBlobClient

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

BlobLeaseClient

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

getBlockBlobClient()

Létrehoz egy BlockBlobClient objektumot.

function getBlockBlobClient()

Válaszok

BlockBlobClient

getPageBlobClient()

Létrehoz egy PageBlobClient objektumot.

function getPageBlobClient()

Válaszok

PageBlobClient

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

Promise<BlobGetPropertiesResponse>

getTags(BlobGetTagsOptions)

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

function getTags(options?: BlobGetTagsOptions)

Paraméterek

options

BlobGetTagsOptions

Válaszok

Promise<BlobGetTagsResponse>

seal(AppendBlobSealOptions)

Lezárja a hozzáfűző blobot, így csak olvasható.

function seal(options?: AppendBlobSealOptions)

Paraméterek

options

AppendBlobSealOptions

Válaszok

Promise<AppendBlobAppendBlockResponse>

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ítani kívánt szint. Az érvényes értékek a gyakori elérésű, a ritka elérésű vagy az archív értékek.

options

BlobSetTierOptions

A Blobkészlet rétege művelet választható beállításai.

Válaszok

Promise<BlobSetTierResponse>

setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

Beállítja a rendszer tulajdonságait a blobon. Ha nincs megadva érték, vagy nincs megadva érték a megadott blob HTTP-fejléceihez, 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 nincs megadva érték a megadott blob HTTP-fejléceihez, ezek a blob HTTP-fejlécek érték nélkül törlődnek. Egy gyakran beállított fejléc lehetővé teszi a blobContentType böngésző számára, hogy fájltípus alapján biztosítson funkciókat.

options

BlobSetHTTPHeadersOptions

A BLOB HTTP-fejlécek beállítása művelet választható beállításai.

Válaszok

Promise<BlobSetHTTPHeadersResponse>

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

Promise<BlobSetImmutabilityPolicyResponse>

setLegalHold(boolean, BlobSetLegalHoldOptions)

Állítsa be a jogi mentességet a blobra.

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

Promise<BlobSetLegalHoldResponse>

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

Promise<BlobSetMetadataResponse>

setTags(Tags, BlobSetTagsOptions)

Címkéket állít be 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ékeinek 0 és 256 karakter közöttinek kell lenniük. Érvényes címkekulcs- és értékkarakterek: kis- és nagybetűk, számjegyek (0-9), szóköz (' '), plusz ('+'), mínusz ('-'), pont ('.'), perjel ('/'), kettőspont (':'), egyenlőség ('=') és aláhúzás ('_') .

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

Paraméterek

tags

Tags

options

BlobSetTagsOptions

Válaszok

Promise<BlobSetTagsResponse>

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. Addig nem ad vissza választ, amíg a másolat be nem fejeződik.

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

Paraméterek

copySource

string

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

options

BlobSyncCopyFromURLOptions

Válaszok

Promise<BlobCopyFromURLResponse>

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. Az Undelete Blob csak a 2017-07-29-es vagy újabb verzióban támogatott.

function undelete(options?: BlobUndeleteOptions)

Paraméterek

options

BlobUndeleteOptions

A Blob Undelete művelet választható lehetőségei.

Válaszok

Promise<BlobUndeleteResponse>

withSnapshot(string)

Létrehoz egy új AppendBlobClient 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 egy ügyfelet ad vissza az alapblobba.

function withSnapshot(snapshot: string)

Paraméterek

snapshot

string

A pillanatkép időbélyege.

Válaszok

AppendBlobClient

Egy új AppendBlobClient 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 alapblobba.

function withVersion(versionId: string)

Paraméterek

versionId

string

A verzióazonosító.

Válaszok

BlobClient

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