Udostępnij za pośrednictwem


BlobGetPropertiesHeaders interface

Definiuje nagłówki dla operacji Blob_getProperties.

Właściwości

acceptRanges

Wskazuje, że usługa obsługuje żądania częściowej zawartości obiektu blob.

accessTier

Warstwa stronicowego obiektu blob na koncie magazynu w warstwie Premium lub warstwie blokowego obiektu blob na kontach LRS magazynu obiektów blob. Aby uzyskać listę dozwolonych warstw stronicowych obiektów blob w warstwie Premium, zobacz https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. W przypadku kont magazynu obiektów blob LRS prawidłowe wartości to Gorąca/Chłodna/Archiwum.

accessTierChangedOn

Czas zmiany warstwy w obiekcie. Jest to zwracane tylko wtedy, gdy warstwa blokowego obiektu blob kiedykolwiek została ustawiona.

accessTierInferred

W przypadku stronicowych obiektów blob tylko na koncie magazynu w warstwie Premium. Jeśli warstwa dostępu nie jest jawnie ustawiona na obiekcie blob, warstwa jest wnioskowana na podstawie jego długości zawartości, a ten nagłówek zostanie zwrócony z wartością true.

archiveStatus

W przypadku kont magazynu obiektów blob LRS prawidłowe wartości są ponownie wypełniania oczekujących na gorącą/ponownie oczekującą na chłodną. Jeśli obiekt blob jest ponownie wypełniany i nie zostanie ukończony, zostanie zwrócony ten nagłówek wskazujący, że ponowne wypełnianie jest oczekujące, a także informuje warstwę docelową.

blobCommittedBlockCount

Liczba zatwierdzonych bloków znajdujących się w obiekcie blob. Ten nagłówek jest zwracany tylko dla uzupełnialnych obiektów blob.

blobSequenceNumber

Bieżący numer sekwencji dla stronicowego obiektu blob. Ten nagłówek nie jest zwracany dla blokowych obiektów blob ani uzupełnialnych obiektów blob

blobType

Typ obiektu blob.

cacheControl

Ten nagłówek jest zwracany, jeśli został wcześniej określony dla obiektu blob.

clientRequestId

Jeśli nagłówek identyfikatora żądania klienta jest wysyłany w żądaniu, ten nagłówek będzie obecny w odpowiedzi o tej samej wartości.

contentDisposition

Ten nagłówek zwraca wartość, która została określona dla nagłówka "x-ms-blob-content-disposition". Pole nagłówka odpowiedzi Content-Disposition przekazuje dodatkowe informacje na temat przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych. Jeśli na przykład ustawiono wartość załącznika, oznacza to, że agent-użytkownik nie powinien wyświetlać odpowiedzi, ale zamiast tego wyświetli okno dialogowe Zapisz jako z nazwą inną niż określona nazwa obiektu blob.

contentEncoding

Ten nagłówek zwraca wartość, która została określona dla nagłówka żądania kodowania zawartości

contentLanguage

Ten nagłówek zwraca wartość, która została określona dla nagłówka żądania Content-Language.

contentLength

Rozmiar obiektu blob w bajtach. W przypadku stronicowego obiektu blob ten nagłówek zwraca wartość nagłówka x-ms-blob-content-length przechowywanego w obiekcie blob.

contentMD5

Jeśli obiekt blob ma skrót MD5, a ta operacja polega na odczytaniu pełnego obiektu blob, ten nagłówek odpowiedzi jest zwracany, aby klient mógł sprawdzić integralność zawartości komunikatu.

contentType

Typ zawartości określony dla obiektu blob. Domyślnym typem zawartości jest "application/octet-stream"

copyCompletedOn

Czas ostatniej próby skopiowania obiektu blob, w którym ten obiekt blob był docelowym obiektem blob. Ta wartość może określać czas ukończenia, przerwania lub nieudanej próby kopiowania. Ten nagłówek nie pojawia się, jeśli kopia jest oczekująca, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji kopiowania obiektu blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji kopiowania obiektu blob przy użyciu ustawiania właściwości obiektu blob, umieść obiekt blob lub umieść listę bloków.

copyId

Identyfikator ciągu dla tej operacji kopiowania. Użyj polecenia Get Blob Properties (Pobierz właściwości obiektu blob), aby sprawdzić stan tej operacji kopiowania lub przekazać polecenie Abort Copy Blob (Przerwanie kopiowania obiektu blob), aby przerwać oczekującą kopię.

copyProgress

Zawiera liczbę skopiowanych bajtów i łączną liczbę bajtów w źródle podczas ostatniej próby operacji kopiowania obiektu blob, w której ten obiekt blob był docelowym obiektem blob. Może pokazywać skopiowane bajty o długości od 0 do zawartości. Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji kopiowania obiektu blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji kopiowania obiektu blob przy użyciu ustawiania właściwości obiektu blob, umieść obiekt blob lub umieść listę bloków

copySource

Adres URL o długości do 2 KB, który określa źródłowy obiekt blob lub plik używany w ostatniej próbie kopiowania obiektu blob, gdzie ten obiekt blob był docelowym obiektem blob. Ten nagłówek nie pojawia się, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji kopiowania obiektu blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji kopiowania obiektu blob przy użyciu funkcji Ustaw właściwości obiektu blob, Umieść obiekt blob lub Umieść listę bloków.

copyStatus

Stan operacji kopiowania zidentyfikowanej przez x-ms-copy-id.

copyStatusDescription

Pojawia się tylko wtedy, gdy stan x-ms-copy-status jest niepowodzeniem lub oczekiwaniem. Opisuje przyczynę ostatniej krytycznej lub niekrytycznej operacji kopiowania. Ten nagłówek nie jest wyświetlany, jeśli obiekt blob nigdy nie był miejscem docelowym operacji kopiowania obiektu blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji kopiowania obiektu blob przy użyciu ustawiania właściwości obiektu blob, umieszczania obiektu blob lub umieszczania listy blokowej

createdOn

Zwraca datę i godzinę utworzenia obiektu blob.

date

Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę, o której zainicjowano odpowiedź

destinationSnapshot

Uwzględniane, jeśli obiekt blob jest przyrostowym kopiowaniem obiektu blob lub migawką kopii przyrostowej, jeśli stan x-ms-copy-status to powodzenie. Czas migawki ostatniej pomyślnej migawki kopiowania przyrostowego dla tego obiektu blob.

encryptionKeySha256

Skrót SHA-256 klucza szyfrowania używany do szyfrowania metadanych. Ten nagłówek jest zwracany tylko wtedy, gdy metadane zostały zaszyfrowane przy użyciu klucza dostarczonego przez klienta.

encryptionScope

Zwraca nazwę zakresu szyfrowania używanego do szyfrowania zawartości obiektu blob i metadanych aplikacji. Należy pamiętać, że brak tego nagłówka oznacza użycie domyślnego zakresu szyfrowania konta.

errorCode

Kod błędu

etag

Element ETag zawiera wartość, której można użyć do warunkowego wykonywania operacji. Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość elementu ETag będzie znajdować się w cudzysłowie.

expiresOn

Czas wygaśnięcia tego obiektu blob.

immutabilityPolicyExpiresOn

Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę wygaśnięcia zasad niezmienności obiektów blob.

immutabilityPolicyMode

Wskazuje tryb zasad niezmienności.

isCurrentVersion

Wartość tego nagłówka wskazuje, czy wersja tego obiektu blob jest bieżącą wersją, zobacz również nagłówek x-ms-version-id.

isIncrementalCopy

Uwzględniane, jeśli obiekt blob jest obiektem blob kopiowania przyrostowego.

isSealed

Jeśli ten obiekt blob został zapieczętowany

isServerEncrypted

Wartość tego nagłówka jest ustawiona na wartość true, jeśli dane obiektu blob i metadane aplikacji są całkowicie szyfrowane przy użyciu określonego algorytmu. W przeciwnym razie wartość jest ustawiona na false (gdy obiekt blob jest niezaszyfrowany lub jeśli zaszyfrowane są tylko części metadanych obiektu blob/aplikacji).

lastAccessed

Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę ostatniego odczytu lub zapisu obiektu blob

lastModified

Zwraca datę i godzinę ostatniej modyfikacji obiektu blob. Każda operacja modyfikując obiekt blob, w tym aktualizację metadanych lub właściwości obiektu blob, zmienia czas ostatniej modyfikacji obiektu blob.

leaseDuration

Gdy obiekt blob jest dzierżawiony, określa, czy dzierżawa ma nieskończony, czy stały czas trwania.

leaseState

Stan dzierżawy obiektu blob.

leaseStatus

Bieżący stan dzierżawy obiektu blob.

legalHold

Wskazuje, czy w obiekcie blob znajduje się archiwizacja ze względów prawnych.

metadata
objectReplicationPolicyId

Opcjonalny. Prawidłowe tylko wtedy, gdy replikacja obiektów jest włączona dla kontenera magazynu i docelowego obiektu blob replikacji.

objectReplicationRules

Opcjonalny. Prawidłowe tylko wtedy, gdy replikacja obiektów jest włączona dla kontenera magazynu i źródłowego obiektu blob replikacji. Podczas pobierania tego nagłówka zostanie zwrócony nagłówek z identyfikatorem zasad i identyfikatorem reguły (np. x-ms-or-policyid_ruleid), a wartość będzie stanem replikacji (np. ukończenie, niepowodzenie).

rehydratePriority

Jeśli obiekt jest w stanie oczekiwania na ponowne wypełnianie, ten nagłówek jest zwracany z priorytetem ponownego wypełniania.

requestId

Ten nagłówek jednoznacznie identyfikuje żądanie, które zostało wykonane i może służyć do rozwiązywania problemów z żądaniem.

tagCount

Liczba tagów skojarzonych z obiektem blob

version

Wskazuje wersję usługi Blob Service używaną do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań wysyłanych w wersji 2009-09-19 lub nowszej.

versionId

Wartość DateTime zwrócona przez usługę, która jednoznacznie identyfikuje obiekt blob. Wartość tego nagłówka wskazuje wersję obiektu blob i może być używana w kolejnych żądaniach dostępu do tej wersji obiektu blob.

Szczegóły właściwości

acceptRanges

Wskazuje, że usługa obsługuje żądania częściowej zawartości obiektu blob.

acceptRanges?: string

Wartość właściwości

string

accessTier

Warstwa stronicowego obiektu blob na koncie magazynu w warstwie Premium lub warstwie blokowego obiektu blob na kontach LRS magazynu obiektów blob. Aby uzyskać listę dozwolonych warstw stronicowych obiektów blob w warstwie Premium, zobacz https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. W przypadku kont magazynu obiektów blob LRS prawidłowe wartości to Gorąca/Chłodna/Archiwum.

accessTier?: string

Wartość właściwości

string

accessTierChangedOn

Czas zmiany warstwy w obiekcie. Jest to zwracane tylko wtedy, gdy warstwa blokowego obiektu blob kiedykolwiek została ustawiona.

accessTierChangedOn?: Date

Wartość właściwości

Date

accessTierInferred

W przypadku stronicowych obiektów blob tylko na koncie magazynu w warstwie Premium. Jeśli warstwa dostępu nie jest jawnie ustawiona na obiekcie blob, warstwa jest wnioskowana na podstawie jego długości zawartości, a ten nagłówek zostanie zwrócony z wartością true.

accessTierInferred?: boolean

Wartość właściwości

boolean

archiveStatus

W przypadku kont magazynu obiektów blob LRS prawidłowe wartości są ponownie wypełniania oczekujących na gorącą/ponownie oczekującą na chłodną. Jeśli obiekt blob jest ponownie wypełniany i nie zostanie ukończony, zostanie zwrócony ten nagłówek wskazujący, że ponowne wypełnianie jest oczekujące, a także informuje warstwę docelową.

archiveStatus?: string

Wartość właściwości

string

blobCommittedBlockCount

Liczba zatwierdzonych bloków znajdujących się w obiekcie blob. Ten nagłówek jest zwracany tylko dla uzupełnialnych obiektów blob.

blobCommittedBlockCount?: number

Wartość właściwości

number

blobSequenceNumber

Bieżący numer sekwencji dla stronicowego obiektu blob. Ten nagłówek nie jest zwracany dla blokowych obiektów blob ani uzupełnialnych obiektów blob

blobSequenceNumber?: number

Wartość właściwości

number

blobType

Typ obiektu blob.

blobType?: BlobType

Wartość właściwości

cacheControl

Ten nagłówek jest zwracany, jeśli został wcześniej określony dla obiektu blob.

cacheControl?: string

Wartość właściwości

string

clientRequestId

Jeśli nagłówek identyfikatora żądania klienta jest wysyłany w żądaniu, ten nagłówek będzie obecny w odpowiedzi o tej samej wartości.

clientRequestId?: string

Wartość właściwości

string

contentDisposition

Ten nagłówek zwraca wartość, która została określona dla nagłówka "x-ms-blob-content-disposition". Pole nagłówka odpowiedzi Content-Disposition przekazuje dodatkowe informacje na temat przetwarzania ładunku odpowiedzi, a także może służyć do dołączania dodatkowych metadanych. Jeśli na przykład ustawiono wartość załącznika, oznacza to, że agent-użytkownik nie powinien wyświetlać odpowiedzi, ale zamiast tego wyświetli okno dialogowe Zapisz jako z nazwą inną niż określona nazwa obiektu blob.

contentDisposition?: string

Wartość właściwości

string

contentEncoding

Ten nagłówek zwraca wartość, która została określona dla nagłówka żądania kodowania zawartości

contentEncoding?: string

Wartość właściwości

string

contentLanguage

Ten nagłówek zwraca wartość, która została określona dla nagłówka żądania Content-Language.

contentLanguage?: string

Wartość właściwości

string

contentLength

Rozmiar obiektu blob w bajtach. W przypadku stronicowego obiektu blob ten nagłówek zwraca wartość nagłówka x-ms-blob-content-length przechowywanego w obiekcie blob.

contentLength?: number

Wartość właściwości

number

contentMD5

Jeśli obiekt blob ma skrót MD5, a ta operacja polega na odczytaniu pełnego obiektu blob, ten nagłówek odpowiedzi jest zwracany, aby klient mógł sprawdzić integralność zawartości komunikatu.

contentMD5?: Uint8Array

Wartość właściwości

Uint8Array

contentType

Typ zawartości określony dla obiektu blob. Domyślnym typem zawartości jest "application/octet-stream"

contentType?: string

Wartość właściwości

string

copyCompletedOn

Czas ostatniej próby skopiowania obiektu blob, w którym ten obiekt blob był docelowym obiektem blob. Ta wartość może określać czas ukończenia, przerwania lub nieudanej próby kopiowania. Ten nagłówek nie pojawia się, jeśli kopia jest oczekująca, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji kopiowania obiektu blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji kopiowania obiektu blob przy użyciu ustawiania właściwości obiektu blob, umieść obiekt blob lub umieść listę bloków.

copyCompletedOn?: Date

Wartość właściwości

Date

copyId

Identyfikator ciągu dla tej operacji kopiowania. Użyj polecenia Get Blob Properties (Pobierz właściwości obiektu blob), aby sprawdzić stan tej operacji kopiowania lub przekazać polecenie Abort Copy Blob (Przerwanie kopiowania obiektu blob), aby przerwać oczekującą kopię.

copyId?: string

Wartość właściwości

string

copyProgress

Zawiera liczbę skopiowanych bajtów i łączną liczbę bajtów w źródle podczas ostatniej próby operacji kopiowania obiektu blob, w której ten obiekt blob był docelowym obiektem blob. Może pokazywać skopiowane bajty o długości od 0 do zawartości. Ten nagłówek nie jest wyświetlany, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji kopiowania obiektu blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji kopiowania obiektu blob przy użyciu ustawiania właściwości obiektu blob, umieść obiekt blob lub umieść listę bloków

copyProgress?: string

Wartość właściwości

string

copySource

Adres URL o długości do 2 KB, który określa źródłowy obiekt blob lub plik używany w ostatniej próbie kopiowania obiektu blob, gdzie ten obiekt blob był docelowym obiektem blob. Ten nagłówek nie pojawia się, jeśli ten obiekt blob nigdy nie był miejscem docelowym operacji kopiowania obiektu blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji kopiowania obiektu blob przy użyciu funkcji Ustaw właściwości obiektu blob, Umieść obiekt blob lub Umieść listę bloków.

copySource?: string

Wartość właściwości

string

copyStatus

Stan operacji kopiowania zidentyfikowanej przez x-ms-copy-id.

copyStatus?: CopyStatusType

Wartość właściwości

copyStatusDescription

Pojawia się tylko wtedy, gdy stan x-ms-copy-status jest niepowodzeniem lub oczekiwaniem. Opisuje przyczynę ostatniej krytycznej lub niekrytycznej operacji kopiowania. Ten nagłówek nie jest wyświetlany, jeśli obiekt blob nigdy nie był miejscem docelowym operacji kopiowania obiektu blob lub jeśli ten obiekt blob został zmodyfikowany po zakończeniu operacji kopiowania obiektu blob przy użyciu ustawiania właściwości obiektu blob, umieszczania obiektu blob lub umieszczania listy blokowej

copyStatusDescription?: string

Wartość właściwości

string

createdOn

Zwraca datę i godzinę utworzenia obiektu blob.

createdOn?: Date

Wartość właściwości

Date

date

Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę, o której zainicjowano odpowiedź

date?: Date

Wartość właściwości

Date

destinationSnapshot

Uwzględniane, jeśli obiekt blob jest przyrostowym kopiowaniem obiektu blob lub migawką kopii przyrostowej, jeśli stan x-ms-copy-status to powodzenie. Czas migawki ostatniej pomyślnej migawki kopiowania przyrostowego dla tego obiektu blob.

destinationSnapshot?: string

Wartość właściwości

string

encryptionKeySha256

Skrót SHA-256 klucza szyfrowania używany do szyfrowania metadanych. Ten nagłówek jest zwracany tylko wtedy, gdy metadane zostały zaszyfrowane przy użyciu klucza dostarczonego przez klienta.

encryptionKeySha256?: string

Wartość właściwości

string

encryptionScope

Zwraca nazwę zakresu szyfrowania używanego do szyfrowania zawartości obiektu blob i metadanych aplikacji. Należy pamiętać, że brak tego nagłówka oznacza użycie domyślnego zakresu szyfrowania konta.

encryptionScope?: string

Wartość właściwości

string

errorCode

Kod błędu

errorCode?: string

Wartość właściwości

string

etag

Element ETag zawiera wartość, której można użyć do warunkowego wykonywania operacji. Jeśli wersja żądania to 2011-08-18 lub nowsza, wartość elementu ETag będzie znajdować się w cudzysłowie.

etag?: string

Wartość właściwości

string

expiresOn

Czas wygaśnięcia tego obiektu blob.

expiresOn?: Date

Wartość właściwości

Date

immutabilityPolicyExpiresOn

Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę wygaśnięcia zasad niezmienności obiektów blob.

immutabilityPolicyExpiresOn?: Date

Wartość właściwości

Date

immutabilityPolicyMode

Wskazuje tryb zasad niezmienności.

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Wartość właściwości

isCurrentVersion

Wartość tego nagłówka wskazuje, czy wersja tego obiektu blob jest bieżącą wersją, zobacz również nagłówek x-ms-version-id.

isCurrentVersion?: boolean

Wartość właściwości

boolean

isIncrementalCopy

Uwzględniane, jeśli obiekt blob jest obiektem blob kopiowania przyrostowego.

isIncrementalCopy?: boolean

Wartość właściwości

boolean

isSealed

Jeśli ten obiekt blob został zapieczętowany

isSealed?: boolean

Wartość właściwości

boolean

isServerEncrypted

Wartość tego nagłówka jest ustawiona na wartość true, jeśli dane obiektu blob i metadane aplikacji są całkowicie szyfrowane przy użyciu określonego algorytmu. W przeciwnym razie wartość jest ustawiona na false (gdy obiekt blob jest niezaszyfrowany lub jeśli zaszyfrowane są tylko części metadanych obiektu blob/aplikacji).

isServerEncrypted?: boolean

Wartość właściwości

boolean

lastAccessed

Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę ostatniego odczytu lub zapisu obiektu blob

lastAccessed?: Date

Wartość właściwości

Date

lastModified

Zwraca datę i godzinę ostatniej modyfikacji obiektu blob. Każda operacja modyfikując obiekt blob, w tym aktualizację metadanych lub właściwości obiektu blob, zmienia czas ostatniej modyfikacji obiektu blob.

lastModified?: Date

Wartość właściwości

Date

leaseDuration

Gdy obiekt blob jest dzierżawiony, określa, czy dzierżawa ma nieskończony, czy stały czas trwania.

leaseDuration?: LeaseDurationType

Wartość właściwości

leaseState

Stan dzierżawy obiektu blob.

leaseState?: LeaseStateType

Wartość właściwości

leaseStatus

Bieżący stan dzierżawy obiektu blob.

leaseStatus?: LeaseStatusType

Wartość właściwości

legalHold

Wskazuje, czy w obiekcie blob znajduje się archiwizacja ze względów prawnych.

legalHold?: boolean

Wartość właściwości

boolean

metadata

metadata?: [key: string]: string

Wartość właściwości

[key: string]: string

objectReplicationPolicyId

Opcjonalny. Prawidłowe tylko wtedy, gdy replikacja obiektów jest włączona dla kontenera magazynu i docelowego obiektu blob replikacji.

objectReplicationPolicyId?: string

Wartość właściwości

string

objectReplicationRules

Opcjonalny. Prawidłowe tylko wtedy, gdy replikacja obiektów jest włączona dla kontenera magazynu i źródłowego obiektu blob replikacji. Podczas pobierania tego nagłówka zostanie zwrócony nagłówek z identyfikatorem zasad i identyfikatorem reguły (np. x-ms-or-policyid_ruleid), a wartość będzie stanem replikacji (np. ukończenie, niepowodzenie).

objectReplicationRules?: [key: string]: string

Wartość właściwości

[key: string]: string

rehydratePriority

Jeśli obiekt jest w stanie oczekiwania na ponowne wypełnianie, ten nagłówek jest zwracany z priorytetem ponownego wypełniania.

rehydratePriority?: RehydratePriority

Wartość właściwości

requestId

Ten nagłówek jednoznacznie identyfikuje żądanie, które zostało wykonane i może służyć do rozwiązywania problemów z żądaniem.

requestId?: string

Wartość właściwości

string

tagCount

Liczba tagów skojarzonych z obiektem blob

tagCount?: number

Wartość właściwości

number

version

Wskazuje wersję usługi Blob Service używaną do wykonania żądania. Ten nagłówek jest zwracany w przypadku żądań wysyłanych w wersji 2009-09-19 lub nowszej.

version?: string

Wartość właściwości

string

versionId

Wartość DateTime zwrócona przez usługę, która jednoznacznie identyfikuje obiekt blob. Wartość tego nagłówka wskazuje wersję obiektu blob i może być używana w kolejnych żądaniach dostępu do tej wersji obiektu blob.

versionId?: string

Wartość właściwości

string