(0) exportieren Drucken
Alle erweitern

Abrufen von Seitenbereichen

Letzte Aktualisierung: Januar 2014

Der Vorgang Get Page Ranges gibt die Liste der gültigen Seitenbereiche für ein Seiten-BLOB oder eine Momentaufnahme eines Seiten-BLOB zurück.

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

 

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist&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 GET-Methode HTTP-Version

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=pagelist

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 BLOB-Momentaufnahme angibt, aus der Informationen abgerufen werden sollen. 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.

Range

Optional. Gibt den Bereich von Bytes an, über den Bereiche aufgelistet werden sollen (jeweils einschließlich). Wenn keine Angabe erfolgt, werden alle Bereiche für das BLOB zurückgegeben.

x-ms-range

Optional. Gibt den Bereich von Bytes an, über den Bereiche aufgelistet werden sollen (jeweils einschließlich).

Wenn Range und x-ms-range angegeben werden, verwendet der Dienst den Wert x-ms-range. 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 Lease des BLOB ist derzeit aktiv.

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

Wenn der Header angegeben ist und beide Bedingungen nicht erfüllt sind, schlägt die Anforderung fehl, und der Vorgang schlägt mit dem Statuscode 412 (Vorbedingung nicht erfüllt) fehl.

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 zudem die Verwendung von bedingten Headern zum Abrufen von Seitenbereichen nur dann, wenn eine bestimmte 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, einen Satz von Antwortheadern und den Antworttext.

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.

 

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 der Zeitpunkt der letzten BLOB-Änderung aktualisiert.

ETag

Das ETag enthält einen Wert, den der Client verwenden kann, um den Vorgang bedingt auszuführen. Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen eingeschlossen.

x-ms-blob-content-length

Die Größe des BLOB in Bytes.

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.

Der Antworttext enthält eine Liste mit gültigen, nicht überlappenden Seitenbereichen, die durch Erhöhen des Adressseitenbereichs sortiert werden. Der Antworttext weist das folgende Format auf.

<?xml version="1.0" encoding="utf-8"?>
<PageList>
   <PageRange>
      <Start>Start Byte</Start>
      <End>End Byte</End>
   </PageRange>
   <PageRange>
      <Start>Start Byte</Start>
      <End>End Byte</End>
   </PageRange>
</PageList>

Wenn der gesamte Seitensatz des BLOB gelöscht wurde, enthält der Antworttext keine Seitenbereiche.

Dieser Vorgang kann vom Kontobesitzer oder einem beliebigen Benutzer mit einer SAS (Shared Access Signature) ausgeführt werden, der über die Berechtigung zum Lesen des BLOB verfügt. Wenn die ACL des Containers anonymen Zugriff zulässt, kann dieser Vorgang von jedem Client aufgerufen werden.

Die Start- und Endbyteoffsets für die einzelnen Seitenbereiche sind inklusiv.

In einem stark fragmentierten Seiten-BLOB mit einer hohen Anzahl von Schreibvorgängen kann eine Get Page Ranges-Anforderung zu einem Fehler aufgrund eines internen Servertimeouts führen. Anwendungen, die Bereiche eines Seiten-BLOB mit vielen Schreibvorgängen abrufen, sollten immer jeweils eine Teilmenge der Seitenbereiche abrufen. Weitere Informationen finden Sie unter Abrufen der Seitenbereiche eines großen Seiten-BLOB in Segmenten.

Anzeigen:
© 2014 Microsoft