(0) exportieren Drucken
Alle erweitern

Get Blob Properties

Letzte Aktualisierung: Juni 2014

Mit dem Get Blob Properties-Vorgang werden alle benutzerdefinierten Metadaten, HTTP-Standardeigenschaften und Systemeigenschaften für das BLOB zurückgegeben. Der Inhalt des BLOB wird nicht zurückgegeben.

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

 

  Anforderungs-URI für HEAD-Methode HTTP-Version

https://myaccount.blob.core.windows.net/mycontainer/myblob

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

HTTP/1.1

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 HEAD-Methode HTTP-Version

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob

HTTP/1.1

Weitere Informationen finden Sie unter Einsatz des Azure-Speicheremulators für Entwicklung und Tests.

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 BLOB

timeout

Optional. Der timeout-Parameter wird in Sekunden angegeben. Weitere Informationen finden Sie unter Festlegen von Timeouts für Blob-Dienstvorgänge.

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

 

Anforderungsheader Beschreibung

Authorization

Erforderlich. Gibt das Authentifizierungsschema, den Kontonamen und die Signatur an. Weitere Informationen finden Sie unter Authentifizierung für die Azure-Speicherdienste.

Date oder x-ms-date

Erforderlich. Gibt die Uhrzeit der Anforderung in koordinierter Weltzeit (UTC) an. Weitere Informationen finden Sie unter Authentifizierung für die Azure-Speicherdienste.

x-ms-version

Für alle authentifizierten Anforderungen erforderlich, für anonyme Anforderungen optional. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure-Speicherdienste.

x-ms-lease-id: <ID>

Optional. Bei Angabe dieses Headers wird der Get Blob Properties-Vorgang nur ausgeführt, wenn die beiden folgenden Bedingungen erfüllt sind:

  • Die Lease des BLOB ist derzeit aktiv.

  • Die in der Anforderung angegebene Lease-ID stimmt mit der Lease-ID des BLOB überein.

Wenn nicht beide Bedingungen erfüllt sind, schlägt die Anforderung fehl, und der Get Blob Properties-Vorgang schlägt mit dem Statuscode 412 (Vorbedingung nicht erfüllt) fehlt.

x-ms-client-request-id

Optional. Stellt einen vom Client generierten, nicht transparenten Wert mit einer Zeichenbeschränkung von 1 KB bereit, der in den Analyseprotokollen erfasst wird, wenn die Protokollierung der Speicheranalyse aktiviert ist. Die Verwendung dieses Headers wird dringend empfohlen, um clientseitige Aktivitäten mit den vom Server empfangenen Anforderungen zu korrelieren. Weitere Informationen finden Sie unter Informationen zur Protokollierung durch die Speicheranalyse und Windows Azure-Protokollierung: Verwenden von Protokollen zur Nachverfolgung von Speicheranforderungen.

Dieser Vorgang unterstützt die Verwendung von bedingten Headern zum Zurückgeben von BLOB-Eigenschaften und -Metadaten nur dann, wenn eine angegebene Bedingung erfüllt ist. Weitere Informationen finden Sie unter Angeben von bedingten Headern für Vorgänge des Blob-Diensts.

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben.

Weitere Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

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.

 

Antwortheader Beschreibung

Last-Modified

Datum/Uhrzeit der letzten Änderung des BLOB. Das Datumsformat entspricht RFC 1123. Weitere Informationen finden Sie unter Darstellung von Datums-/Uhrzeitwerten in Headern.

Durch jeden Vorgang, der das BLOB ändert, einschließlich eines Updates der Metadaten oder Eigenschaften des BLOB, wird der Zeitpunkt der letzten Änderung aktualisiert.

x-ms-meta-name:value

Ein Satz von Name-Wert-Paaren, die den benutzerdefinierten Metadaten für dieses BLOB entsprechen.

x-ms-blob-type:<BlockBlob|PageBlob>

Der BLOB-Typ.

x-ms-copy-completion-time:<datetime>

Version 2012-02-12 und höher. 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 höher – wird nur angezeigt, wenn x-ms-copy-status den Wert failed oder pending aufweist. Beschreibt die Ursache eines schwerwiegenden oder nicht schwerwiegenden Fehlers beim Kopiervorgang. 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 höher. 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 höher. 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 höher. Eine URL mit einer Länge von bis zu 2 KB, die das Quell-BLOB angibt, das im letzten versuchten Copy Blob-Vorgang verwendet wurde, 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-status: <pending | success | aborted | failed>

Version 2012-02-12 und höher. Der Status des durch x-ms-copy-id identifizierten Kopiervorgangs, mit den folgenden Werten:

  • success: Der Kopiervorgang wurde erfolgreich abgeschlossen.

  • pending: Der Kopiervorgang wird gerade ausgeführt. Überprüfen Sie x-ms-copy-status-description. Zeitweilige, nicht schwerwiegende Fehler behindern den Kopiervorgang, verursachen jedoch keinen Fehler.

  • aborted: Der Kopiervorgang wurde durch Abort Blob Copy beendet.

  • failed: Der Kopiervorgang ist fehlgeschlagen. 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>

Gibt für ein geleastes BLOB an, ob die Lease von unbegrenzter oder fester Dauer ist. Ist in Anforderungen mit Version 2012-02-12 und höher enthalten.

x-ms-lease-state: <available | leased | expired | breaking | broken>

Der Leasestatus des BLOB. Ist in Anforderungen enthalten, die mit Version 12.02.2012 oder höher erfolgen.

x-ms-lease-status:<locked| unlocked>

Der Leasestatus des BLOB.

Content-Length

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

Content-Type

Der für das BLOB angegebene Inhaltstyp. Wenn kein Inhaltstyp angegeben wurde, ist der Standardinhaltstyp application/octet-stream.

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 Vorgänge des Blob-Diensts. Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen eingeschlossen.

Content-MD5

Wenn der Content-MD5-Header für das BLOB festgelegt wurde, wird dieser Antwortheader zurückgegeben, damit der Client die Integrität des Nachrichteninhalts überprüfen kann.

In Version 2012-02-12 und höher legt Put Blob den MD5-Wert eines Block-BLOB fest, auch wenn die Put Blob-Anforderung keinen MD5-Header enthält.

Content-Encoding

Wenn zuvor der Content-Encoding-Anforderungsheader für das BLOB festgelegt wurde, wird dieser Wert in diesem Header zurückgegeben.

Content-Language

Wenn zuvor der Content-Language-Anforderungsheader für das BLOB festgelegt wurde, wird dieser Wert in diesem Header zurückgegeben.

Content-Disposition

Wenn zuvor der Content-Disposition-Anforderungsheader für das BLOB festgelegt wurde, wird der Wert in diesem Header für Anforderungen zurückgegeben, die für Version 2013-08-15 und höher erfolgen.

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

Cache-Control

Wenn zuvor der Cache-Control-Anforderungsheader für das BLOB festgelegt wurde, wird dieser Wert in diesem Header zurückgegeben.

x-ms-blob-sequence-number

Die aktuelle Sequenznummer für ein Seitenblob.

Dieser Header wird nicht für Block-BLOBs zurückgegeben.

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 für API-Vorgänge.

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

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.

Date

Ein vom Dienst generierter Datums-/Uhrzeitwert in UTC, der angibt, wann die Antwort initiiert wurde.

Accept-Ranges: bytes

Gibt an, dass der Dienst Anforderungen für teilweisen BLOB-Inhalt unterstützt. Ist in Anforderungen enthalten, die mit Version 15.08.2013 oder höher erfolgen.

Keine.

Response Status:
HTTP/1.1 200 OK

Response Headers:
x-ms-meta-Name: myblob.txt
x-ms-meta-DateUploaded: Sun, 23 Oct 2013 18:45:18 GMT
x-ms-blob-type: BlockBlob
x-ms-lease-status: unlocked
x-ms-lease-state: available
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: Sun, 23 Oct 2013 19:49:38 GMT
ETag: "0x8CAE97120C1FF22"
Accept-Ranges: bytes
x-ms-version: 2013-08-15
Last-Modified: Wed, 23 Oct 2013 19:49
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

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.

Um zu bestimmen, ob ein Copy Blob-Vorgang abgeschlossen wurde, überprüfen Sie zunächst, ob der x-ms-copy-id-Headerwert mit der vom ursprünglichen Aufruf von Copy Blob bereitgestellten Kopie-ID übereinstimmt. 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.

x-ms-copy-status-description enthält weitere Informationen zum Fehler bei Copy Blob. In der folgenden Tabelle werden x-ms-copy-status-description-Werte und ihre Bedeutung beschrieben.

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

Ein Schlüsselwort, das den von Azure im <ErrorCode>-Element bereitgestellten Fehler beschreibt. Wenn kein <ErrorCode>-Element vorhanden ist, wird ein Schlüsselwort verwendet, das den Standardfehlertext enthält, der dem dreistelligen HTTP-Statuscode in der HTTP-Spezifikation zugeordnet ist. Siehe Allgemeine REST-API-Fehlercodes.

Informationen

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.

ImportantWichtig
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. Zeitpunkt des Fehlers: <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. Zeitpunkt des Fehlers: <Zeit>"

Beim Lesen aus dem Quell-BLOB eines Kopiervorgangs ist ein nicht behebbarer Fehler aufgetreten.

Gescheitert

404 ResourceNotFound "Fehler beim Kopieren während des Lesens der Quelle."

noteHinweis
Wenn dieser zugrunde liegende Fehler gemeldet wird, gibt Azure im ResourceNotFoundErrorCode<-Element > zurück. Wenn die Antwort kein <ErrorCode>-Element enthält, wird eine Standardzeichenfolgendarstellung des HTTP-Status, z. B. NotFound, angezeigt.

Das Timeout, das alle Kopiervorgänge einschränkt, ist abgelaufen. (Derzeit beträgt das Timeout 2 Wochen.)

Gescheitert

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

Gescheitert

500 OperationCancelled "Fehler beim Kopieren während des Lesens der Quelle."

Anzeigen:
© 2014 Microsoft