Sdílet prostřednictvím


BlobGetPropertiesHeaders interface

Definuje hlavičky pro operaci Blob_getProperties.

Vlastnosti

acceptRanges

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

accessTier

Úroveň objektu blob stránky v účtu služby Premium Storage nebo úroveň objektu blob bloku v účtech LRS úložiště objektů blob. Seznam povolených úrovní objektů blob stránky úrovně Premium najdete v tématu https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Pro účty LRS úložiště objektů blob jsou platné hodnoty horká, studená nebo archivní.

accessTierChangedOn

Čas změny vrstvy objektu Tato hodnota se vrátí pouze v případě, že byla někdy nastavena úroveň objektu blob bloku.

accessTierInferred

Pouze pro objekty blob stránky v účtu úložiště úrovně Premium. Pokud úroveň přístupu není u objektu blob explicitně nastavená, odvozuje se na základě délky obsahu a tato hlavička se vrátí se skutečnou hodnotou.

archiveStatus

Pro účty LRS úložiště objektů blob jsou platné hodnoty rehydrate-pending-to-hot/rehydrate-pending-to-cool. Pokud se objekt blob rehydruje a není dokončený, vrátí se tato hlavička, která značí, že čeká na dosazování, a informuje také cílovou vrstvu.

blobCommittedBlockCount

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

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.

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

Velikost objektu blob v bajtech. Pro objekt blob stránky tato hlavička vrátí hodnotu hlavičky x-ms-blob-content-length, která je uložená s objektem blob.

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.

contentType

Typ obsahu zadaný pro objekt blob. Výchozí typ obsahu je 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, kdy 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 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 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.

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.

destinationSnapshot

Zahrne se, pokud je objekt blob přírůstkovým kopírováním objektu blob nebo přírůstkového kopírování snímek, pokud je x-ms-copy-status úspěšný. Čas posledního úspěšného přírůstkového kopírování snímku tohoto objektu blob.

encryptionKeySha256

Hodnota hash SHA-256 šifrovacího klíče použitého k šifrování metadat. Tato hlavička se vrátí pouze v případě, že metadata byla zašifrována 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.

expiresOn

Čas vypršení platnosti tohoto objektu blob

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.

isIncrementalCopy

Zahrne se, pokud se jedná o objekt blob přírůstkového kopírování.

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 objektu blob. 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é).

rehydratePriority

Pokud je objekt ve stavu čekání na rehydraci, vrátí se tato hlavička s prioritou rehydratace.

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

accessTier

Úroveň objektu blob stránky v účtu služby Premium Storage nebo úroveň objektu blob bloku v účtech LRS úložiště objektů blob. Seznam povolených úrovní objektů blob stránky úrovně Premium najdete v tématu https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Pro účty LRS úložiště objektů blob jsou platné hodnoty horká, studená nebo archivní.

accessTier?: string

Hodnota vlastnosti

string

accessTierChangedOn

Čas změny vrstvy objektu Tato hodnota se vrátí pouze v případě, že byla někdy nastavena úroveň objektu blob bloku.

accessTierChangedOn?: Date

Hodnota vlastnosti

Date

accessTierInferred

Pouze pro objekty blob stránky v účtu úložiště úrovně Premium. Pokud úroveň přístupu není u objektu blob explicitně nastavená, odvozuje se na základě délky obsahu a tato hlavička se vrátí se skutečnou hodnotou.

accessTierInferred?: boolean

Hodnota vlastnosti

boolean

archiveStatus

Pro účty LRS úložiště objektů blob jsou platné hodnoty rehydrate-pending-to-hot/rehydrate-pending-to-cool. Pokud se objekt blob rehydruje a není dokončený, vrátí se tato hlavička, která značí, že čeká na dosazování, a informuje také cílovou vrstvu.

archiveStatus?: 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

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

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

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

Velikost objektu blob v bajtech. Pro objekt blob stránky tato hlavička vrátí hodnotu hlavičky x-ms-blob-content-length, která je uložená s objektem blob.

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

contentType

Typ obsahu zadaný pro objekt blob. Výchozí typ obsahu je 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, kdy 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 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 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

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

destinationSnapshot

Zahrne se, pokud je objekt blob přírůstkovým kopírováním objektu blob nebo přírůstkového kopírování snímek, pokud je x-ms-copy-status úspěšný. Čas posledního úspěšného přírůstkového kopírování snímku tohoto objektu blob.

destinationSnapshot?: string

Hodnota vlastnosti

string

encryptionKeySha256

Hodnota hash SHA-256 šifrovacího klíče použitého k šifrování metadat. Tato hlavička se vrátí pouze v případě, že metadata byla zašifrována 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

expiresOn

Čas vypršení platnosti tohoto objektu blob

expiresOn?: Date

Hodnota vlastnosti

Date

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

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

isIncrementalCopy

Zahrne se, pokud se jedná o objekt blob přírůstkového kopírování.

isIncrementalCopy?: 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 objektu blob. 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

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?: [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

rehydratePriority

Pokud je objekt ve stavu čekání na rehydraci, vrátí se tato hlavička s prioritou rehydratace.

rehydratePriority?: RehydratePriority

Hodnota vlastnosti

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