Festlegen von BLOB-Eigenschaften
Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Festlegen von BLOB-Eigenschaften

 

Die Set Blob Properties -Operation legt Eigenschaften für das Blob.

Die Set Blob Properties -Anforderung kann wie folgt erstellt werden. HTTPS wird empfohlen. Ersetzen Sie Myaccount mit dem Namen Ihres Speicherkontos:

Anforderungs-URI für PUT-Methode

HTTP-Version

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

HTTP/1.1

Wenn eine Anforderung für den emulierten Speicherdienst ausführen, geben Sie den emulatorhostnamen und den Port des Blob-Dienst als 127.0.0.1:10000, gefolgt vom Namen emulierten Speicherkontos:

Anforderungs-URI für PUT-Methode

HTTP-Version

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

HTTP/1.1

Weitere Informationen finden Sie unter mithilfe der Azure-Speicheremulator für Entwicklungs- und.

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

Parameter

Beschreibung

timeout

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

Die folgende Tabelle beschreibt die erforderlichen und optionalen Anforderungsheader für alle Blob-Typen.

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

Erforderlich für alle authentifizierten Anforderungen. Gibt die Version des für die Anforderung zu verwendenden Vorgangs an. Weitere Informationen finden Sie unter Versionskontrolle für Azure-Speicherdienste.

x-ms-blob-cache-control

Optional. Ändert die Cachesteuerelement-Zeichenfolge für das BLOB.

Wenn diese Eigenschaft für die Anforderung nicht angegeben wird, wird die Eigenschaft für das BLOB gelöscht. Nachfolgende Aufrufe von Get Blob Properties wird diese Eigenschaft zurückgegeben, sofern es nicht explizit für das Blob erneut.

x-ms-blob-content-type

Optional. Legt den Inhaltstyp des BLOB fest.

Wenn diese Eigenschaft für die Anforderung nicht angegeben wird, wird die Eigenschaft für das BLOB gelöscht. Nachfolgende Aufrufe von Get Blob Properties wird diese Eigenschaft zurückgegeben, sofern es nicht explizit für das Blob erneut.

x-ms-blob-content-md5

Optional. Legt den MD5-Hash des BLOB fest.

Wenn diese Eigenschaft für die Anforderung nicht angegeben wird, wird die Eigenschaft für das BLOB gelöscht. Nachfolgende Aufrufe von Get Blob Properties wird diese Eigenschaft zurückgegeben, sofern es nicht explizit für das Blob erneut.

x-ms-blob-content-encoding

Optional. Legt die Inhaltscodierung des BLOB fest.

Wenn diese Eigenschaft für die Anforderung nicht angegeben wird, wird die Eigenschaft für das BLOB gelöscht. Nachfolgende Aufrufe von Get Blob Properties wird diese Eigenschaft zurückgegeben, sofern es nicht explizit für das Blob erneut.

x-ms-blob-content-language

Optional. Legt die Sprache für den Inhalt des BLOB fest.

Wenn diese Eigenschaft für die Anforderung nicht angegeben wird, wird die Eigenschaft für das BLOB gelöscht. Nachfolgende Aufrufe von Get Blob Properties wird diese Eigenschaft zurückgegeben, sofern es nicht explizit für das Blob erneut.

x-ms-lease-id:<ID>

Erforderlich, wenn das BLOB über eine aktive Lease verfügt. Um diesen Vorgang für ein BLOB mit einer aktiven Lease auszuführen, geben Sie die gültige Lease-ID für diesen Header an.

x-ms-client-request-id

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

x-ms-blob-content-disposition

Optional. Legt des BLOBs Content-Disposition Header. Dieser ist für die Version 2013-08-15 und höher verfügbar.

Die Content-Disposition Antwort-Headerfeld enthält zusätzliche Informationen darüber, wie die antwortnutzlast verarbeitet und kann auch verwendet werden, um zusätzliche Metadaten anzufügen. Zum Beispiel wenn festgelegt attachment, bedeutet dies, dass der Benutzer-Agent sollte die Antwort nicht angezeigt, sondern stattdessen eine Speichern unter Dialog mit einem anderen Dateinamen als dem angegebenen Blob-Namen.

Die Antwort von der Get Blob und Get Blob Properties Operationen enthält die content-disposition Header.

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. Finden Sie unter Cross-Origin Resource Sharing (SHARING)-Unterstützung für Azure-Speicherdienste Weitere Informationen.

Dieser Vorgang unterstützt zudem die Verwendung von bedingten Headern zum Festlegen von BLOB-Eigenschaften. Hierfür muss jedoch eine angegebene Bedingung erfüllt sein. Weitere Informationen finden Sie unter Angeben von bedingten Headern für Blob-Dienstvorgänge.

In der folgenden Tabelle werden die Anforderungsheader beschrieben, die nur auf Vorgänge mit Seitenblobs anwendbar sind.

Anforderungsheader

Beschreibung

x-ms-blob-content-length: byte value

Optional. Ändert die Größe eines Seitenblob in die angegebene Größe. Wenn der angegebene Wert kleiner als die aktuelle Größe des BLOB ist, werden alle Seiten über dem angegebenen Wert gelöscht.

Diese Eigenschaft kann verwendet werden, so ändern Sie die Größe eines Block-Blob oder ein Blob anfügen. Durch Festlegen dieser Eigenschaft für ein Block-Blob oder ein Blob Append Gibt Statuscode 400 (Ungültige Anforderung) zurück.

x-ms-sequence-number-action: {max, update, increment}

Optional, aber erforderlich, wenn die x-ms-blob-sequence-number Header für die Anforderung festgelegt ist. Diese Eigenschaft gilt nur für Seitenblobs.

Diese Eigenschaft gibt an, wie der Dienst die Sequenznummer des BLOB ändern soll. Geben Sie eine der folgenden Optionen für diese Eigenschaft an:

  • max: Legt die Sequenznummer auf den höheren der in der Anforderung enthaltenen Werte und den derzeit für das Blob gespeicherten Wert fest.

  • update: Legt die Sequenznummer auf den in der Anforderung enthaltenen Wert fest.

  • increment: Erhöht den Wert der Sequenznummer um 1. Wenn Sie diese Option angeben, enthalten nicht die x-ms-blob-sequence-number header; Dadurch wird also Statuscode 400 (Ungültige Anforderung) zurückgegeben.

x-ms-blob-sequence-number: <num>

Optional, aber erforderlich, wenn die x-ms-sequence-number-action -Eigenschaftensatz auf max oder update. Diese Eigenschaft gilt nur für Seitenblobs.

Diese Eigenschaft legt die Sequenznummer des BLOB fest. Die Sequenznummer ist eine vom Benutzer festgelegte Eigenschaft, die Sie verwenden können, um Anforderungen nachzuverfolgen und Parallelitätsprobleme zu verwalten. Weitere Informationen finden Sie unter den Put Page Vorgang.

Verwenden Sie diese Eigenschaft zusammen mit der x-ms-sequence-number-action Sequenznummer des Blob, der angegebene Wert oder zu aktualisieren, je höher der Werte in der Anforderung angegeben oder derzeit mit dem Blob gespeichert. Dieser Header sollte nicht angegeben werden, wenn x-ms-sequence-number-action festgelegt ist, um increment; in diesem Fall der Dienst automatisch die laufende Nummer um eins erhöht.

Um die Sequenznummer auf einen Wert Ihrer Wahl festzulegen, die diese Eigenschaft angegeben werden, in der Anforderung zusammen mit x-ms-sequence-number-action.

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

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

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

ETag

Das ETag enthält einen Wert, den Sie verwenden können, um Vorgänge bedingt auszuführen. Finden Sie unter Angeben von bedingten Headern für Blob-Dienstvorgänge Weitere Informationen. Wenn die Anforderungsversion 2011-08-18 oder höher ist, wird der ETag-Wert in Anführungszeichen eingeschlossen.

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.

Bei jedem Schreibvorgang für das BLOB (einschließlich von Updates der Metadaten oder Eigenschaften des BLOB) wird der Zeitpunkt der letzten Änderung des BLOB geändert.

x-ms-blob-sequence-number

Wenn es sich um ein Seitenblob handelt, wird die aktuelle Sequenznummer des BLOB mit diesem Header 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 bei 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.

Date

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

Access-Control-Allow-Origin

Zurückgegeben, wenn die Anforderung enthält ein Origin -Header 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

Zurückgegeben, wenn die Anforderung enthält ein Origin -Header 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.

Access-Control-Allow-Credentials

Zurückgegeben, wenn die Anforderung enthält ein Origin -Header und CORS mit einer Abgleichsregel, die nicht alle Ursprünge erlaubt aktiviert ist. Dieser Header wird auf TRUE festgelegt.

Keiner.

Dieser Vorgang kann nur vom Kontobesitzer und von einem Benutzer mit einer SAS (Shared Access Signature) aufgerufen werden, der über die Berechtigung verfügt, in dieses BLOB oder den Container zu schreiben.

Die Semantik für das Aktualisieren der Eigenschaften eines BLOB lautet wie folgt:

  • Die Sequenznummer eines Seitenblob wird nur aktualisiert, wenn die Anforderung eine der folgenden Bedingungen erfüllt:

    • Die Anforderung legt die x-ms-sequence-number-action auf max oder update, und gibt einen Wert für die x-ms-blob-sequence-number Header.

    • Die Anforderung legt die x-ms-sequence-number-action auf increment, gibt an, dass der Dienst die Sequenznummer um 1 inkrementieren soll.

  • Ein Seiten-Blob-Größe wird nur geändert, wenn gibt an, die Anforderung einen Wert für die x-ms-content-length Header.

  • Wenn nur eine Anforderung festlegt x-ms-blob-sequence-number und/oder x-ms-content-length, keine weiteren Eigenschaften aus, und keine anderen Eigenschaften werden für des BLOBs geändert.

  • Beim Festlegen einer oder mehrerer der folgenden Eigenschaften in der Anforderung werden diese Eigenschaften zusammen festgelegt. Wenn kein Wert für eine bestimmte Eigenschaft bereitgestellt wird und mindestens eine der unten aufgeführten Eigenschaften festgelegt ist, wird diese Eigenschaft für das BLOB gelöscht.

    • x-ms-blob-cache-control

    • x-ms-blob-content-type

    • x-ms-blob-content-md5

    • x-ms-blob-content-encoding

    • x-ms-blob-content-language

    • x-ms-blob-content-disposition

Beachten Sie bei einer SAS, dass Sie bestimmte, für das BLOB gespeicherte Eigenschaften überschreiben können, indem Sie Abfrageparameter als Teil der SAS angeben. Zu diesen Eigenschaften gehören die cache-control, content-type, content-encoding, content-language, und content-disposition Eigenschaften. Weitere Informationen finden Sie unter Erstellen einen SAS-Dienst.

Anzeigen:
© 2016 Microsoft