Freigeben über


BlobQueryHeaders interface

Definiert Header für Blob_query Vorgang.

Eigenschaften

acceptRanges

Gibt an, dass der Dienst Anforderungen für teilweisen BLOB-Inhalt unterstützt.

blobCommittedBlockCount

Die Anzahl der committeten Blöcke, die im Blob vorhanden sind. Dieser Header wird nur für Anfügeblobs zurückgegeben.

blobContentMD5

Wenn das Blob über einen MD5-Hash verfügt und die Anforderung einen Bereichsheader (Range oder x-ms-range) enthält, wird dieser Antwortheader mit dem Wert des MD5-Werts des gesamten Blobs zurückgegeben. Dieser Wert kann gleich dem wert sein, der im Content-MD5-Header zurückgegeben wird, wobei letzterer aus dem angeforderten Bereich berechnet wird.

blobSequenceNumber

Die aktuelle Sequenznummer für ein Seitenblob. Dieser Header wird nicht für Blockblobs oder Anfügeblobs zurückgegeben.

blobType

Der Blobtyp.

cacheControl

Dieser Header wird zurückgegeben, wenn er zuvor für das BLOB angegeben wurde.

clientRequestId

Wenn in der Anforderung ein Header der Clientanforderungs-ID gesendet wird, ist dieser Header in der Antwort mit demselben Wert vorhanden.

contentCrc64

Wenn die Anforderung einen angegebenen Bereich lesen soll und x-ms-range-get-content-crc64 auf true festgelegt ist, gibt die Anforderung einen crc64-Wert für den Bereich zurück, solange die Bereichsgröße kleiner als oder gleich 4 MB ist. Wenn x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 in derselben Anforderung angegeben wird, schlägt dies mit 400(Bad Request) fehl.

contentDisposition

Dieser Header gibt den Wert zurück, der für den Header "x-ms-blob-content-disposition" angegeben wurde. Das Feld Content-Disposition-Antwortheader enthält zusätzliche Informationen zur Verarbeitung der Antwortnutzlast und kann auch zum Anfügen zusätzlicher Metadaten verwendet werden. Wenn sie beispielsweise auf Anlage festgelegt ist, gibt dies an, dass der Benutzer-Agent die Antwort nicht anzeigen soll, sondern stattdessen ein Dialogfeld Speichern unter mit einem anderen Dateinamen als dem angegebenen Blobnamen anzeigen soll.

contentEncoding

Dieser Header gibt den Wert zurück, der für den Anforderungsheader "Content-Encoding" angegeben wurde.

contentLanguage

Dieser Header gibt den Wert zurück, der für den Content-Language-Anforderungsheader angegeben wurde.

contentLength

Die Anzahl der im Antworttext vorhandenen Bytes.

contentMD5

Wenn das Blob über einen MD5-Hash verfügt und dieser Vorgang das vollständige Blob lesen soll, wird dieser Antwortheader zurückgegeben, damit der Client die Integrität des Nachrichteninhalts überprüfen kann.

contentRange

Gibt den Bereich von Bytes an, der zurückgegeben wird, wenn der Client eine Teilmenge des Blobs angefordert hat, indem der Anforderungsheader "Bereich" festgelegt wird.

contentType

Der Medientyp des Textkörpers der Antwort. Für "Blob herunterladen" lautet dies "application/octet-stream".

copyCompletionTime

Abschlusszeit des letzten versuchten Kopierblobvorgangs, bei dem dieses Blob das Zielblob war. Dieser Wert kann die Zeit eines abgeschlossenen, abgebrochenen oder fehlgeschlagenen Kopierversuchs angeben. Dieser Header wird nicht angezeigt, wenn eine Kopie aussteht, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopierblobvorgang mithilfe von Set Blob Properties, Put Blob oder Put Block List geändert wurde.

copyId

Zeichenfolgenbezeichner für diesen Kopiervorgang. Verwenden Sie mit Get Blob Properties (Blobeigenschaften abrufen), um die status dieses Kopiervorgangs zu überprüfen, oder übergeben Sie an Abbruch des Kopierblobs, um eine ausstehende Kopie abzubrechen.

copyProgress

Enthält die Anzahl der kopierten Bytes und die Gesamtbytes in der Quelle beim letzten versuchten Kopierblobvorgang, bei dem dieses Blob das Zielblob war. Kann zwischen 0 und Kopierte Bytes mit Inhaltslänge anzeigen. Dieser Header wird nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopierblobvorgang mithilfe von Set Blob Properties, Put Blob oder Put Block List geändert wurde.

copySource

URL mit einer Länge von bis zu 2 KB, die das Quellblob oder die Quelldatei angibt, die beim letzten versuchten Kopierblob-Vorgang verwendet wurde, bei dem es sich um das Zielblob handelte. Dieser Header wird nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopierblobvorgang mit Set Blob Properties, Put Blob oder Put Block List geändert wurde.

copyStatus

Zustand des Kopiervorgangs, der durch x-ms-copy-id identifiziert wird.

copyStatusDescription

Wird nur angezeigt, wenn x-ms-copy-status fehlgeschlagen oder ausstehend ist. Beschreibt die Ursache des letzten schwerwiegenden oder nicht schwerwiegenden Fehlers eines Kopiervorgangs. Dieser Header wird nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopierblobvorgang mithilfe von Set Blob Properties, Put Blob oder Put Block List geändert wurde.

date

Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der die Antwort initiiert wurde

encryptionKeySha256

Der SHA-256-Hash des Verschlüsselungsschlüssels, der zum Verschlüsseln des Blobs verwendet wird. Dieser Header wird nur zurückgegeben, wenn das Blob mit einem vom Kunden bereitgestellten Schlüssel verschlüsselt wurde.

encryptionScope

Gibt den Namen des Verschlüsselungsbereichs zurück, der zum Verschlüsseln des Blobinhalts und der Anwendungsmetadaten verwendet wird. Beachten Sie, dass das Fehlen dieses Headers die Verwendung des Standardkontoverschlüsselungsbereichs impliziert.

errorCode

Fehlercode

etag

Das ETag enthält einen Wert, den Sie verwenden können, um Vorgänge bedingt auszuführen. Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen eingeschlossen.

isServerEncrypted

Der Wert dieses Headers wird auf true festgelegt, wenn die Blobdaten und Anwendungsmetadaten mit dem angegebenen Algorithmus vollständig verschlüsselt werden. Andernfalls wird der Wert auf false festgelegt (wenn das Blob unverschlüsselt ist oder wenn nur Teile der Blob-/Anwendungsmetadaten verschlüsselt werden).

lastModified

Gibt das Datum und die Uhrzeit der letzten Änderung des Containers zurück. Durch jeden Vorgang, der das BLOB ändert, einschließlich eines Updates der Metadaten oder Eigenschaften des BLOB, wird die Uhrzeit der letzten Änderung aktualisiert.

leaseDuration

Gibt für ein geleastes BLOB an, ob die Lease von unbegrenzter oder fester Dauer ist.

leaseState

Der Leasestatus des BLOB.

leaseStatus

Der aktuelle Leasestatus des BLOB.

metadata
requestId

Dieser Header identifiziert die erfolgte Anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden.

version

Gibt die Version des Blob-Diensts an, der zum Ausführen der Abfrage verwendet wird. Dieser Header wird für Anforderungen zurückgegeben, die für Version 2009-09-19 und höher erfolgen.

Details zur Eigenschaft

acceptRanges

Gibt an, dass der Dienst Anforderungen für teilweisen BLOB-Inhalt unterstützt.

acceptRanges?: string

Eigenschaftswert

string

blobCommittedBlockCount

Die Anzahl der committeten Blöcke, die im Blob vorhanden sind. Dieser Header wird nur für Anfügeblobs zurückgegeben.

blobCommittedBlockCount?: number

Eigenschaftswert

number

blobContentMD5

Wenn das Blob über einen MD5-Hash verfügt und die Anforderung einen Bereichsheader (Range oder x-ms-range) enthält, wird dieser Antwortheader mit dem Wert des MD5-Werts des gesamten Blobs zurückgegeben. Dieser Wert kann gleich dem wert sein, der im Content-MD5-Header zurückgegeben wird, wobei letzterer aus dem angeforderten Bereich berechnet wird.

blobContentMD5?: Uint8Array

Eigenschaftswert

Uint8Array

blobSequenceNumber

Die aktuelle Sequenznummer für ein Seitenblob. Dieser Header wird nicht für Blockblobs oder Anfügeblobs zurückgegeben.

blobSequenceNumber?: number

Eigenschaftswert

number

blobType

Der Blobtyp.

blobType?: BlobType

Eigenschaftswert

cacheControl

Dieser Header wird zurückgegeben, wenn er zuvor für das BLOB angegeben wurde.

cacheControl?: string

Eigenschaftswert

string

clientRequestId

Wenn in der Anforderung ein Header der Clientanforderungs-ID gesendet wird, ist dieser Header in der Antwort mit demselben Wert vorhanden.

clientRequestId?: string

Eigenschaftswert

string

contentCrc64

Wenn die Anforderung einen angegebenen Bereich lesen soll und x-ms-range-get-content-crc64 auf true festgelegt ist, gibt die Anforderung einen crc64-Wert für den Bereich zurück, solange die Bereichsgröße kleiner als oder gleich 4 MB ist. Wenn x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 in derselben Anforderung angegeben wird, schlägt dies mit 400(Bad Request) fehl.

contentCrc64?: Uint8Array

Eigenschaftswert

Uint8Array

contentDisposition

Dieser Header gibt den Wert zurück, der für den Header "x-ms-blob-content-disposition" angegeben wurde. Das Feld Content-Disposition-Antwortheader enthält zusätzliche Informationen zur Verarbeitung der Antwortnutzlast und kann auch zum Anfügen zusätzlicher Metadaten verwendet werden. Wenn sie beispielsweise auf Anlage festgelegt ist, gibt dies an, dass der Benutzer-Agent die Antwort nicht anzeigen soll, sondern stattdessen ein Dialogfeld Speichern unter mit einem anderen Dateinamen als dem angegebenen Blobnamen anzeigen soll.

contentDisposition?: string

Eigenschaftswert

string

contentEncoding

Dieser Header gibt den Wert zurück, der für den Anforderungsheader "Content-Encoding" angegeben wurde.

contentEncoding?: string

Eigenschaftswert

string

contentLanguage

Dieser Header gibt den Wert zurück, der für den Content-Language-Anforderungsheader angegeben wurde.

contentLanguage?: string

Eigenschaftswert

string

contentLength

Die Anzahl der im Antworttext vorhandenen Bytes.

contentLength?: number

Eigenschaftswert

number

contentMD5

Wenn das Blob über einen MD5-Hash verfügt und dieser Vorgang das vollständige Blob lesen soll, wird dieser Antwortheader zurückgegeben, damit der Client die Integrität des Nachrichteninhalts überprüfen kann.

contentMD5?: Uint8Array

Eigenschaftswert

Uint8Array

contentRange

Gibt den Bereich von Bytes an, der zurückgegeben wird, wenn der Client eine Teilmenge des Blobs angefordert hat, indem der Anforderungsheader "Bereich" festgelegt wird.

contentRange?: string

Eigenschaftswert

string

contentType

Der Medientyp des Textkörpers der Antwort. Für "Blob herunterladen" lautet dies "application/octet-stream".

contentType?: string

Eigenschaftswert

string

copyCompletionTime

Abschlusszeit des letzten versuchten Kopierblobvorgangs, bei dem dieses Blob das Zielblob war. Dieser Wert kann die Zeit eines abgeschlossenen, abgebrochenen oder fehlgeschlagenen Kopierversuchs angeben. Dieser Header wird nicht angezeigt, wenn eine Kopie aussteht, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopierblobvorgang mithilfe von Set Blob Properties, Put Blob oder Put Block List geändert wurde.

copyCompletionTime?: Date

Eigenschaftswert

Date

copyId

Zeichenfolgenbezeichner für diesen Kopiervorgang. Verwenden Sie mit Get Blob Properties (Blobeigenschaften abrufen), um die status dieses Kopiervorgangs zu überprüfen, oder übergeben Sie an Abbruch des Kopierblobs, um eine ausstehende Kopie abzubrechen.

copyId?: string

Eigenschaftswert

string

copyProgress

Enthält die Anzahl der kopierten Bytes und die Gesamtbytes in der Quelle beim letzten versuchten Kopierblobvorgang, bei dem dieses Blob das Zielblob war. Kann zwischen 0 und Kopierte Bytes mit Inhaltslänge anzeigen. Dieser Header wird nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopierblobvorgang mithilfe von Set Blob Properties, Put Blob oder Put Block List geändert wurde.

copyProgress?: string

Eigenschaftswert

string

copySource

URL mit einer Länge von bis zu 2 KB, die das Quellblob oder die Quelldatei angibt, die beim letzten versuchten Kopierblob-Vorgang verwendet wurde, bei dem es sich um das Zielblob handelte. Dieser Header wird nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopierblobvorgang mit Set Blob Properties, Put Blob oder Put Block List geändert wurde.

copySource?: string

Eigenschaftswert

string

copyStatus

Zustand des Kopiervorgangs, der durch x-ms-copy-id identifiziert wird.

copyStatus?: CopyStatusType

Eigenschaftswert

copyStatusDescription

Wird nur angezeigt, wenn x-ms-copy-status fehlgeschlagen oder ausstehend ist. Beschreibt die Ursache des letzten schwerwiegenden oder nicht schwerwiegenden Fehlers eines Kopiervorgangs. Dieser Header wird nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopierblobvorgang mithilfe von Set Blob Properties, Put Blob oder Put Block List geändert wurde.

copyStatusDescription?: string

Eigenschaftswert

string

date

Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der die Uhrzeit angibt, zu der die Antwort initiiert wurde

date?: Date

Eigenschaftswert

Date

encryptionKeySha256

Der SHA-256-Hash des Verschlüsselungsschlüssels, der zum Verschlüsseln des Blobs verwendet wird. Dieser Header wird nur zurückgegeben, wenn das Blob mit einem vom Kunden bereitgestellten Schlüssel verschlüsselt wurde.

encryptionKeySha256?: string

Eigenschaftswert

string

encryptionScope

Gibt den Namen des Verschlüsselungsbereichs zurück, der zum Verschlüsseln des Blobinhalts und der Anwendungsmetadaten verwendet wird. Beachten Sie, dass das Fehlen dieses Headers die Verwendung des Standardkontoverschlüsselungsbereichs impliziert.

encryptionScope?: string

Eigenschaftswert

string

errorCode

Fehlercode

errorCode?: string

Eigenschaftswert

string

etag

Das ETag enthält einen Wert, den Sie verwenden können, um Vorgänge bedingt auszuführen. Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen eingeschlossen.

etag?: string

Eigenschaftswert

string

isServerEncrypted

Der Wert dieses Headers wird auf true festgelegt, wenn die Blobdaten und Anwendungsmetadaten mit dem angegebenen Algorithmus vollständig verschlüsselt werden. Andernfalls wird der Wert auf false festgelegt (wenn das Blob unverschlüsselt ist oder wenn nur Teile der Blob-/Anwendungsmetadaten verschlüsselt werden).

isServerEncrypted?: boolean

Eigenschaftswert

boolean

lastModified

Gibt das Datum und die Uhrzeit der letzten Änderung des Containers zurück. Durch jeden Vorgang, der das BLOB ändert, einschließlich eines Updates der Metadaten oder Eigenschaften des BLOB, wird die Uhrzeit der letzten Änderung aktualisiert.

lastModified?: Date

Eigenschaftswert

Date

leaseDuration

Gibt für ein geleastes BLOB an, ob die Lease von unbegrenzter oder fester Dauer ist.

leaseDuration?: LeaseDurationType

Eigenschaftswert

leaseState

Der Leasestatus des BLOB.

leaseState?: LeaseStateType

Eigenschaftswert

leaseStatus

Der aktuelle Leasestatus des BLOB.

leaseStatus?: LeaseStatusType

Eigenschaftswert

metadata

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

Eigenschaftswert

{[propertyName: string]: string}

requestId

Dieser Header identifiziert die erfolgte Anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden.

requestId?: string

Eigenschaftswert

string

version

Gibt die Version des Blob-Diensts an, der zum Ausführen der Abfrage verwendet wird. Dieser Header wird für Anforderungen zurückgegeben, die für Version 2009-09-19 und höher erfolgen.

version?: string

Eigenschaftswert

string