Get Blob

Der Get Blob-Vorgang liest oder lädt ein BLOB vom System herunter, einschließlich der zugehörigen Metadaten und Eigenschaften. Sie können auch Get Blob aufrufen, um eine Momentaufnahme zu lesen.

Anforderung

Die Get Blob-Anforderung kann wie folgt erstellt werden. HTTPS wird empfohlen. Ersetzen Sie mein Konto durch den Namen Ihres Speicherkontos :

Anforderungs-URI für GET-Methode HTTP-Version
https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime>

HTTP/1.0

HTTP/1.1

Emulierter Speicherdienst-URI

Wenn Sie eine Anforderung für den emulierten Speicherdienst ausführen, geben Sie den Emulatorhostnamen und den Port des Blob-Diensts mit 127.0.0.1:10000 an, gefolgt vom Namen des emulierten Speicherkontos:

Anforderungs-URI für GET-Methode HTTP-Version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

Weitere Informationen finden Sie unter Verwenden des Azure Storage-Emulators für Entwicklung und Tests.

URI-Parameter

Im Anforderungs-URI können die folgenden zusätzlichen Parameter angegeben werden.

Parameter BESCHREIBUNG
snapshot Optional. Der Momentaufnahmeparameter ist ein nicht transparenter DateTime-Wert, der ggf. die abzurufende BLOB-Momentaufnahme angibt. Weitere Informationen zum Arbeiten mit Blob-Momentaufnahmen finden Sie unter Erstellen einer Momentaufnahme eines Blobs.
versionid Optional, Version 2019-12-12 und neuer. Der Versionid-Parameter ist ein undurchsichtiger DateTime Wert, der, wenn vorhanden, die Version des blobs angibt, das abgerufen werden soll.
timeout Optional. Der timeout-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Blob-Dienstvorgänge.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader BESCHREIBUNG
Authorization Erforderlich. Gibt das Autorisierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
Date oder x-ms-date Erforderlich. Gibt die koordinierte Weltzeit (Coordinated Universal Time, UTC) für die Anforderung an. Weitere Informationen finden Sie unter Autorisieren von Anforderungen an Azure Storage.
x-ms-version Erforderlich für alle autorisierten Anforderungen, optional für anonyme Anforderungen. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Wenn diese Kopfzeile für eine anonyme Anforderung ausgelassen wird, führt der Dienst die Anforderung mit Version 2009-09-19 aus. Weitere Informationen finden Sie unter Versioning für azure Storage Services.
Range Optional. Gibt nur die Bytes des BLOB im angegebenen Bereich zurück.
x-ms-range Optional. Gibt nur die Bytes des BLOB im angegebenen Bereich zurück. Wenn Range und x-ms-range angegeben werden, verwendet der Dienst den Wert x-ms-range. Wenn keine Angabe gemacht wird, wird der gesamte BLOB-Inhalt zurückgegeben. Weitere Informationen finden Sie unter Angeben des Bereichsheaders für Blob-Dienstvorgänge .
x-ms-lease-id: <ID> Optional. Bei Angabe dieses Headers wird der Vorgang nur ausgeführt, wenn die beiden folgenden Bedingungen erfüllt sind:

- Die Blob-Lease ist derzeit aktiv.
- Die in der Anforderung angegebene Lease-ID entspricht dem des Blobs.

Wenn der Header angegeben ist und beide Bedingungen nicht erfüllt sind, schlägt die Anforderung fehl, und der Get Blob-Vorgang schlägt mit dem Statuscode 412 (Vorbedingung nicht erfüllt) fehl.
x-ms-range-get-content-md5: true Optional. Wenn dieser Header zusammen mit dem Header festgelegt true und angegeben wird, gibt der Dienst den MD5-Hash für den Range Bereich zurück, solange der Bereich kleiner oder gleich 4 MiB ist.

Wenn der Header ohne den Range-Header angegeben wird, gibt der Dienst Statuscode 400 zurück (Ungültige Anforderung).

Wenn dieser Header festgelegt true ist, wenn der Bereich 4 MiB in Größe überschreitet, gibt der Dienst Statuscode 400 (Bad Request) zurück.
x-ms-range-get-content-crc64: true Optional. Wenn dieser Header zusammen mit dem Header festgelegt true und angegeben wird, gibt der Dienst den CRC64-Hash für den Range Bereich zurück, solange der Bereich kleiner oder gleich 4 MiB ist.

Wenn der Header ohne den Range-Header angegeben wird, gibt der Dienst Statuscode 400 zurück (Ungültige Anforderung).

Wenn dieser Header festgelegt true ist, wenn der Bereich 4 MiB in Größe überschreitet, gibt der Dienst Statuscode 400 (Bad Request) zurück.

Wenn sowohl x-ms-range-get-content-md5x-ms-range-get-content-crc64 Header als auch Kopfzeilen vorhanden sind, schlägt die Anforderung mit einer 400 (Bad Request) fehl.

Dieser Header wird in Versionen 2019-02-02 oder höher unterstützt.
Origin Optional. Gibt die Ursprungsdomäne an, von der die Anforderung ausgegeben wird. Wenn dieser Header vorhanden ist, werden CORS (Cross-Origin Resource Sharing)-Header für die Antwort erzeugt.
x-ms-client-request-id Optional. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1 KiB-Zeichenlimit bereit, das in den Analyseprotokollen aufgezeichnet wird, wenn die Speicheranalyseprotokollierung aktiviert ist. Es wird empfohlen, diesen Header für das Korrelieren clientseitiger Aktivitäten mit vom Server empfangenen Anforderungen zu verwenden. Weitere Informationen finden Sie unter Storage Analytics Protokollierung und Azure-Protokollierung: Verwenden von Protokollen zum Nachverfolgen von Speicheranforderungen.

Dieser Vorgang unterstützt zudem die Verwendung von bedingten Headern zum Lesen des BLOB. Hierfür muss jedoch eine angegebene Bedingung erfüllt sein. Weitere Informationen finden Sie unter Specifying Conditional Headers for Blob Service Operations (Angeben von bedingten Headern für Vorgänge des Blob-Diensts).

Anforderungsheader (vom Kunden bereitgestellte Verschlüsselungsschlüssel)

Ab Version 2019-02-02 können die folgenden Kopfzeilen auf der Anforderung angegeben werden, einen Blob mit einem vom Kunden bereitgestellten Schlüssel zu lesen. Die Verschlüsselung mit einem vom Kunden bereitgestellten Schlüssel (und der entsprechende Satz von Headern) ist optional. Wenn ein Blob zuvor mit einem vom Kunden bereitgestellten Schlüssel verschlüsselt wurde, muss diese Kopfzeilen auf der Anforderung enthalten sein, den Lesevorgang erfolgreich abzuschließen.

Anforderungsheader BESCHREIBUNG
x-ms-encryption-key Erforderlich. Der AES-256-Verschlüsselungsschlüssel "Base64".
x-ms-encryption-key-sha256 Optional. Der base64-codierte SHA256-Hash des Verschlüsselungsschlüssels.
x-ms-encryption-algorithm: AES256 Erforderlich. Gibt den Algorithmus an, der für die Verschlüsselung verwendet werden soll. Der Wert dieses Headers muss auf AES256 festgelegt sein.

Anforderungstext

Keine.

Antwort

Die Antwort enthält einen HTTP-Statuscode, eine Gruppe von Antwortheadern und den Antworttext, der den Inhalt des BLOB enthält.

Statuscode

Wenn der BLOB vollständig gelesen wird, wird der Statuscode 200 (OK) zurückgegeben.

Wenn ein bestimmter Bereich erfolgreich gelesen wird, wird der Statuscode 206 (Teilweiser Inhalt) zurückgegeben.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann außerdem weitere HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Syntax BESCHREIBUNG
Last-Modified Datum/Uhrzeit der letzten Änderung des BLOB. Das Datumsformat entspricht RFC 1123.

Durch jeden Vorgang, der das BLOB ändert, einschließlich eines Updates der Metadaten oder Eigenschaften des BLOB, wird die Uhrzeit der letzten Änderung aktualisiert.
x-ms-creation-time Version 2017-11-09 und neuer. Das Datum/die Uhrzeit, zu dem das Blob erstellt wurde. Das Datumsformat entspricht RFC 1123.
x-ms-meta-name:value Ein Satz von Name-Wert-Paaren, die diesem BLOB als benutzerdefinierte Metadaten zugeordnet sind.
x-ms-tag-count Version 2019-12-12 oder höher. Wenn der Blob tags enthält, gibt die Anzahl der Tags zurück, die im Blob gespeichert sind. Dieser Header wird nicht zurückgegeben, wenn keine Tags im Blob vorhanden sind.
Content-Length Die Anzahl der im Antworttext vorhandenen Bytes.
Content-Type Der für das Blob angegebene Inhaltstyp. Der Standardinhaltstyp ist application/octet-stream.
Content-Range Gibt den Bytebereich an, der zurückgegeben wird, wenn der Client durch Festlegen des Range-Anforderungsheaders eine Teilmenge des BLOB angefordert hat.
ETag Das ETag enthält einen Wert, den Sie verwenden können, um Vorgänge bedingt auszuführen. Weitere Informationen finden Sie unter Angeben von bedingten Headern für Blob-Dienstvorgänge . Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen eingeschlossen.
Content-MD5 Wenn das BLOB über einen MD5-Hash verfügt und bei dem Get Blob-Vorgang das vollständige BLOB gelesen werden soll, wird dieser Antwortheader zurückgegeben, sodass der Client die Integrität des Nachrichteninhalts überprüfen kann.

Ab Version 2012-02-12 legt Put Blob den MD5-Hashwert eines Block-BLOB fest, auch wenn die Put Blob-Anforderung keinen MD5-Header enthält.

Wenn die Anforderung einen angegebenen Bereich liest und auf den x-ms-range-get-content-md5 Wert festgelegt trueist, gibt die Anforderung einen MD5-Hash für den Bereich zurück, solange die Bereichsgröße kleiner oder gleich 4 MiB ist.

Wenn keine dieser Bedingungen true ist, wird kein Wert für den Content-MD5-Header zurückgegeben.

Wenn x-ms-range-get-content-md5 ohne den Range-Header angegeben wird, gibt der Dienst Statuscode 400 (Ungültige Anforderung) zurück.

true Wenn x-ms-range-get-content-md5 der Bereich 4 MiB in Größe überschreitet, gibt der Dienst statuscode 400 (Ungültige Anforderung) zurück.
x-ms-content-crc64 Wenn die Anforderung einen angegebenen Bereich lesen und auf den x-ms-range-get-content-crc64 Wert festgelegt trueist, gibt die Anforderung einen CRC64-Hash für den Bereich zurück, solange die Bereichsgröße kleiner oder gleich 4 MiB ist.

Wenn x-ms-range-get-content-crc64 ohne den Range-Header angegeben wird, gibt der Dienst Statuscode 400 (Ungültige Anforderung) zurück.

true Wenn x-ms-range-get-content-crc64 der Bereich 4 MiB in Größe überschreitet, gibt der Dienst statuscode 400 (Ungültige Anforderung) zurück.
Content-Encoding Dieser Header gibt den Wert zurück, der für den Content-Encoding-Anforderungsheader angegeben wurde.
Content-Language Dieser Header gibt den Wert zurück, der für den Content-Language-Anforderungsheader angegeben wurde.
Cache-Control Dieser Header wird zurückgegeben, wenn er zuvor für das BLOB angegeben wurde.
Content-Disposition Wird für Anforderungen an die Version 2013-08-15 und höher zurückgegeben. Dieser Header gibt den Wert zurück, der für den x-ms-blob-content-disposition-Header angegeben wurde.

Das Feld mit dem Content-Disposition-Antwortheader enthält zusätzliche Informationen darüber, wie die Antwortnutzlast verarbeitet werden soll und kann auch verwendet werden, um zusätzliche Metadaten anzufügen. Wenn der Parameter auf attachment festgelegt ist, bedeutet dies, dass der Benutzer-Agent nicht die Antwort, sondern stattdessen das Dialogfeld Speichern unter mit einem anderen Dateinamen als dem angegebenen BLOB-Namen anzeigen soll.
x-ms-blob-sequence-number Die aktuelle Sequenznummer für ein Seitenblob.

Dieser Header wird nicht für Block-Blobs oder Anfüge-Blobs zurückgegeben.
x-ms-blob-type: <BlockBlob | PageBlob | AppendBlob> Gibt den Typ des BLOB zurück.
x-ms-copy-completion-time: <datetime> Version 2012-02-12 und neuer. Die Abschlusszeit des letzten versuchten Copy Blob-Vorgangs, bei dem dieses BLOB das Ziel-BLOB war. Dieser Wert kann die Zeit eines abgeschlossenen, abgebrochenen oder fehlgeschlagenen Kopierversuchs angeben. Dieser Header ist nicht vorhanden, wenn eine Kopie aussteht, wenn das BLOB nie das Ziel in einem Copy Blob-Vorgang war oder wenn dieses BLOB nach einem abgeschlossenen Copy Blob-Vorgang mit Set Blob Properties, Put Blob oder Put Block List geändert wurde.
x-ms-copy-status-description: <error string> Version 2012-02-12 und neuer. Wird nur angezeigt, wenn x-ms-copy-statusfailed oder pending ist. Beschreibt die Ursache des letzten schwerwiegenden oder nicht schwerwiegenden Fehlers eines Kopiervorgangs. Dieser Header ist nicht vorhanden, wenn das BLOB nie das Ziel in einem Copy Blob-Vorgang war oder wenn dieses BLOB nach einem abgeschlossenen Copy Blob-Vorgang mit Set Blob Properties, Put Blob oder Put Block List geändert wurde.
x-ms-copy-id: <id> Version 2012-02-12 und neuer. Ein Zeichenfolgenbezeichner für den letzten versuchten Copy Blob-Vorgang, bei dem dieses BLOB das Ziel-BLOB war. Dieser Header ist nicht vorhanden, wenn das BLOB nie das Ziel in einem Copy Blob-Vorgang war oder wenn dieses BLOB nach einem abgeschlossenen Copy Blob-Vorgang mit Set Blob Properties, Put Blob oder Put Block List geändert wurde.
x-ms-copy-progress: <bytes copied/bytes total> Version 2012-02-12 und neuer. Enthält die Anzahl der kopierten Bytes und die Gesamtzahl der Bytes in der Quelle im letzten versuchten Copy Blob-Vorgang, bei dem dieses BLOB das Ziel-BLOB war. Kann zwischen 0 und Content-Length kopierte Bytes angeben. Dieser Header ist nicht vorhanden, wenn das BLOB nie das Ziel in einem Copy Blob-Vorgang war oder wenn dieses BLOB nach einem abgeschlossenen Copy Blob-Vorgang mit Set Blob Properties, Put Blob oder Put Block List geändert wurde.
x-ms-copy-source: url Version 2012-02-12 und neuer. URL bis zu 2 KiB länge, die den Quell-Blob oder die Datei angibt, die im letzten versuchten Copy Blob Vorgang verwendet wird, in dem dieses Blob das Ziel-Blob war. Dieser Header ist nicht vorhanden, wenn das BLOB nie das Ziel in einem Copy Blob-Vorgang war oder wenn dieses BLOB nach einem abgeschlossenen Copy Blob-Vorgang mit Set Blob Properties, Put Blob oder Put Block List geändert wurde.

Die in diesem Header zurückgegebene URL enthält alle Anforderungsparameter, die im Kopiervorgang im Quell-Blob verwendet werden, einschließlich des SAS-Tokens, das für den Zugriff auf das Quell-Blob verwendet wird.
x-ms-copy-status: <pending | success | aborted | failed> Version 2012-02-12 und neuer. Der Status des durch x-ms-copy-id identifizierten Kopiervorgangs, mit den folgenden Werten:

- success: Kopie erfolgreich abgeschlossen.
- pending: Kopie wird ausgeführt. Überprüfen Sie x-ms-copy-status-description, wenn zeitweilige, nicht schwerwiegende Fehler den Kopiervorgang verlangsamen, jedoch keinen Fehler verursachen.
- aborted: Kopie wurde beendet Abort Copy Blob.
- failed: Fehler beim Kopieren. Fehlerdetails finden Sie in x-ms-copy-status-description.

Dieser Header ist nicht vorhanden, wenn das BLOB nie das Ziel in einem Copy Blob-Vorgang war oder wenn dieses BLOB nach einem abgeschlossenen Copy Blob-Vorgang mit Set Blob Properties, Put Blob oder Put Block List geändert wurde.
x-ms-lease-duration: <infinite | fixed> Version 2012-02-12 und neuer. Gibt für ein geleastes BLOB an, ob die Lease von unbegrenzter oder fester Dauer ist.
x-ms-lease-state: <available | leased | expired | breaking | broken> Version 2012-02-12 und neuer. Der Leasestatus des BLOB.
x-ms-lease-status:<locked | unlocked> Der aktuelle Leasestatus des BLOB.
x-ms-request-id Dieser Header identifiziert die erfolgte Anforderung eindeutig und kann für die Problembehandlung der Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung bei API-Vorgängen.
x-ms-version Gibt die Version des Blob-Diensts an, der zum Ausführen der Abfrage verwendet wird. Enthalten für Anforderungen, die mit Version 2009-09-19 und neuer vorgenommen wurden.

Dieser Header wird auch für die anonymen Anforderungen ohne Versionsangabe zurückgegeben, wenn der Container für öffentlichen Zugriff mit Version 2009-09-19 des Blob-Diensts markiert wurde.
Accept-Ranges: bytes Gibt an, dass der Dienst Anforderungen für teilweisen BLOB-Inhalt unterstützt. Eingeschlossen für Anforderungen, die mit Version 2011-08-18 oder höher ausgeführt werden, sowie für den lokalen Speicherdienst in SDK-Version 1.6 oder höher.
Date Ein vom Dienst generierter Datums-/Uhrzeitwert in UTC, der angibt, wann die Antwort initiiert wurde.
Access-Control-Allow-Origin Wird zurückgegeben, wenn die Anforderung einen Origin-Header enthält und CORS mit einer Abgleichsregel aktiviert ist. Dieser Header gibt den Wert des Origin-Anforderungsheaders im Falle einer Übereinstimmung zurück.
Access-Control-Expose-Headers Wird zurückgegeben, wenn die Anforderung einen Origin-Header enthält und CORS mit einer Abgleichsregel aktiviert ist. Gibt die Liste der Antwortheader zurück, die gegenüber dem Client oder Aussteller der Anforderung verfügbar gemacht werden sollen.
Vary Wird mit dem Wert des Origin-Headers zurückgegeben, wenn CORS-Regeln angegeben werden. Ausführliche Informationen finden Sie unter CORS-Support für die Speicherdienste .
Access-Control-Allow-Credentials Wird zurückgegeben, wenn die Anforderung einen Origin-Header enthält und CORS mit einer Abgleichsregel aktiviert ist, die nicht alle Ursprungsdomänen zulässt. Dieser Header wird auf TRUE festgelegt.
x-ms-blob-committed-block-count Die Anzahl der commit-Blöcke, die im Blob vorhanden sind. Dieser Header wird nur für Anfüge-Blobs zurückgegeben.
x-ms-server-encrypted: true/false Version 2015-12-11 oder höher. Der Wert dieses Headers wird festgelegt true , wenn die Blobdaten und Anwendungsmetadaten vollständig mithilfe des angegebenen Algorithmus verschlüsselt werden. Andernfalls wird der Wert auf false (wenn der Blob nicht verschlüsselt ist oder nur Teile der Blob-/Anwendungsmetadaten verschlüsselt sind).
x-ms-encryption-key-sha256 Version 2019-02-02 oder höher. Dieser Header wird zurückgegeben, wenn das Blob mit einem vom Kunden bereitgestellten Schlüssel verschlüsselt ist.
x-ms-encryption-scope Version 2019-02-02 oder höher. Dieser Header wird zurückgegeben, wenn das Blob mit einem Verschlüsselungsbereich verschlüsselt ist.
x-ms-blob-content-md5 Ab Version 2016-05-31 wird dieser Antwortheader mit dem Wert md5 des gesamten Blobs MD5 zurückgegeben. Dieser Wert kann oder nicht gleich dem wert sein, der im Content-MD5-Header zurückgegeben wird, wobei letztere aus dem angeforderten Bereich berechnet wird.
x-ms-client-request-id Dieser Header kann verwendet werden, um Anforderungen und entsprechende Antworten zu behandeln. Der Wert dieses Headers entspricht dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert höchstens 1024 sichtbare ASCII-Zeichen aufweist. Wenn der x-ms-client-request-id Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden.
x-ms-last-access-time Version 2020-02-10 oder höher. Gibt die letzte Uhrzeit an, an der die Daten des Blobs basierend auf der Richtlinie für die letzte Zugriffszeitnachverfolgung des Speicherkontos zugegriffen wurden. Der Header wird nicht zurückgegeben, wenn das Speicherkonto nicht über eine Richtlinie zur letzten Zugriffszeitnachverfolgung verfügt oder die Richtlinie deaktiviert ist. Informationen zum Festlegen der Richtlinie für die letzte Zugriffszeitnachverfolgung des Speicherkontos finden Sie unter Blob Service API.
x-ms-blob-sealed Version 2019-12-12 oder höher, die nur für Anfüge-Blobs zurückgegeben wird. Wenn der Anfüge-Blob versiegelt wurde, lautet der Wert "True", siehe "Seal Append Blobs"
x-ms-immutability-policy-until-date Version 2020-06-12 oder höher. Gibt das auf dem Blob festgelegte Datum der "Aufbewahrung bis" an. Dies ist das Datum, bis das Blob vor der Änderung oder Löschung geschützt werden kann. Wird nur zurückgegeben, wenn eine Unveränderlichkeitsrichtlinie für das Blob festgelegt ist. Der Wert dieses Headers ist RFC1123-Format.
x-ms-immutability-policy-mode: unlocked/locked Version 2020-06-12 oder höher. Der Unveränderlichkeitsrichtlinienmodus, der zurückgegeben wird, wenn eine Unveränderlichkeitsrichtlinie für das Blob festgelegt ist. Werte sind unlocked/locked. unlocked gibt an, dass der Benutzer die Richtlinie ändern kann, indem die Aufbewahrung bis zum Datum erhöht oder verringert wird. locked gibt an, dass diese Aktionen verboten sind.
x-ms-legal-hold: true/false Version 2020-06-12 oder höher. Dieser Header wird nicht zurückgegeben, wenn kein legaler Haltebereich für das Blob vorhanden ist. Der Wert dieses Headers wird auf "true" festgelegt, wenn der Blob einen gesetzlichen Haltebereich enthält und dessen Wert wahr ist. Andernfalls wird der Wert auf "false" festgelegt, wenn der Blob einen gesetzlichen Halteraum und seinen Wert "false" enthält.
x-ms-owner Version 2020-06-12 oder höher nur für Konten mit aktivierter hierarchischer Namespace. Gibt den Besitzerbenutzer der Datei oder des Verzeichnisses zurück.
x-ms-group Version 2020-06-12 oder höher nur für Konten mit aktivierter hierarchischer Namespace. Gibt die eigene Gruppe der Datei oder des Verzeichnisses zurück.
x-ms-permissions Version 2020-06-12 oder höher nur für Konten mit aktivierter hierarchischer Namespace. Gibt die Berechtigungen zurück, die für "Benutzer", "Gruppe" und "andere" in der Datei oder im Verzeichnis festgelegt sind. Jede einzelne Berechtigung befindet sich im Format [r,w,x,-]{3}
x-ms-resource-type Version 2020-10-02 oder höher nur für Konten mit aktivierter hierarchischer Namespace. Gibt den Ressourcentyp für den Pfad zurück, der beides file/directorysein kann.

Antworttext

Der Antworttext enthält den Inhalt des BLOB.

Beispiel für eine Antwort

Status Response:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-blob-type: BlockBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Vary: Origin  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
  

Autorisierung

Wenn die Zugriffssteuerungsliste des Containers anonymen Zugriff auf das BLOB zulässt, kann dieser Vorgang von jedem Client aufgerufen werden. Wenn der Container privat ist, kann dieser Vorgang vom Kontobesitzer und von jedem Benutzer mit einer SAS (Shared Access Signature) ausgeführt werden, der über die Berechtigung zum Lesen des BLOB verfügt.

Bemerkungen

Für ein Seitenblob werden von einem Get Blob-Vorgang über einen Bereich von Seiten, die noch keinen Inhalt aufweisen oder gelöscht wurden, Nullen für diese Bytes zurückgegeben.

Wenn Sie Get Blob für ein Seitenblob ohne Angabe eines Bereichs aufrufen, gibt der Dienst den Seitenbereich bis zum Wert zurück, der für den x-ms-blob-content-length-Header angegeben ist. Für alle Seiten ohne Inhalt gibt der Dienst Nullen für die betreffenden Bytes zurück.

Bei einem Anfüge-Blob gibt der Get Blob Vorgang Kopfzeile zurück x-ms-blob-committed-block-count . Dieser Header gibt die Anzahl der zugesicherten Blöcke im Blob an. Der x-ms-blob-committed-block-count Header wird nicht für Block-Blobs oder Seiten-Blobs zurückgegeben.

Ein Get Blob Vorgang ist 2 Minuten pro MiB zulässig. Wenn der Vorgang im Durchschnitt länger als 2 Minuten pro MiB dauert, wird der Vorgang ausgedauert.

Der x-ms-version-Header ist erforderlich, um ein BLOB abzurufen, das zu einem privaten Container gehört. Wenn das BLOB zu einem Container gehört, der für vollständigen oder teilweisen öffentlichen Zugriff verfügbar ist, kann er von jedem Client ohne Angabe einer Version gelesen werden; die Dienstversion ist zum Abrufen eines BLOB, das zu einem öffentlichen Container gehört, nicht erforderlich. Weitere Informationen finden Sie unter Beschränken des Zugriffs auf Container und BLOBs .

Bei Get Blob einem archivierten Block-Blob tritt ein Fehler auf.

Kopiervorgänge

Um zu bestimmen, ob ein Copy Blob-Vorgang abgeschlossen wurde, überprüfen Sie zuerst, ob der x-ms-copy-id-Headerwert des Ziel-BLOB mit der Kopie-ID übereinstimmt, die durch den ursprünglichen Aufruf von Copy Blob angegeben wurde. Eine Übereinstimmung stellt sicher, dass keine andere Anwendung den Kopiervorgang abgebrochen und einen neuen Copy Blob-Vorgang gestartet hat. Überprüfen Sie dann, ob der x-ms-copy-status: success-Header vorhanden ist. Beachten Sie jedoch, dass alle Schreibvorgänge für ein BLOB, mit Ausnahme der Vorgänge Lease, Put Page und Put Block, alle x-ms-copy-*-Eigenschaften aus dem BLOB entfernen. Diese Eigenschaften werden außerdem nicht durch Copy Blob-Vorgänge kopiert, die in früheren Versionen als 2012-02-12 erfolgen.

Warnung

Die in der x-ms-copy-source Kopfzeile zurückgegebene URL enthält alle Anforderungsparameter, die im Kopiervorgang im Quell-Blob verwendet werden. Wenn ein SAS-Token verwendet wird, um auf den Quell-Blob zuzugreifen, wird dieses SAS-Token im x-ms-copy-source Header angezeigt, wenn Get Blob er im Ziel-Blob aufgerufen wird.

Wenn x-ms-copy-status: failed in der Antwort angezeigt wird, enthält x-ms-copy-status-description weitere Informationen zum Copy Blob-Fehler.

In der folgenden Tabelle werden die drei Felder jedes x-ms-copy-status-description-Werts beschrieben.

Komponente BESCHREIBUNG
HTTP-Statuscode Eine standardmäßige dreistellige Zahl, die den Fehler angibt.
Fehlercode Schlüsselwort zur Beschreibung des Fehlers, der <von Azure im ErrorCode-Element> bereitgestellt wird. Wenn kein <ErrorCode-Element> angezeigt wird, wird ein Schlüsselwort mit Standardfehlertext verwendet, der dem 3-stelligen HTTP-Statuscode in der HTTP-Spezifikation zugeordnet ist. Siehe allgemeine REST-API-Fehlercodes.
Information Eine ausführliche Fehlerbeschreibung in Anführungszeichen.

In der folgenden Tabelle werden der x-ms-copy-status-Wert und der x-ms-copy-status-description-Wert von häufigen Fehlerszenarien beschrieben.

Wichtig

Der hier dargestellte Beschreibungstext kann ohne entsprechenden Hinweis geändert werden, auch wenn keine Versionsänderung erfolgt. Verlassen Sie sich daher nicht auf die genaue Übereinstimmung dieses Texts.

Szenario x-ms-copy-status-Wert x-ms-copy-status-description-Wert
Der Kopiervorgang wurde erfolgreich abgeschlossen. success empty
Der Kopiervorgang wurde vom Benutzer abgebrochen. aborted empty
Beim Lesen aus dem Quell-BLOB während eines Kopiervorgangs ist ein Fehler aufgetreten, der Vorgang wird jedoch wiederholt. pending 502 BadGateway "Wiederholbarer Fehler beim Lesen der Quelle. Es wird versucht, den Vorgang zu wiederholen. Fehlerzeit: <Zeit>"
Beim Schreiben in das Ziel-BLOB eines Kopiervorgangs ist ein Fehler aufgetreten, der Vorgang wird jedoch wiederholt. pending 500 InternalServerError "Wiederholbarer Fehler. Es wird versucht, den Vorgang zu wiederholen. Fehlerzeit: <Zeit>"
Beim Lesen aus dem Quell-BLOB eines Kopiervorgangs ist ein nicht behebbarer Fehler aufgetreten. „Fehlgeschlagen“ 404 ResourceNotFound "Fehler beim Kopieren während des Lesens der Quelle."

Hinweis: Beim Melden dieses zugrunde liegenden Fehlers gibt Azure im ErrorCode Element zurückResourceNotFound. Wenn kein ErrorCode Element in der Antwort angezeigt wurde, wird eine Standardzeichenfolgendarstellung des HTTP-Status angezeigt, z NotFound . B. angezeigt.
Das Timeout, das alle Kopiervorgänge einschränkt, ist abgelaufen. (Derzeit beträgt das Timeout 2 Wochen.) „Fehlgeschlagen“ 500 OperationCancelled "Die maximal zulässige Zeit für den Kopiervorgang wurde überschritten."
Der Kopiervorgang ist beim Lesen aus der Quelle zu häufig fehlgeschlagen, und ein minimales Verhältnis von fehlgeschlagenen zu erfolgreichen Versuchen wurde nicht erreicht. (Dieses Timeout verhindert 2 Wochen lang erneute Versuche des Vorgangs für eine fehlerhafte Quelle, bevor der Vorgang fehlschlägt.) „Fehlgeschlagen“ 500 OperationCancelled "Fehler beim Kopieren während des Lesens der Quelle."

x-ms-last-access-time verfolgt die Zeit, zu der auf die Daten des Blobs basierend auf der Richtlinie zur letzten Zugriffsüberwachung des Speicherkontos zugegriffen wurde. Der Zugriff auf die Metadaten eines Blobs ändert die letzte Zugriffszeit nicht.

Weitere Informationen

Autorisieren von Anforderungen an Azure Storage
Status- und Fehlercodes
Blob-Dienst-Fehlercodes
Festlegen von Timeouts für Blob-Dienstvorgänge