Sdílet prostřednictvím


BlobDownloadHeaders interface

Definuje hlavičky pro operaci Blob_download.

Vlastnosti

acceptRanges

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

blobCommittedBlockCount

Počet potvrzených bloků, které jsou přítomné 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 nebo 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 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 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, selže to 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 poskytuje další informace o tom, jak zpracovat datovou část odpovědi, a můžete ho také použít k připojení dalších metadat. Pokud je například nastavená na přílohu, znamená to, že by user-agent neměl zobrazit odpověď, ale místo toho zobrazit dialogové okno Uložit jako s jiným názvem než zadaným názvem objektu blob.

contentEncoding

Tato hlavička vrátí hodnotu, která byla zadána 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

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

contentType

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

copyCompletedOn

Čas ukončení poslední operace kopírování objektu blob, kdy byl tento objekt blob 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 dokončení operace Kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu blokovaných objektů blob.

copyId

Identifikátor řetězce pro tuto operaci kopírování. Pomocí příkazu 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 čekající kopii.

copyProgress

Obsahuje počet zkopírovaných bajtů a celkový počet bajtů ve zdroji v poslední operaci Kopírování objektu blob, kde byl tento objekt blob cílovým objektem blob. Může zobrazit 0 0 bajtů a zkopírovaných bajtů délky obsahu. 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 dokončení operace kopírování objektů blob pomocí nastavení vlastností objektu blob, vložení 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 operaci 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 dokončení operace Kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu bloků.

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 ne závažné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 byl tento objekt blob změněn po dokončení operace kopírování objektů blob pomocí nastavení vlastností objektu blob, vložení objektu blob nebo seznamu blokovaných objektů blob.

createdOn

Vrátí datum a čas vytvoření objektu 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 objektů 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 objektů 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 nastavena na true, pokud jsou data objektů blob a metadata aplikace zcela šifrovaná pomocí zadaného algoritmu. V opačném případě se hodnota nastaví na false (pokud je objekt blob nešifrovaný nebo pokud jsou šifrovány 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

Při zapůjčení objektu blob 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, selhání).

requestId

Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ji 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é ve 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 objektů blob.

acceptRanges?: string

Hodnota vlastnosti

string

blobCommittedBlockCount

Počet potvrzených bloků, které jsou přítomné 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 nebo doplňovací objekty blob.

blobSequenceNumber?: number

Hodnota vlastnosti

number

blobType

Typ objektu blob.

blobType?: BlobType

Hodnota vlastnosti

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 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 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, selže to 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 poskytuje další informace o tom, jak zpracovat datovou část odpovědi, a můžete ho také použít k připojení dalších metadat. Pokud je například nastavená na přílohu, znamená to, že by user-agent neměl zobrazit odpověď, ale místo toho zobrazit dialogové okno Uložit jako s jiným názvem než zadaným názvem objektu blob.

contentDisposition?: string

Hodnota vlastnosti

string

contentEncoding

Tato hlavička vrátí hodnotu, která byla zadána 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

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

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í operace kopírování objektu blob, kdy byl tento objekt blob 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 dokončení operace Kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu blokovaných objektů blob.

copyCompletedOn?: Date

Hodnota vlastnosti

Date

copyId

Identifikátor řetězce pro tuto operaci kopírování. Pomocí příkazu 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 čekající kopii.

copyId?: string

Hodnota vlastnosti

string

copyProgress

Obsahuje počet zkopírovaných bajtů a celkový počet bajtů ve zdroji v poslední operaci Kopírování objektu blob, kde byl tento objekt blob cílovým objektem blob. Může zobrazit 0 0 bajtů a zkopírovaných bajtů délky obsahu. 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 dokončení operace kopírování objektů blob pomocí nastavení vlastností objektu blob, vložení 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 operaci 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 dokončení operace Kopírování objektu blob pomocí nastavení vlastností objektu blob, umístění objektu blob nebo seznamu bloků.

copySource?: string

Hodnota vlastnosti

string

copyStatus

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

copyStatus?: CopyStatusType

Hodnota vlastnosti

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 ne závažné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 byl tento objekt blob změněn po dokončení operace kopírování objektů blob pomocí nastavení vlastností objektu blob, vložení objektu blob nebo seznamu blokovaných objektů blob.

copyStatusDescription?: string

Hodnota vlastnosti

string

createdOn

Vrátí datum a čas vytvoření objektu blob.

createdOn?: Date

Hodnota vlastnosti

Date

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 objektů 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 objektů blob.

immutabilityPolicyExpiresOn?: Date

Hodnota vlastnosti

Date

immutabilityPolicyMode

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

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Hodnota vlastnosti

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 nastavena na true, pokud jsou data objektů blob a metadata aplikace zcela šifrovaná pomocí zadaného algoritmu. V opačném případě se hodnota nastaví na false (pokud je objekt blob nešifrovaný nebo pokud jsou šifrovány 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

Při zapůjčení objektu blob určuje, jestli má zapůjčení neomezenou nebo pevnou dobu trvání.

leaseDuration?: LeaseDurationType

Hodnota vlastnosti

leaseState

Stav zapůjčení objektu blob

leaseState?: LeaseStateType

Hodnota vlastnosti

leaseStatus

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

leaseStatus?: LeaseStatusType

Hodnota vlastnosti

legalHold

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

legalHold?: boolean

Hodnota vlastnosti

boolean

metadata

metadata?: {[propertyName: string]: string}

Hodnota vlastnosti

{[propertyName: 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, selhání).

objectReplicationRules?: {[propertyName: string]: string}

Hodnota vlastnosti

{[propertyName: string]: string}

requestId

Tato hlavička jednoznačně identifikuje požadavek, který byl proveden, a lze ji 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é ve 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