Share via


BlobGetPropertiesHeaders interface

Definiert Header für Blob_getProperties Vorgang.

Eigenschaften

acceptRanges

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

accessTier

Die Ebene des Seitenblobs in einem Storage Premium-Konto oder einer Blockblobebene für Blob Storage-LRS-Konten. Eine Liste der zulässigen Premium-Seitenblobebenen finden Sie unter https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Für Blob Storage-LRS-Konten sind hot/Cool/Archive gültige Werte.

accessTierChangedOn

Die Zeit, zu der die Ebene für das Objekt geändert wurde. Dies wird nur zurückgegeben, wenn die Ebene für das Blockblob jemals festgelegt wurde.

accessTierInferred

Nur für Seitenblobs in einem Storage Premium-Konto. Wenn die Zugriffsebene nicht explizit für das Blob festgelegt ist, wird die Ebene basierend auf ihrer Inhaltslänge abgeleitet, und dieser Header wird mit dem Wert true zurückgegeben.

archiveStatus

Für Blob Storage-LRS-Konten sind rehydrate-pending-to-hot/rehydrate-pending-to-cool gültige Werte. Wenn das Blob rehydriert wird und nicht vollständig ist, wird dieser Header zurückgegeben, der angibt, dass die Aktivierung aussteht, und teilt auch der Zielebene mit.

blobCommittedBlockCount

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

blobSequenceNumber

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

blobType

Der Typ des Blobs.

cacheControl

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

clientRequestId

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

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.

contentEncoding

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

contentLanguage

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

contentLength

Die Größe des Blobs in Byte. Für ein Seitenblob gibt dieser Header den Wert des x-ms-blob-content-length-Headers zurück, der mit dem Blob gespeichert wird.

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.

contentType

Der für das Blob angegebene Inhaltstyp. Der Standardinhaltstyp ist "application/octet-stream"

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.

copyId

Zeichenfolgenbezeichner für diesen Kopiervorgang. Verwenden Sie mit Get Blob Properties (Blobeigenschaften abrufen), um den Status dieses Kopiervorgangs zu überprüfen, oder übergeben Sie an Abort Copy Blob , um eine ausstehende Kopie abzubrechen.

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.

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 Vorgang zum Kopieren von Blobs mithilfe von Set Blob Properties, Put Blob oder Put Block List geändert wurde.

copyStatus

Status 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 Kopiervorgang mit Blobeigenschaften festlegen, Blob put blob oder Put Block List geändert wurde.

createdOn

Gibt das Datum und die Uhrzeit der Bloberstellung zurück.

date

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

destinationSnapshot

Wird eingeschlossen, wenn es sich bei dem Blob um eine Momentaufnahme für inkrementelles Kopieren oder eine Momentaufnahme für inkrementelles Kopieren handelt, wenn x-ms-copy-status erfolgreich ist. Momentaufnahmezeit der letzten erfolgreichen inkrementellen Kopiermomentaufnahme für dieses Blob.

encryptionKeySha256

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

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

expiresOn

Der Zeitpunkt, zu dem dieses Blob abläuft.

immutabilityPolicyExpiresOn

Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem die Unveränderlichkeitsrichtlinie für Blobs abläuft.

immutabilityPolicyMode

Gibt den Unveränderlichkeitsrichtlinienmodus an.

isCurrentVersion

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

isIncrementalCopy

Wird eingeschlossen, wenn es sich bei dem Blob um ein inkrementelles Kopierblob handelt.

isSealed

Wenn dieses Blob versiegelt wurde

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

lastAccessed

Vom Dienst generierter UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem das Blob zuletzt gelesen oder in geschrieben wurde.

lastModified

Gibt das Datum und die Uhrzeit der letzten Änderung des Blobs 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.

legalHold

Gibt an, ob ein rechtlicher Aufbewahrungsspeicher für das Blob vorhanden ist.

metadata
objectReplicationPolicyId

Dies ist optional. Nur gültig, wenn die Objektreplikation für den Speichercontainer und für das Zielblob der Replikation aktiviert ist.

objectReplicationRules

Dies ist 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, Fehler).

rehydratePriority

Wenn sich ein Objekt im Ausstehendzustand befindet, wird dieser Header mit der Priorität rehydrieren zurückgegeben.

requestId

Dieser Header identifiziert die erfolgte 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 Abfrage verwendet wird. Dieser Header wird für Anforderungen zurückgegeben, die für Version 2009-09-19 und höher erfolgen.

versionId

Ein DateTime-Wert, der vom Dienst zurückgegeben wird, 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

accessTier

Die Ebene des Seitenblobs in einem Storage Premium-Konto oder einer Blockblobebene für Blob Storage-LRS-Konten. Eine Liste der zulässigen Premium-Seitenblobebenen finden Sie unter https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Für Blob Storage-LRS-Konten sind hot/Cool/Archive gültige Werte.

accessTier?: string

Eigenschaftswert

string

accessTierChangedOn

Die Zeit, zu der die Ebene für das Objekt geändert wurde. Dies wird nur zurückgegeben, wenn die Ebene für das Blockblob jemals festgelegt wurde.

accessTierChangedOn?: Date

Eigenschaftswert

Date

accessTierInferred

Nur für Seitenblobs in einem Storage Premium-Konto. Wenn die Zugriffsebene nicht explizit für das Blob festgelegt ist, wird die Ebene basierend auf ihrer Inhaltslänge abgeleitet, und dieser Header wird mit dem Wert true zurückgegeben.

accessTierInferred?: boolean

Eigenschaftswert

boolean

archiveStatus

Für Blob Storage-LRS-Konten sind rehydrate-pending-to-hot/rehydrate-pending-to-cool gültige Werte. Wenn das Blob rehydriert wird und nicht vollständig ist, wird dieser Header zurückgegeben, der angibt, dass die Aktivierung aussteht, und teilt auch der Zielebene mit.

archiveStatus?: string

Eigenschaftswert

string

blobCommittedBlockCount

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

blobCommittedBlockCount?: number

Eigenschaftswert

number

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

Der Typ des Blobs.

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 Clientanforderungs-ID-Header gesendet wird, wird dieser Header in der Antwort mit dem gleichen Wert vorhanden.

clientRequestId?: string

Eigenschaftswert

string

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 Größe des Blobs in Byte. Für ein Seitenblob gibt dieser Header den Wert des x-ms-blob-content-length-Headers zurück, der mit dem Blob gespeichert wird.

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

contentType

Der für das Blob angegebene Inhaltstyp. Der Standardinhaltstyp ist "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 den Status dieses Kopiervorgangs zu überprüfen, oder übergeben Sie an Abort Copy Blob , 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 Vorgang zum Kopieren von Blobs mithilfe von Set Blob Properties, 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

createdOn

Gibt das Datum und die Uhrzeit der Bloberstellung zurück.

createdOn?: Date

Eigenschaftswert

Date

date

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

date?: Date

Eigenschaftswert

Date

destinationSnapshot

Wird eingeschlossen, wenn es sich bei dem Blob um eine Momentaufnahme für inkrementelles Kopieren oder eine Momentaufnahme für inkrementelles Kopieren handelt, wenn x-ms-copy-status erfolgreich ist. Momentaufnahmezeit der letzten erfolgreichen inkrementellen Kopiermomentaufnahme für dieses Blob.

destinationSnapshot?: string

Eigenschaftswert

string

encryptionKeySha256

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

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

expiresOn

Der Zeitpunkt, zu dem dieses Blob abläuft.

expiresOn?: Date

Eigenschaftswert

Date

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

isIncrementalCopy

Wird eingeschlossen, wenn es sich bei dem Blob um ein inkrementelles Kopierblob handelt.

isIncrementalCopy?: 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 Blobs 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

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

Dies ist 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

Dies ist 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, Fehler).

objectReplicationRules?: [key: string]: string

Eigenschaftswert

[key: string]: string

rehydratePriority

Wenn sich ein Objekt im Ausstehendzustand befindet, wird dieser Header mit der Priorität rehydrieren zurückgegeben.

rehydratePriority?: RehydratePriority

Eigenschaftswert

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 DateTime-Wert, der vom Dienst zurückgegeben wird, 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