Udostępnij za pośrednictwem


BlobQueryHeaders interface

Definiuje nagłówki dla operacji Blob_query.

Właściwości

acceptRanges

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

blobCommittedBlockCount

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

blobContentMD5

Jeśli obiekt blob ma skrót MD5, a żądanie zawiera nagłówek zakresu (Zakres lub x-ms-range), ten nagłówek odpowiedzi jest zwracany z wartością md5 całego obiektu blob. Ta wartość może lub nie może być równa wartości zwracanej w nagłówku Content-MD5, a ta ostatnia jest obliczana z żądanego zakresu

blobSequenceNumber

Bieżący numer sekwencji 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.

contentCrc64

Jeśli żądanie ma odczytać określony zakres, a parametr x-ms-range-get-content-crc64 ma wartość true, żądanie zwraca wartość crc64 dla zakresu, o ile rozmiar zakresu jest mniejszy lub równy 4 MB. Jeśli oba x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 zostanie określone w tym samym żądaniu, zakończy się niepowodzeniem z błędem 400(Nieprawidłowe żądanie).

contentDisposition

Ten nagłówek zwraca wartość określoną dla nagłówka "x-ms-blob-content-disposition". Pole nagłówka odpowiedzi Content-Disposition zawiera dodatkowe informacje o sposobie 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świetla okno dialogowe Zapisz jako z nazwą inną niż określona nazwa obiektu blob.

contentEncoding

Ten nagłówek zwraca wartość określoną dla nagłówka żądania content-encoding

contentLanguage

Ten nagłówek zwraca wartość określoną dla nagłówka żądania Content-Language.

contentLength

Liczba bajtów obecnych w treści odpowiedzi.

contentMD5

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

contentRange

Wskazuje zakres bajtów zwróconych w przypadku, gdy klient zażądał podzestawu obiektu blob, ustawiając nagłówek żądania "Zakres".

contentType

Typ nośnika treści odpowiedzi. W przypadku pobierania obiektu blob jest to "application/octet-stream"

copyCompletionTime

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 jest wyświetlany, jeśli oczekująca kopia, 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, umieszczania obiektu blob lub umieszczania listy blokowej.

copyId

Identyfikator ciągu dla tej operacji kopiowania. Użyj polecenia z poleceniem 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 oraz łączną liczbę bajtów w źródle w ostatniej próbie operacji kopiowania obiektu blob, w której obiekt blob był docelowym obiektem blob. Może pokazywać skopiowane bajty z zakresu od 0 do długości zawartości. 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

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 operacji kopiowania obiektu blob, gdzie ten obiekt blob był docelowym obiektem blob. 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 polecenia Ustaw właściwości obiektu blob, Umieść obiekt blob lub Umieść listę bloków.

copyStatus

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

copyStatusDescription

Pojawia się tylko wtedy, gdy stan x-ms-copy-status to niepowodzenie lub oczekiwanie. 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

date

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

encryptionKeySha256

Skrót SHA-256 klucza szyfrowania używany do szyfrowania obiektu blob. Ten nagłówek jest zwracany tylko wtedy, gdy obiekt blob został zaszyfrowany 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 w cudzysłowie.

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

lastModified

Zwraca datę i godzinę ostatniej modyfikacji kontenera. 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.

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

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.

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

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

blobContentMD5

Jeśli obiekt blob ma skrót MD5, a żądanie zawiera nagłówek zakresu (Zakres lub x-ms-range), ten nagłówek odpowiedzi jest zwracany z wartością md5 całego obiektu blob. Ta wartość może lub nie może być równa wartości zwracanej w nagłówku Content-MD5, a ta ostatnia jest obliczana z żądanego zakresu

blobContentMD5?: Uint8Array

Wartość właściwości

Uint8Array

blobSequenceNumber

Bieżący numer sekwencji 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

contentCrc64

Jeśli żądanie ma odczytać określony zakres, a parametr x-ms-range-get-content-crc64 ma wartość true, żądanie zwraca wartość crc64 dla zakresu, o ile rozmiar zakresu jest mniejszy lub równy 4 MB. Jeśli oba x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 zostanie określone w tym samym żądaniu, zakończy się niepowodzeniem z błędem 400(Nieprawidłowe żądanie).

contentCrc64?: Uint8Array

Wartość właściwości

Uint8Array

contentDisposition

Ten nagłówek zwraca wartość określoną dla nagłówka "x-ms-blob-content-disposition". Pole nagłówka odpowiedzi Content-Disposition zawiera dodatkowe informacje o sposobie 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świetla 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ść określoną dla nagłówka żądania content-encoding

contentEncoding?: string

Wartość właściwości

string

contentLanguage

Ten nagłówek zwraca wartość określoną dla nagłówka żądania Content-Language.

contentLanguage?: string

Wartość właściwości

string

contentLength

Liczba bajtów obecnych w treści odpowiedzi.

contentLength?: number

Wartość właściwości

number

contentMD5

Jeśli obiekt blob ma skrót MD5 i 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

contentRange

Wskazuje zakres bajtów zwróconych w przypadku, gdy klient zażądał podzestawu obiektu blob, ustawiając nagłówek żądania "Zakres".

contentRange?: string

Wartość właściwości

string

contentType

Typ nośnika treści odpowiedzi. W przypadku pobierania obiektu blob jest to "application/octet-stream"

contentType?: string

Wartość właściwości

string

copyCompletionTime

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 jest wyświetlany, jeśli oczekująca kopia, 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, umieszczania obiektu blob lub umieszczania listy blokowej.

copyCompletionTime?: Date

Wartość właściwości

Date

copyId

Identyfikator ciągu dla tej operacji kopiowania. Użyj polecenia z poleceniem 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 oraz łączną liczbę bajtów w źródle w ostatniej próbie operacji kopiowania obiektu blob, w której obiekt blob był docelowym obiektem blob. Może pokazywać skopiowane bajty z zakresu od 0 do długości zawartości. 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

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 operacji kopiowania obiektu blob, gdzie ten obiekt blob był docelowym obiektem blob. 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 polecenia 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 zidentyfikowany przez x-ms-copy-id.

copyStatus?: CopyStatusType

Wartość właściwości

copyStatusDescription

Pojawia się tylko wtedy, gdy stan x-ms-copy-status to niepowodzenie lub oczekiwanie. 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

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

encryptionKeySha256

Skrót SHA-256 klucza szyfrowania używany do szyfrowania obiektu blob. Ten nagłówek jest zwracany tylko wtedy, gdy obiekt blob został zaszyfrowany 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 w cudzysłowie.

etag?: string

Wartość właściwości

string

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

lastModified

Zwraca datę i godzinę ostatniej modyfikacji kontenera. 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

metadata

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

Wartość właściwości

{[propertyName: string]: string}

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

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