Set Blob Properties

  • Artikel

Mit dem Vorgang Set Blob Properties werden Systemeigenschaften für das BLOB festgelegt.

Anforderung

Die Set Blob Properties-Anforderung kann wie folgt erstellt werden. Es wird empfohlen, HTTPS zu verwenden. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos:

PUT-Methodenanforderungs-URI HTTP-Version
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=properties HTTP/1.1

URI des emulierten Speicherdiensts

Wenn Sie eine Anforderung für den emulierten Speicherdienst stellen, geben Sie den Hostnamen des Emulators und den Blob Storage-Port als 127.0.0.1:10000an, gefolgt vom Namen des emulierten Speicherkontos:

PUT-Methodenanforderungs-URI HTTP-Version
http://127.0.0.1:10000/ devstoreaccount1/mycontainer/myblob?comp=properties HTTP/1.1

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

URI-Parameter

Sie können im Anforderungs-URI die folgenden zusätzlichen Parameter angeben:

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

Anforderungsheader (alle Blobtypen)

In der folgenden Tabelle werden die erforderlichen und optionalen Anforderungsheader für alle Blobtypen 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. 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-blob-cache-control Optional. Ändert die Cachesteuerelement-Zeichenfolge für das BLOB.

Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für das Blob gelöscht. Nachfolgende Aufrufe von Get Blob Properties geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für das Blob festgelegt.
x-ms-blob-content-type Optional. Legt den Inhaltstyp des BLOB fest.

Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für das Blob gelöscht. Nachfolgende Aufrufe von Get Blob Properties geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für das Blob festgelegt.
x-ms-blob-content-md5 Optional. Legt den MD5-Hash des BLOB fest.

Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für das Blob gelöscht. Nachfolgende Aufrufe von Get Blob Properties geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für das Blob festgelegt.
x-ms-blob-content-encoding Optional. Legt die Inhaltscodierung des BLOB fest.

Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für das Blob gelöscht. Nachfolgende Aufrufe von Get Blob Properties geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für das Blob festgelegt.
x-ms-blob-content-language Optional. Legt die Sprache für den Inhalt des BLOB fest.

Wenn diese Eigenschaft in der Anforderung nicht angegeben wird, wird die Eigenschaft für das Blob gelöscht. Nachfolgende Aufrufe von Get Blob Properties geben diese Eigenschaft nicht zurück, es sei denn, sie wird erneut explizit für das Blob festgelegt.
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, undurchsichtigen Wert mit einem Zeichenlimit von 1 Kibibyte (KiB) bereit, der beim Konfigurieren der Protokollierung in den Protokollen aufgezeichnet wird. Es wird dringend empfohlen, diesen Header zu verwenden, um clientseitige Aktivitäten mit Anforderungen zu korrelieren, die der Server empfängt. Weitere Informationen finden Sie unter Überwachen Azure Blob Storage.
x-ms-blob-content-disposition Optional. Legt den Content-Disposition-Header des BLOBs fest. Verfügbar für Version 2013-08-15 und höher.

Das Content-Disposition Antwortheaderfeld gibt zusätzliche Informationen zur Verarbeitung der Antwortnutzlast an und kann zum Anfügen zusätzlicher Metadaten verwendet werden. Wenn sie beispielsweise auf attachmentfestgelegt ist, gibt dies an, dass der Benutzer-Agent die Antwort nicht anzeigen soll, sondern stattdessen ein Dialogfeld Speichern unter mit einem anderen Dateinamen als dem angegebenen Blobnamen anzeigt.

Die Antwort aus den Vorgängen Get Blob und Get Blob Properties enthält den 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. Weitere Informationen finden Sie unter CORS-Unterstützung (Cross-Origin Resource Sharing) für die Azure Storage-Dienste.

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 Storage-Vorgänge.

Anforderungsheader (nur Seitenblobs)

In der folgenden Tabelle werden Anforderungsheader beschrieben, die nur für Vorgänge in Seitenblobs gelten:

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 Blobs ist, werden alle Seitenblobs mit Werten gelöscht, die größer als der angegebene Wert sind.

Diese Eigenschaft kann nicht verwendet werden, um die Größe eines Blockblobs oder eines Anfügeblobs zu ändern. Wenn Sie diese Eigenschaft für ein Blockblob oder ein Anfügeblob festlegen, wird status Code 400 (Ungültige Anforderung) zurückgegeben.
x-ms-sequence-number-action: {max, update, increment} Optional, aber erforderlich, wenn der 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 Wert fest, der in der Anforderung enthalten ist, und den Wert, der derzeit für das Blob gespeichert ist.
- update: Legt die Sequenznummer auf den Wert fest, der in der Anforderung enthalten ist.
- increment: Erhöht den Wert der Sequenznummer um 1. Wenn Sie diese Option angeben, schließen Sie die nicht ein x-ms-blob-sequence-number header. Dadurch wird status Code 400 (Ungültige Anforderung) zurückgegeben.
x-ms-blob-sequence-number: <num> Optional, aber erforderlich, wenn die x-ms-sequence-number-action-Eigenschaft auf max oder update festgelegt ist. Diese Eigenschaft gilt nur für Seitenblobs.

Die -Eigenschaft legt die Sequenznummer des Blobs 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 im Vorgang "Seite einfügen" .

Verwenden Sie diese Eigenschaft zusammen mit x-ms-sequence-number-action , um die Sequenznummer des Blobs entweder auf den angegebenen Wert oder den höheren der werte zu aktualisieren, die mit der Anforderung angegeben oder derzeit im Blob gespeichert sind. Dieser Header sollte nicht angegeben werden, wenn x-ms-sequence-number-action auf incrementfestgelegt ist. In diesem Fall erhöht der Dienst die Sequenznummer automatisch um eins.

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

Anforderungstext

Keine.

Antwort

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

Statuscode

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

Weitere Informationen zu status Codes 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
ETag Enthält einen Wert, den Sie zum bedingten Ausführen von Vorgängen verwenden können. Weitere Informationen finden Sie unter Angeben von bedingten Headern für Blob Storage-Vorgänge . 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 Darstellen 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 Identifiziert eindeutig die Anforderung, die gestellt wurde, und kann zur Problembehandlung für die Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
x-ms-version Gibt die Blob Storage-Version an, die zum Ausführen der Anforderung verwendet wurde. Dieser Header wird für Anforderungen zurückgegeben, die für Version 2009-09-19 und höher ausgeführt wurden.
Date Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der den Zeitpunkt angibt, zu dem 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. Wenn eine Übereinstimmung vorhanden ist, gibt dieser Header den Wert des Ursprungsanforderungsheaders 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.
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 Ursprünge zulässt. Der Header wird auf truefestgelegt.
x-ms-client-request-id Kann zur Problembehandlung von Anforderungen und entsprechenden Antworten verwendet werden. Der Wert dieses Headers ist gleich dem Wert des x-ms-client-request-id Headers, wenn er in der Anforderung vorhanden ist und der Wert nicht mehr als 1.024 sichtbare ASCII-Zeichen enthält. Wenn der x-ms-client-request-id Header in der Anforderung nicht vorhanden ist, ist er in der Antwort nicht vorhanden.

Antworttext

Keine.

Authorization

Beim Aufrufen eines Datenzugriffsvorgangs in Azure Storage ist eine Autorisierung erforderlich. Sie können den Set Blob Properties Vorgang wie unten beschrieben autorisieren.

Azure Storage unterstützt die Verwendung von Microsoft Entra ID zum Autorisieren von Anforderungen für Blobdaten. Mit Microsoft Entra ID können Sie die rollenbasierte Zugriffssteuerung von Azure (Azure RBAC) verwenden, um einem Sicherheitsprinzipal Berechtigungen zu erteilen. Der Sicherheitsprinzipal kann ein Benutzer, eine Gruppe, ein Anwendungsdienstprinzipal oder eine verwaltete Azure-Identität sein. Der Sicherheitsprinzipal wird von Microsoft Entra ID authentifiziert, um ein OAuth 2.0-Token zurückzugeben. Das Token kann anschließend zum Autorisieren einer Anforderung an den Blob-Dienst verwendet werden.

Weitere Informationen zur Autorisierung mit Microsoft Entra ID finden Sie unter Autorisieren des Zugriffs auf Blobs mithilfe von Microsoft Entra ID.

Berechtigungen

Unten sind die RBAC-Aktion aufgeführt, die für einen Microsoft Entra Benutzer, eine Gruppe oder einen Dienstprinzipal erforderlich ist, um den Set Blob Properties Vorgang aufzurufen, und die integrierte Azure RBAC-Rolle mit den geringsten Berechtigungen, die diese Aktion enthält:

Weitere Informationen zum Zuweisen von Rollen mithilfe von Azure RBAC finden Sie unter Zuweisen einer Azure-Rolle für den Zugriff auf Blobdaten.

Hinweise

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 auf x-ms-sequence-number-actionmax oder updatefest und gibt einen Wert für den x-ms-blob-sequence-number Header an.

    • Die Anforderung legt den x-ms-sequence-number-action auf incrementfest, was angibt, dass der Dienst die Sequenznummer um eins inkrementieren soll.

  • Die Größe eines Seitenblob wird nur geändert, wenn die Anforderung einen Wert für den x-ms-content-length-Header angibt.

  • Um die Größe eines Seitenblobs in einem Storage Premium-Konto zu ändern, darf die neue Größe die Inhaltslänge, die vom vorhandenen Tarif zulässig ist, nicht überschreiten. Rufen Sie Set Blob Tier auf, bevor Sie die Größe des Blobs ändern. Eine Liste der Tarife und der zulässigen Inhaltslänge finden Sie unter Hochleistungsspeicher premium und verwaltete Datenträger für VMs.

  • Wenn eine Anforderung nur x-ms-blob-sequence-number oder x-ms-content-lengthfestlegt, wird keine der anderen Eigenschaften des Blobs geändert.

  • Wenn eine oder mehrere der folgenden Eigenschaften in der Anforderung festgelegt sind, werden alle Eigenschaften zusammen festgelegt. Wenn für eine Eigenschaft kein Wert angegeben wird, wenn mindestens eine davon 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

Hinweis

Bei einer Sas (Shared Access Signature) können Sie bestimmte eigenschaften überschreiben, die für das Blob gespeichert sind, indem Sie Abfrageparameter als Teil der Shared Access Signature angeben. Die Eigenschaften cache-control, content-type, content-encoding, content-language und content-disposition können überschrieben werden. Weitere Informationen finden Sie unter Erstellen einer Dienst-SAS.

Abrechnung

Preisanforderungen können von Clients stammen, die Blob Storage-APIs verwenden, entweder direkt über die Blob Storage-REST-API oder aus einer Azure Storage-Clientbibliothek. Für diese Anforderungen fallen Gebühren pro Transaktion an. Die Art der Transaktion wirkt sich auf die Belastung des Kontos aus. Beispielsweise werden Lesetransaktionen in eine andere Abrechnungskategorie als das Schreiben von Transaktionen angewendet. Die folgende Tabelle zeigt die Abrechnungskategorie für Set Blob Properties Anforderungen basierend auf dem Speicherkontotyp:

Vorgang Speicherkontotyp Abrechnungskategorie
Set Blob Properties Premium, Blockblob
Standard „Allgemein v2“		 Weitere Vorgänge
Set Blob Properties Standard „Allgemein v1“ Schreibvorgänge

Weitere Informationen zu Preisen für die angegebene Abrechnungskategorie finden Sie unter Azure Blob Storage Preise.

Weitere Informationen