BlobDownloadHeaders interface

Balíček:

@azure/storage-blob

Definuje hlavičky pro Blob_download operaci.

Vlastnosti

acceptRanges	Označuje, že služba podporuje požadavky na částečný obsah objektu blob.
blobCommittedBlockCount	Počet potvrzených bloků v objektu blob. Tato hlavička se vrátí jenom pro doplňovací objekty blob.
blobContentMD5	Pokud má objekt blob hodnotu hash MD5 a požadavek obsahuje hlavičku rozsahu (range nebo x-ms-range), vrátí se tato hlavička odpovědi s hodnotou MD5 celého objektu blob. Tato hodnota se může nebo nemusí rovnat hodnotě vrácené v hlavičce Content-MD5, přičemž druhá hodnota se vypočítá z požadovaného rozsahu.
blobSequenceNumber	Aktuální pořadové číslo objektu blob stránky. Tato hlavička se nevrací pro objekty blob bloku ani doplňovací objekty blob.
blobType	Typ objektu blob.
cacheControl	Tato hlavička se vrátí, pokud byla dříve zadána pro objekt blob.
clientRequestId	Pokud se v požadavku odešle hlavička ID požadavku klienta, bude tato hlavička obsažena v odpovědi se stejnou hodnotou.
contentCrc64	Pokud má požadavek přečíst zadanou oblast a x-ms-range-get-content-crc64 je nastaven na hodnotu true, pak požadavek vrátí crc64 pro danou oblast, pokud je velikost rozsahu menší než nebo rovna 4 MB. Pokud je ve stejném požadavku zadáno x-ms-range-get-content-crc64 & x-ms-range-get-content-md5, dojde k selhání s chybou 400 (Chybný požadavek).
contentDisposition	Tato hlavička vrátí hodnotu, která byla zadána pro hlavičku x-ms-blob-content-disposition. Pole hlavičky odpovědi Content-Disposition sděluje další informace o tom, jak zpracovat datovou část odpovědi, a lze ho také použít k připojení dalších metadat. Pokud je například nastavená příloha, znamená to, že by uživatelský agent neměl zobrazovat odpověď, ale místo toho zobrazit dialogové okno Uložit jako s jiným názvem souboru, než je zadaný název objektu blob.
contentEncoding	Tato hlavička vrátí hodnotu zadanou pro hlavičku požadavku content-encoding.
contentLanguage	Tato hlavička vrátí hodnotu, která byla zadána pro hlavičku požadavku Content-Language.
contentLength	Počet bajtů v textu odpovědi.
contentMD5	Pokud má objekt blob hodnotu hash MD5 a tato operace má přečíst celý objekt blob, vrátí se tato hlavička odpovědi, aby klient mohl zkontrolovat integritu obsahu zprávy.
contentRange	Určuje rozsah bajtů vrácených v případě, že klient požadoval podmnožinu objektu blob nastavením hlavičky požadavku Range.
contentType	Typ média v těle odpovědi. Pro stažení objektu blob je to application/octet-stream.
copyCompletedOn	Čas ukončení posledního pokusu o operaci kopírování objektu blob, kdy tento objekt blob byl cílovým objektem blob. Tato hodnota může určovat čas dokončení, přerušení nebo neúspěšného pokusu o kopírování. Tato hlavička se nezobrazí, pokud čeká na kopírování, pokud tento objekt blob nikdy nebyl cílem operace kopírování objektu blob nebo pokud byl tento objekt blob změněn po ukončení operace kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu bloků.
copyId	Identifikátor řetězce pro tuto operaci kopírování. Pomocí příkazu Get Blob Properties (Získat vlastnosti objektu blob) můžete zkontrolovat stav této operace kopírování nebo předat funkci Přerušit kopírování objektu blob a přerušit tak čekající kopii.
copyProgress	Obsahuje počet zkopírovaných bajtů a celkový počet bajtů ve zdroji při posledním pokusu o operaci kopírování objektu blob, kdy byl tento objekt blob cílovým objektem blob. Může zobrazovat kopírované bajty mezi 0 a délkou obsahu. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace kopírování objektu blob nebo pokud se tento objekt blob změnil po dokončení operace kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu blokovaných objektů blob.
copySource	Adresa URL o délce až 2 kB, která určuje zdrojový objekt blob nebo soubor použitý při posledním pokusu o kopírování objektu blob, kde byl tento objekt blob cílovým objektem blob. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace kopírování objektu blob nebo pokud byl tento objekt blob změněn po ukončení operace Kopírování objektu blob pomocí nastavení vlastností objektu blob, put blob nebo seznamu blokovaných objektů blob.
copyStatus	Stav operace kopírování identifikovaný pomocí x-ms-copy-id.
copyStatusDescription	Zobrazí se pouze v případě, že x-ms-copy-status selhal nebo čeká na vyřízení. Popisuje příčinu posledního závažného nebo nezásadového selhání operace kopírování. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace kopírování objektu blob nebo pokud se tento objekt blob změnil po dokončení operace kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu blokovaných objektů blob.
date	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
encryptionKeySha256	Hodnota hash SHA-256 šifrovacího klíče použitého k šifrování objektu blob. Tato hlavička se vrátí jenom v případě, že byl objekt blob zašifrovaný pomocí klíče poskytnutého zákazníkem.
encryptionScope	Vrátí název oboru šifrování použitého k šifrování obsahu objektu blob a metadat aplikace. Všimněte si, že absence této hlavičky znamená použití výchozího oboru šifrování účtu.
errorCode	Kód chyby
etag	Značka ETag obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Pokud je verze požadavku 2011-08-18 nebo novější, hodnota ETag bude v uvozovkách.
immutabilityPolicyExpiresOn	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy vyprší platnost zásad neměnnosti objektu blob.
immutabilityPolicyMode	Označuje režim zásad neměnnosti.
isCurrentVersion	Hodnota této hlavičky označuje, jestli je verze tohoto objektu blob aktuální verzí. Viz také hlavička x-ms-version-id.
isSealed	Pokud je tento objekt blob zapečetěný
isServerEncrypted	Hodnota této hlavičky je nastavená na true, pokud jsou data objektů blob a metadata aplikace zcela zašifrovaná pomocí zadaného algoritmu. Jinak je hodnota nastavená na false (pokud je objekt blob nešifrovaný nebo pokud jsou šifrované jenom části metadat objektu blob nebo aplikace).
lastAccessed	Hodnota data a času UTC vygenerovaná službou, která označuje čas posledního čtení nebo zápisu objektu blob do
lastModified	Vrátí datum a čas poslední změny kontejneru. Každá operace, která změní objekt blob, včetně aktualizace metadat nebo vlastností objektu blob, změní čas poslední změny objektu blob.
leaseDuration	Když je objekt blob zapůjčený, určuje, jestli má zapůjčení neomezenou nebo pevnou dobu trvání.
leaseState	Stav zapůjčení objektu blob.
leaseStatus	Aktuální stav zapůjčení objektu blob.
legalHold	Označuje, jestli je v objektu blob blokování z právních důvodů.
metadata
objectReplicationPolicyId	Nepovinný parametr. Platí pouze v případě, že je pro kontejner úložiště povolená replikace objektů a v cílovém objektu blob replikace.
objectReplicationRules	Nepovinný parametr. Platí pouze v případě, že je pro kontejner úložiště povolená replikace objektů a ve zdrojovém objektu blob replikace. Při načítání této hlavičky se vrátí hlavička s ID zásady a ID pravidla (např. x-ms-or-policyid_ruleid) a hodnotou bude stav replikace (např. dokončeno, neúspěšné).
requestId	Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a dá se použít k řešení potíží s požadavkem.
tagCount	Počet značek přidružených k objektu blob
version	Označuje verzi služby Blob Service použitou ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené proti verzi 2009-09-19 a vyšší.
versionId	Hodnota DateTime vrácená službou, která jednoznačně identifikuje objekt blob. Hodnota této hlavičky označuje verzi objektu blob a může se použít v následných požadavcích na přístup k této verzi objektu blob.

Podrobnosti vlastnosti

acceptRanges

Označuje, že služba podporuje požadavky na částečný obsah objektu blob.

acceptRanges?: string

Hodnota vlastnosti

string

blobCommittedBlockCount

Počet potvrzených bloků v objektu blob. Tato hlavička se vrátí jenom pro doplňovací objekty blob.

blobCommittedBlockCount?: number

Hodnota vlastnosti

number

blobContentMD5

Pokud má objekt blob hodnotu hash MD5 a požadavek obsahuje hlavičku rozsahu (range nebo x-ms-range), vrátí se tato hlavička odpovědi s hodnotou MD5 celého objektu blob. Tato hodnota se může nebo nemusí rovnat hodnotě vrácené v hlavičce Content-MD5, přičemž druhá hodnota se vypočítá z požadovaného rozsahu.

blobContentMD5?: Uint8Array

Hodnota vlastnosti

Uint8Array

blobSequenceNumber

Aktuální pořadové číslo objektu blob stránky. Tato hlavička se nevrací pro objekty blob bloku ani doplňovací objekty blob.

blobSequenceNumber?: number

Hodnota vlastnosti

number

blobType

Typ objektu blob.

blobType?: BlobType

Hodnota vlastnosti

BlobType

cacheControl

Tato hlavička se vrátí, pokud byla dříve zadána pro objekt blob.

cacheControl?: string

Hodnota vlastnosti

string

clientRequestId

Pokud se v požadavku odešle hlavička ID požadavku klienta, bude tato hlavička obsažena v odpovědi se stejnou hodnotou.

clientRequestId?: string

Hodnota vlastnosti

string

contentCrc64

Pokud má požadavek přečíst zadanou oblast a x-ms-range-get-content-crc64 je nastaven na hodnotu true, pak požadavek vrátí crc64 pro danou oblast, pokud je velikost rozsahu menší než nebo rovna 4 MB. Pokud je ve stejném požadavku zadáno x-ms-range-get-content-crc64 & x-ms-range-get-content-md5, dojde k selhání s chybou 400 (Chybný požadavek).

contentCrc64?: Uint8Array

Hodnota vlastnosti

Uint8Array

contentDisposition

Tato hlavička vrátí hodnotu, která byla zadána pro hlavičku x-ms-blob-content-disposition. Pole hlavičky odpovědi Content-Disposition sděluje další informace o tom, jak zpracovat datovou část odpovědi, a lze ho také použít k připojení dalších metadat. Pokud je například nastavená příloha, znamená to, že by uživatelský agent neměl zobrazovat odpověď, ale místo toho zobrazit dialogové okno Uložit jako s jiným názvem souboru, než je zadaný název objektu blob.

contentDisposition?: string

Hodnota vlastnosti

string

contentEncoding

Tato hlavička vrátí hodnotu zadanou pro hlavičku požadavku content-encoding.

contentEncoding?: string

Hodnota vlastnosti

string

contentLanguage

Tato hlavička vrátí hodnotu, která byla zadána pro hlavičku požadavku Content-Language.

contentLanguage?: string

Hodnota vlastnosti

string

contentLength

Počet bajtů v textu odpovědi.

contentLength?: number

Hodnota vlastnosti

number

contentMD5

Pokud má objekt blob hodnotu hash MD5 a tato operace má přečíst celý objekt blob, vrátí se tato hlavička odpovědi, aby klient mohl zkontrolovat integritu obsahu zprávy.

contentMD5?: Uint8Array

Hodnota vlastnosti

Uint8Array

contentRange

Určuje rozsah bajtů vrácených v případě, že klient požadoval podmnožinu objektu blob nastavením hlavičky požadavku Range.

contentRange?: string

Hodnota vlastnosti

string

contentType

Typ média v těle odpovědi. Pro stažení objektu blob je to application/octet-stream.

contentType?: string

Hodnota vlastnosti

string

copyCompletedOn

Čas ukončení posledního pokusu o operaci kopírování objektu blob, kdy tento objekt blob byl cílovým objektem blob. Tato hodnota může určovat čas dokončení, přerušení nebo neúspěšného pokusu o kopírování. Tato hlavička se nezobrazí, pokud čeká na kopírování, pokud tento objekt blob nikdy nebyl cílem operace kopírování objektu blob nebo pokud byl tento objekt blob změněn po ukončení operace kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu bloků.

copyCompletedOn?: Date

Hodnota vlastnosti

Date

copyId

Identifikátor řetězce pro tuto operaci kopírování. Pomocí příkazu Get Blob Properties (Získat vlastnosti objektu blob) můžete zkontrolovat stav této operace kopírování nebo předat funkci Přerušit kopírování objektu blob a přerušit tak čekající kopii.

copyId?: string

Hodnota vlastnosti

string

copyProgress

Obsahuje počet zkopírovaných bajtů a celkový počet bajtů ve zdroji při posledním pokusu o operaci kopírování objektu blob, kdy byl tento objekt blob cílovým objektem blob. Může zobrazovat kopírované bajty mezi 0 a délkou obsahu. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace kopírování objektu blob nebo pokud se tento objekt blob změnil po dokončení operace kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu blokovaných objektů blob.

copyProgress?: string

Hodnota vlastnosti

string

copySource

Adresa URL o délce až 2 kB, která určuje zdrojový objekt blob nebo soubor použitý při posledním pokusu o kopírování objektu blob, kde byl tento objekt blob cílovým objektem blob. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace kopírování objektu blob nebo pokud byl tento objekt blob změněn po ukončení operace Kopírování objektu blob pomocí nastavení vlastností objektu blob, put blob nebo seznamu blokovaných objektů blob.

copySource?: string

Hodnota vlastnosti

string

copyStatus

Stav operace kopírování identifikovaný pomocí x-ms-copy-id.

copyStatus?: CopyStatusType

Hodnota vlastnosti

CopyStatusType

copyStatusDescription

Zobrazí se pouze v případě, že x-ms-copy-status selhal nebo čeká na vyřízení. Popisuje příčinu posledního závažného nebo nezásadového selhání operace kopírování. Tato hlavička se nezobrazí, pokud tento objekt blob nikdy nebyl cílem operace kopírování objektu blob nebo pokud se tento objekt blob změnil po dokončení operace kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu blokovaných objektů blob.

copyStatusDescription?: string

Hodnota vlastnosti

string

date

Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.

date?: Date

Hodnota vlastnosti

Date

encryptionKeySha256

Hodnota hash SHA-256 šifrovacího klíče použitého k šifrování objektu blob. Tato hlavička se vrátí jenom v případě, že byl objekt blob zašifrovaný pomocí klíče poskytnutého zákazníkem.

encryptionKeySha256?: string

Hodnota vlastnosti

string

encryptionScope

Vrátí název oboru šifrování použitého k šifrování obsahu objektu blob a metadat aplikace. Všimněte si, že absence této hlavičky znamená použití výchozího oboru šifrování účtu.

encryptionScope?: string

Hodnota vlastnosti

string

errorCode

Kód chyby

errorCode?: string

Hodnota vlastnosti

string

etag

Značka ETag obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Pokud je verze požadavku 2011-08-18 nebo novější, hodnota ETag bude v uvozovkách.

etag?: string

Hodnota vlastnosti

string

immutabilityPolicyExpiresOn

Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy vyprší platnost zásad neměnnosti objektu blob.

immutabilityPolicyExpiresOn?: Date

Hodnota vlastnosti

Date

immutabilityPolicyMode

Označuje režim zásad neměnnosti.

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Hodnota vlastnosti

BlobImmutabilityPolicyMode

isCurrentVersion

Hodnota této hlavičky označuje, jestli je verze tohoto objektu blob aktuální verzí. Viz také hlavička x-ms-version-id.

isCurrentVersion?: boolean

Hodnota vlastnosti

boolean

isSealed

Pokud je tento objekt blob zapečetěný

isSealed?: boolean

Hodnota vlastnosti

boolean

isServerEncrypted

Hodnota této hlavičky je nastavená na true, pokud jsou data objektů blob a metadata aplikace zcela zašifrovaná pomocí zadaného algoritmu. Jinak je hodnota nastavená na false (pokud je objekt blob nešifrovaný nebo pokud jsou šifrované jenom části metadat objektu blob nebo aplikace).

isServerEncrypted?: boolean

Hodnota vlastnosti

boolean

lastAccessed

Hodnota data a času UTC vygenerovaná službou, která označuje čas posledního čtení nebo zápisu objektu blob do

lastAccessed?: Date

Hodnota vlastnosti

Date

lastModified

Vrátí datum a čas poslední změny kontejneru. Každá operace, která změní objekt blob, včetně aktualizace metadat nebo vlastností objektu blob, změní čas poslední změny objektu blob.

lastModified?: Date

Hodnota vlastnosti

Date

leaseDuration

Když je objekt blob zapůjčený, určuje, jestli má zapůjčení neomezenou nebo pevnou dobu trvání.

leaseDuration?: LeaseDurationType

Hodnota vlastnosti

LeaseDurationType

leaseState

Stav zapůjčení objektu blob.

leaseState?: LeaseStateType

Hodnota vlastnosti

LeaseStateType

leaseStatus

Aktuální stav zapůjčení objektu blob.

leaseStatus?: LeaseStatusType

Hodnota vlastnosti

LeaseStatusType

legalHold

Označuje, jestli je v objektu blob blokování z právních důvodů.

legalHold?: boolean

Hodnota vlastnosti

boolean

metadata

metadata?: [key: string]: string

Hodnota vlastnosti

[key: string]: string

objectReplicationPolicyId

Nepovinný parametr. Platí pouze v případě, že je pro kontejner úložiště povolená replikace objektů a v cílovém objektu blob replikace.

objectReplicationPolicyId?: string

Hodnota vlastnosti

string

objectReplicationRules

Nepovinný parametr. Platí pouze v případě, že je pro kontejner úložiště povolená replikace objektů a ve zdrojovém objektu blob replikace. Při načítání této hlavičky se vrátí hlavička s ID zásady a ID pravidla (např. x-ms-or-policyid_ruleid) a hodnotou bude stav replikace (např. dokončeno, neúspěšné).

objectReplicationRules?: [key: string]: string

Hodnota vlastnosti

[key: string]: string

requestId

Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a dá se použít k řešení potíží s požadavkem.

requestId?: string

Hodnota vlastnosti

string

tagCount

Počet značek přidružených k objektu blob

tagCount?: number

Hodnota vlastnosti

number

version

Označuje verzi služby Blob Service použitou ke spuštění požadavku. Tato hlavička se vrátí pro požadavky provedené proti verzi 2009-09-19 a vyšší.

version?: string

Hodnota vlastnosti

string

versionId

Hodnota DateTime vrácená službou, která jednoznačně identifikuje objekt blob. Hodnota této hlavičky označuje verzi objektu blob a může se použít v následných požadavcích na přístup k této verzi objektu blob.

versionId?: string

Hodnota vlastnosti

string