BlobDownloadHeaders interface

Paket:

@azure/storage-blob

Definiert Kopfzeilen für Blob_download Vorgang.

Eigenschaften

acceptRanges	Gibt an, dass der Dienst Anforderungen für partielle BLOB-Inhalte unterstützt.
blobCommittedBlockCount	Die Anzahl der zugesicherten Blöcke, die im Blob vorhanden sind. Dieser Header wird nur für Anfügeblobs zurückgegeben.
blobContentMD5	Wenn das Blob einen MD5-Hash aufweist und die Anforderung Bereichsheader (Range oder x-ms-range) enthält, wird dieser Antwortheader mit dem Wert des MD5-Werts des gesamten BLOB zurückgegeben. Dieser Wert kann dem wert entsprechen, der im Content-MD5-Header zurückgegeben wird, wobei letztere aus dem angeforderten Bereich berechnet wird.
blobSequenceNumber	Die aktuelle Sequenznummer für ein Seitenblob. Dieser Header wird nicht für Block-Blobs 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 ein Clientanforderungs-ID-Header in der Anforderung gesendet wird, ist dieser Header in der Antwort mit demselben Wert vorhanden.
contentCrc64	Wenn die Anforderung einen angegebenen Bereich lesen soll und der x-ms-range-get-content-crc64 auf "true" festgelegt ist, gibt die Anforderung einen crc64 für den Bereich zurück, solange die Bereichsgröße kleiner oder gleich 4 MB ist. Wenn sowohl x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 in derselben Anforderung angegeben ist, tritt ein Fehler mit 400(Bad Request) auf.
contentDisposition	Dieser Header gibt den Wert zurück, der für den Header "x-ms-blob-content-disposition" angegeben wurde. Das Antwortheaderfeld "Content-Disposition" vermittelt zusätzliche Informationen zum Verarbeiten der Antwortnutzlast und kann auch zum Anfügen zusätzlicher Metadaten verwendet werden. Wenn sie beispielsweise auf "Anlage" festgelegt ist, wird angegeben, dass der Benutzer-Agent die Antwort nicht anzeigen soll, sondern stattdessen ein Dialogfeld "Speichern unter" mit einem anderen Dateinamen als dem angegebenen BLOB-Namen anzeigen soll.
contentEncoding	Dieser Header gibt den Wert zurück, der für den Inhaltscodierungsanforderungsheader angegeben wurde.
contentLanguage	Dieser Header gibt den Wert zurück, der für den Anforderungsheader "Content-Language" angegeben wurde.
contentLength	Die Anzahl der Bytes, die im Antworttext vorhanden sind.
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 auf die Nachrichteninhaltsintegrität überprüfen kann.
contentRange	Gibt den Vom Client zurückgegebenen Bytebereich an, der eine Teilmenge des BLOB angefordert hat, indem der Anforderungsheader "Range" festgelegt wird.
contentType	Der Medientyp des Textkörpers der Antwort. Für "Blob herunterladen" lautet dies "application/octet-stream"
copyCompletedOn	Abschlusszeit des letzten versuchten Kopier-Blob-Vorgangs, bei dem es sich bei diesem Blob um das Zielblob handelte. Dieser Wert kann den Zeitpunkt eines abgeschlossenen, abgebrochenen oder fehlgeschlagenen Kopierversuchs angeben. Dieser Header wird nicht angezeigt, wenn eine Kopie aussteht, wenn dieses Blob nie das Ziel in einem Kopier-Blob-Vorgang war oder wenn dieser Blob nach einem abgeschlossenen Kopier-Blob-Vorgang mit Set Blob-Eigenschaften, Put Blob oder Put Block List geändert wurde.
copyId	Zeichenfolgenbezeichner für diesen Kopiervorgang. Mit "Blobeigenschaften abrufen" können Sie den Status dieses Kopiervorgangs überprüfen oder an "Blob abbrechen" übergeben, um eine ausstehende Kopie abzubrechen.
copyProgress	Enthält die Anzahl der kopierten Bytes und die Gesamtbytes in der Quelle im letzten versuchten Copy Blob-Vorgang, bei dem es sich bei diesem Blob um das Zielblob handelt. Kann zwischen 0 und kopierten Bytes der Inhaltslänge angezeigt werden. Dieser Header wird nicht angezeigt, wenn dieses Blob nie das Ziel in einem Kopier-Blob-Vorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopier-Blob-Vorgang mit Set Blob-Eigenschaften, Put Blob oder Put Block List geändert wurde.
copySource	URL mit einer Länge von bis zu 2 KB, die das Quell-BLOB oder die Datei angibt, die im letzten versuchten Kopier-Blob-Vorgang verwendet wird, bei dem es sich bei diesem Blob um das Zielblob handelt. Dieser Header wird nicht angezeigt, wenn dieses Blob nie das Ziel in einem Kopier-Blob-Vorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopier-Blob-Vorgang mit Set Blob-Eigenschaften, Put Blob oder Put Block List geändert wurde.
copyStatus	Der Zustand des kopiervorgangs, der durch x-ms-copy-id identifiziert wird.
copyStatusDescription	Wird nur angezeigt, wenn der x-ms-copy-status fehlgeschlagen oder aussteht. Beschreibt die Ursache des letzten schwerwiegenden oder nicht schwerwiegenden Kopiervorgangsfehlers. Dieser Header wird nicht angezeigt, wenn dieses Blob nie das Ziel in einem Kopier-Blob-Vorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopier-Blob-Vorgang mit Set Blob-Eigenschaften, Put Blob oder Put Block List geändert wurde.
date	UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, 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 der Blobinhalte und 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 zum bedingten Ausführen von Vorgängen verwenden können. Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen angegeben.
immutabilityPolicyExpiresOn	UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Zeit angibt, zu der die Blob-Unveränderbarkeitsrichtlinie abläuft.
immutabilityPolicyMode	Gibt den Unveränderlichkeitsrichtlinienmodus an.
isCurrentVersion	Der Wert dieses Headers gibt an, ob die Version dieses BLOB eine aktuelle Version ist, siehe auch x-ms-version-id-Header.
isSealed	Wenn dieses Blob versiegelt wurde
isServerEncrypted	Der Wert dieses Headers wird auf "true" festgelegt, wenn die BLOB-Daten 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 nur Teile der Blob-/Anwendungsmetadaten verschlüsselt sind).
lastAccessed	UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Uhrzeit angibt, zu der das Blob zuletzt gelesen oder in
lastModified	Gibt das Datum und die Uhrzeit der letzten Änderung des Containers zurück. Jeder Vorgang, der das Blob ändert, einschließlich einer Aktualisierung der Metadaten oder Eigenschaften des Blobs, ändert die Uhrzeit der letzten Änderung des Blobs.
leaseDuration	Wenn ein Blob geleast wird, gibt sie an, ob die Lease unendlich oder fester Dauer ist.
leaseState	Leasestatus des Blobs.
leaseStatus	Der aktuelle Leasestatus des Blobs.
legalHold	Gibt an, ob eine gesetzliche Aufbewahrungspflicht für das Blob vorhanden ist.
metadata
objectReplicationPolicyId	Wahlfrei. Nur gültig, wenn die Objektreplikation für den Speichercontainer und im Ziel-BLOB der Replikation aktiviert ist.
objectReplicationRules	Wahlfrei. Nur gültig, wenn die Objektreplikation für den Speichercontainer und im Quell-BLOB der Replikation aktiviert ist. Beim Abrufen dieses Headers gibt er den Header mit der Richtlinien-ID und Regel-ID (z. B. x-ms-or-policyid_ruleid) zurück, und der Wert ist der Status der Replikation (z. B. abgeschlossen, fehlgeschlagen).
requestId	Dieser Header identifiziert die anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden.
tagCount	Die Anzahl der Tags, die dem Blob zugeordnet sind
version	Gibt die Version des Blob-Diensts an, der zum Ausführen der Anforderung verwendet wird. Dieser Header wird für Anforderungen zurückgegeben, die mit Version 2009-09-19 und höher vorgenommen wurden.
versionId	Ein DateTime-Wert, der vom Dienst zurückgegeben wird, der das Blob eindeutig identifiziert. Der Wert dieses Headers gibt die BLOB-Version an und kann in nachfolgenden Anforderungen verwendet werden, um auf diese Version des BLOB zuzugreifen.

Details zur Eigenschaft

acceptRanges

Gibt an, dass der Dienst Anforderungen für partielle BLOB-Inhalte unterstützt.

acceptRanges?: string

Eigenschaftswert

string

blobCommittedBlockCount

Die Anzahl der zugesicherten 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 einen MD5-Hash aufweist und die Anforderung Bereichsheader (Range oder x-ms-range) enthält, wird dieser Antwortheader mit dem Wert des MD5-Werts des gesamten BLOB zurückgegeben. Dieser Wert kann dem wert entsprechen, der im Content-MD5-Header zurückgegeben wird, wobei letztere aus dem angeforderten Bereich berechnet wird.

blobContentMD5?: Uint8Array

Eigenschaftswert

Uint8Array

blobSequenceNumber

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

blobSequenceNumber?: number

Eigenschaftswert

number

blobType

Der Blobtyp.

blobType?: BlobType

Eigenschaftswert

BlobType

cacheControl

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

cacheControl?: string

Eigenschaftswert

string

clientRequestId

Wenn ein Clientanforderungs-ID-Header in der Anforderung 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 der x-ms-range-get-content-crc64 auf "true" festgelegt ist, gibt die Anforderung einen crc64 für den Bereich zurück, solange die Bereichsgröße kleiner oder gleich 4 MB ist. Wenn sowohl x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 in derselben Anforderung angegeben ist, tritt ein Fehler mit 400(Bad Request) auf.

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 Antwortheaderfeld "Content-Disposition" vermittelt zusätzliche Informationen zum Verarbeiten der Antwortnutzlast und kann auch zum Anfügen zusätzlicher Metadaten verwendet werden. Wenn sie beispielsweise auf "Anlage" festgelegt ist, wird angegeben, dass der Benutzer-Agent die Antwort nicht anzeigen soll, sondern stattdessen ein Dialogfeld "Speichern unter" mit einem anderen Dateinamen als dem angegebenen BLOB-Namen anzeigen soll.

contentDisposition?: string

Eigenschaftswert

string

contentEncoding

Dieser Header gibt den Wert zurück, der für den Inhaltscodierungsanforderungsheader angegeben wurde.

contentEncoding?: string

Eigenschaftswert

string

contentLanguage

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

contentLanguage?: string

Eigenschaftswert

string

contentLength

Die Anzahl der Bytes, die im Antworttext vorhanden sind.

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 auf die Nachrichteninhaltsintegrität überprüfen kann.

contentMD5?: Uint8Array

Eigenschaftswert

Uint8Array

contentRange

Gibt den Vom Client zurückgegebenen Bytebereich an, der eine Teilmenge des BLOB angefordert hat, indem der Anforderungsheader "Range" 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

copyCompletedOn

Abschlusszeit des letzten versuchten Kopier-Blob-Vorgangs, bei dem es sich bei diesem Blob um das Zielblob handelte. Dieser Wert kann den Zeitpunkt eines abgeschlossenen, abgebrochenen oder fehlgeschlagenen Kopierversuchs angeben. Dieser Header wird nicht angezeigt, wenn eine Kopie aussteht, wenn dieses Blob nie das Ziel in einem Kopier-Blob-Vorgang war oder wenn dieser Blob nach einem abgeschlossenen Kopier-Blob-Vorgang mit Set Blob-Eigenschaften, Put Blob oder Put Block List geändert wurde.

copyCompletedOn?: Date

Eigenschaftswert

Date

copyId

Zeichenfolgenbezeichner für diesen Kopiervorgang. Mit "Blobeigenschaften abrufen" können Sie den Status dieses Kopiervorgangs überprüfen oder an "Blob abbrechen" übergeben, um eine ausstehende Kopie abzubrechen.

copyId?: string

Eigenschaftswert

string

copyProgress

Enthält die Anzahl der kopierten Bytes und die Gesamtbytes in der Quelle im letzten versuchten Copy Blob-Vorgang, bei dem es sich bei diesem Blob um das Zielblob handelt. Kann zwischen 0 und kopierten Bytes der Inhaltslänge angezeigt werden. Dieser Header wird nicht angezeigt, wenn dieses Blob nie das Ziel in einem Kopier-Blob-Vorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopier-Blob-Vorgang mit Set Blob-Eigenschaften, 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 Quell-BLOB oder die Datei angibt, die im letzten versuchten Kopier-Blob-Vorgang verwendet wird, bei dem es sich bei diesem Blob um das Zielblob handelt. Dieser Header wird nicht angezeigt, wenn dieses Blob nie das Ziel in einem Kopier-Blob-Vorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopier-Blob-Vorgang mit Set Blob-Eigenschaften, Put Blob oder Put Block List geändert wurde.

copySource?: string

Eigenschaftswert

string

copyStatus

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

copyStatus?: CopyStatusType

Eigenschaftswert

CopyStatusType

copyStatusDescription

Wird nur angezeigt, wenn der x-ms-copy-status fehlgeschlagen oder aussteht. Beschreibt die Ursache des letzten schwerwiegenden oder nicht schwerwiegenden Kopiervorgangsfehlers. Dieser Header wird nicht angezeigt, wenn dieses Blob nie das Ziel in einem Kopier-Blob-Vorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopier-Blob-Vorgang mit Set Blob-Eigenschaften, Put Blob oder Put Block List geändert wurde.

copyStatusDescription?: string

Eigenschaftswert

string

date

UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, 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 der Blobinhalte und 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 zum bedingten Ausführen von Vorgängen verwenden können. Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen angegeben.

etag?: string

Eigenschaftswert

string

immutabilityPolicyExpiresOn

UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Zeit angibt, zu der die Blob-Unveränderbarkeitsrichtlinie abläuft.

immutabilityPolicyExpiresOn?: Date

Eigenschaftswert

Date

immutabilityPolicyMode

Gibt den Unveränderlichkeitsrichtlinienmodus an.

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Eigenschaftswert

BlobImmutabilityPolicyMode

isCurrentVersion

Der Wert dieses Headers gibt an, ob die Version dieses BLOB eine aktuelle Version ist, siehe auch x-ms-version-id-Header.

isCurrentVersion?: boolean

Eigenschaftswert

boolean

isSealed

Wenn dieses Blob versiegelt wurde

isSealed?: boolean

Eigenschaftswert

boolean

isServerEncrypted

Der Wert dieses Headers wird auf "true" festgelegt, wenn die BLOB-Daten 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 nur Teile der Blob-/Anwendungsmetadaten verschlüsselt sind).

isServerEncrypted?: boolean

Eigenschaftswert

boolean

lastAccessed

UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Uhrzeit angibt, zu der das Blob zuletzt gelesen oder in

lastAccessed?: Date

Eigenschaftswert

Date

lastModified

Gibt das Datum und die Uhrzeit der letzten Änderung des Containers zurück. Jeder Vorgang, der das Blob ändert, einschließlich einer Aktualisierung der Metadaten oder Eigenschaften des Blobs, ändert die Uhrzeit der letzten Änderung des Blobs.

lastModified?: Date

Eigenschaftswert

Date

leaseDuration

Wenn ein Blob geleast wird, gibt sie an, ob die Lease unendlich oder fester Dauer ist.

leaseDuration?: LeaseDurationType

Eigenschaftswert

LeaseDurationType

leaseState

Leasestatus des Blobs.

leaseState?: LeaseStateType

Eigenschaftswert

LeaseStateType

leaseStatus

Der aktuelle Leasestatus des Blobs.

leaseStatus?: LeaseStatusType

Eigenschaftswert

LeaseStatusType

legalHold

Gibt an, ob eine gesetzliche Aufbewahrungspflicht für das Blob vorhanden ist.

legalHold?: boolean

Eigenschaftswert

boolean

metadata

metadata?: [key: string]: string

Eigenschaftswert

[key: string]: string

objectReplicationPolicyId

Wahlfrei. Nur gültig, wenn die Objektreplikation für den Speichercontainer und im Ziel-BLOB der Replikation aktiviert ist.

objectReplicationPolicyId?: string

Eigenschaftswert

string

objectReplicationRules

Wahlfrei. Nur gültig, wenn die Objektreplikation für den Speichercontainer und im Quell-BLOB der Replikation aktiviert ist. Beim Abrufen dieses Headers gibt er den Header mit der Richtlinien-ID und Regel-ID (z. B. x-ms-or-policyid_ruleid) zurück, und der Wert ist der Status der Replikation (z. B. abgeschlossen, fehlgeschlagen).

objectReplicationRules?: [key: string]: string

Eigenschaftswert

[key: string]: string

requestId

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

requestId?: string

Eigenschaftswert

string

tagCount

Die Anzahl der Tags, die dem Blob zugeordnet sind

tagCount?: number

Eigenschaftswert

number

version

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

version?: string

Eigenschaftswert

string

versionId

Ein DateTime-Wert, der vom Dienst zurückgegeben wird, der das Blob eindeutig identifiziert. Der Wert dieses Headers gibt die BLOB-Version an und kann in nachfolgenden Anforderungen verwendet werden, um auf diese Version des BLOB zuzugreifen.

versionId?: string

Eigenschaftswert

string