BlobDownloadHeaders interface
Definiert Header für Blob_download Vorgang.
Eigenschaften
accept |
Gibt an, dass der Dienst Anforderungen für teilweisen BLOB-Inhalt unterstützt. |
blob |
Die Anzahl der committeten Blöcke, die im Blob vorhanden sind. Dieser Header wird nur für Anfügeblobs zurückgegeben. |
blob |
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 im Content-MD5-Header zurückgegebenen Wert sein, wobei letzteres aus dem angeforderten Bereich berechnet wird. |
blob |
Die aktuelle Sequenznummer für ein Seitenblob. Dieser Header wird für Blockblobs oder Anfügeblobs nicht zurückgegeben. |
blob |
Der Typ des Blobs. |
cache |
Dieser Header wird zurückgegeben, wenn er zuvor für das BLOB angegeben wurde. |
client |
Wenn in der Anforderung ein Clientanforderungs-ID-Header gesendet wird, wird dieser Header in der Antwort mit demselben Wert vorhanden sein. |
content |
Wenn die Anforderung einen angegebenen Bereich lesen soll und x-ms-range-get-content-crc64 auf TRUE festgelegt ist, gibt die Anforderung einen crc64 für den Bereich zurück, sofern die Bereichsgröße kleiner oder gleich 4 MB ist. Wenn in derselben Anforderung sowohl x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 angegeben ist, schlägt dies mit 400(Bad Request) fehl. |
content |
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 User-Agent die Antwort nicht anzeigen, sondern stattdessen ein Dialogfeld Speichern unter mit einem anderen Dateinamen als dem angegebenen Blobnamen anzeigen soll. |
content |
Dieser Header gibt den Wert zurück, der für den Content-Encoding-Anforderungsheader angegeben wurde. |
content |
Dieser Header gibt den Wert zurück, der für den Content-Language-Anforderungsheader angegeben wurde. |
content |
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. |
content |
Gibt den Bytesbereich an, der zurückgegeben wird, wenn der Client eine Teilmenge des Blobs angefordert hat, indem der Anforderungsheader "Range" festgelegt wird. |
content |
Der Medientyp des Antworttexts. Für "Blob herunterladen" lautet dies "application/octet-stream" |
copy |
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 nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde. |
copy |
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 Blobkopiervorgangs, um eine ausstehende Kopie abzubrechen. |
copy |
Enthält die Anzahl der kopierten Bytes und die Gesamtbytes in der Quelle im letzten versuchten Kopierblobvorgang, wobei dieses Blob das Zielblob war. Kann zwischen 0 und kopierten Bytes der 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 Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde. |
copy |
EINE URL mit einer Länge von bis zu 2 KB, die das Quellblob oder die Datei angibt, das bzw. die beim letzten Versuchten zum Kopieren von Blobs verwendet wurde, wobei dieses Blob das Zielblob war. Dieser Header wird nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde. |
copy |
Status des Kopiervorgangs, der durch x-ms-copy-id identifiziert wird. |
copy |
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 Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde. |
date | Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem die Antwort initiiert wurde |
encryption |
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. |
encryption |
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. |
error |
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. |
immutability |
Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem die Unveränderlichkeitsrichtlinie für Blobs abläuft. |
immutability |
Gibt den Unveränderlichkeitsrichtlinienmodus an. |
is |
Der Wert dieses Headers gibt an, ob die Version dieses Blobs eine aktuelle Version ist. Siehe auch x-ms-version-id-Header. |
is |
Wenn dieses Blob versiegelt wurde |
is |
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 nur Teile der Blob-/Anwendungsmetadaten verschlüsselt sind). |
last |
Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem das Blob zuletzt gelesen oder in geschrieben wurde. |
last |
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. |
lease |
Gibt für ein geleastes BLOB an, ob die Lease von unbegrenzter oder fester Dauer ist. |
lease |
Der Leasestatus des BLOB. |
lease |
Der aktuelle Leasestatus des BLOB. |
legal |
Gibt an, ob ein rechtlicher Aufbewahrungsspeicher für das Blob vorhanden ist. |
metadata | |
object |
Optional. Nur gültig, wenn die Objektreplikation für den Speichercontainer und für das Zielblob der Replikation aktiviert ist. |
object |
Optional. Nur gültig, wenn die Objektreplikation für den Speichercontainer und für das Quellblob der Replikation aktiviert ist. Beim Abrufen dieses Headers wird der Header mit der Richtlinien-ID und der Regel-ID (z. B. x-ms-or-policyid_ruleid) zurückgegeben, und der Wert ist der status der Replikation (z. B. abgeschlossen, fehlgeschlagen). |
request |
Dieser Header identifiziert die erfolgte Anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden. |
tag |
Die Anzahl der Tags, die dem Blob zugeordnet sind |
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 |
Ein vom Dienst zurückgegebener DateTime-Wert, der das Blob eindeutig identifiziert. Der Wert dieses Headers gibt die Blobversion an und kann in nachfolgenden Anforderungen verwendet werden, um auf diese Version des Blobs zuzugreifen. |
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 im Content-MD5-Header zurückgegebenen Wert sein, wobei letzteres aus dem angeforderten Bereich berechnet wird.
blobContentMD5?: Uint8Array
Eigenschaftswert
Uint8Array
blobSequenceNumber
Die aktuelle Sequenznummer für ein Seitenblob. Dieser Header wird für Blockblobs oder Anfügeblobs nicht zurückgegeben.
blobSequenceNumber?: number
Eigenschaftswert
number
blobType
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 Clientanforderungs-ID-Header gesendet wird, wird dieser Header in der Antwort mit demselben Wert vorhanden sein.
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 für den Bereich zurück, sofern die Bereichsgröße kleiner oder gleich 4 MB ist. Wenn in derselben Anforderung sowohl x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 angegeben ist, 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 User-Agent die Antwort nicht anzeigen, 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 Content-Encoding-Anforderungsheader 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 Bytesbereich an, der zurückgegeben wird, wenn der Client eine Teilmenge des Blobs angefordert hat, indem der Anforderungsheader "Range" festgelegt wird.
contentRange?: string
Eigenschaftswert
string
contentType
Der Medientyp des Antworttexts. Für "Blob herunterladen" lautet dies "application/octet-stream"
contentType?: string
Eigenschaftswert
string
copyCompletedOn
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 nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde.
copyCompletedOn?: 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 Blobkopiervorgangs, 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 Kopierblobvorgang, wobei dieses Blob das Zielblob war. Kann zwischen 0 und kopierten Bytes der 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 Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde.
copyProgress?: string
Eigenschaftswert
string
copySource
EINE URL mit einer Länge von bis zu 2 KB, die das Quellblob oder die Datei angibt, das bzw. die beim letzten Versuchten zum Kopieren von Blobs verwendet wurde, wobei dieses Blob das Zielblob war. Dieser Header wird nicht angezeigt, wenn dieses Blob noch nie das Ziel in einem Kopierblobvorgang war oder wenn dieses Blob nach einem abgeschlossenen Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde.
copySource?: string
Eigenschaftswert
string
copyStatus
Status 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 Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde.
copyStatusDescription?: string
Eigenschaftswert
string
date
Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem 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 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
immutabilityPolicyExpiresOn
Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem die Unveränderlichkeitsrichtlinie für Blobs abläuft.
immutabilityPolicyExpiresOn?: Date
Eigenschaftswert
Date
immutabilityPolicyMode
Gibt den Unveränderlichkeitsrichtlinienmodus an.
immutabilityPolicyMode?: BlobImmutabilityPolicyMode
Eigenschaftswert
isCurrentVersion
Der Wert dieses Headers gibt an, ob die Version dieses Blobs 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 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 nur Teile der Blob-/Anwendungsmetadaten verschlüsselt sind).
isServerEncrypted?: boolean
Eigenschaftswert
boolean
lastAccessed
Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem das Blob zuletzt gelesen oder in geschrieben wurde.
lastAccessed?: Date
Eigenschaftswert
Date
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
leaseStatus
legalHold
Gibt an, ob ein rechtlicher Aufbewahrungsspeicher für das Blob vorhanden ist.
legalHold?: boolean
Eigenschaftswert
boolean
metadata
metadata?: [key: string]: string
Eigenschaftswert
[key: string]: string
objectReplicationPolicyId
Optional. Nur gültig, wenn die Objektreplikation für den Speichercontainer und für das Zielblob der Replikation aktiviert ist.
objectReplicationPolicyId?: string
Eigenschaftswert
string
objectReplicationRules
Optional. Nur gültig, wenn die Objektreplikation für den Speichercontainer und für das Quellblob der Replikation aktiviert ist. Beim Abrufen dieses Headers wird der Header mit der Richtlinien-ID und der Regel-ID (z. B. x-ms-or-policyid_ruleid) zurückgegeben, 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 erfolgte 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 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
versionId
Ein vom Dienst zurückgegebener DateTime-Wert, der das Blob eindeutig identifiziert. Der Wert dieses Headers gibt die Blobversion an und kann in nachfolgenden Anforderungen verwendet werden, um auf diese Version des Blobs zuzugreifen.
versionId?: string
Eigenschaftswert
string
Azure SDK for JavaScript