Set Share Metadata

Der Set Share Metadata Vorgang legt mindestens ein benutzerdefiniertes Name/Wert-Paar für die angegebene Freigabe fest. Obwohl dieser Vorgang vollständig unterstützt wird, handelt es sich um einen Legacyverwaltungsvorgang. Es wird empfohlen, stattdessen den Vorgang Dateifreigaben – Update zu verwenden, der vom Speicherressourcenanbieter (Microsoft.Storage) bereitgestellt wird. Weitere Informationen zur programmgesteuerten Interaktion mit FileShare Ressourcen mithilfe des Speicherressourcenanbieters finden Sie unter Vorgänge für Dateifreigaberessourcen.

Protokollverfügbarkeit

Aktiviertes Dateifreigabeprotokoll	Verfügbar
SMB
NFS

Anforderung

Sie erstellen die Set Share Metadata Anforderung wie folgt. Wir empfehlen HTTPS. Ersetzen Sie myaccount durch den Namen Ihres Speicherkontos.

Methode	Anforderungs-URI	HTTP-Version
PUT	https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata	HTTP/1.1

Ersetzen Sie die im Anforderungs-URI angezeigten Pfadkomponenten wie folgt durch Ihre eigenen Angaben:

Pfadkomponente	BESCHREIBUNG
myaccount	Der Name Ihres Speicherkontos.
myshare	Der Name der Dateifreigabe.

Ausführliche Informationen zu Einschränkungen bei der Pfadbenennung finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten.

URI-Parameter

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

Parameter	BESCHREIBUNG
timeout	Optional. Ausgedrückt in Sekunden. Weitere Informationen finden Sie unter Festlegen von Timeouts für Azure Files Vorgänge.

Anforderungsheader

In der folgenden Tabelle werden die erforderlichen und optionalen 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. 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-meta-name:value	Optional. Stellt ein Name-Wert-Paar bereit, das Metadaten für die Freigabe enthält. Bei jedem Aufruf dieses Vorgangs werden alle vorhandenen Metadaten ersetzt, die an die Freigabe angefügt sind. Um alle Metadaten aus der Freigabe zu entfernen, rufen Sie diesen Vorgang ohne Metadatenheader auf. Metadatennamen müssen den Benennungsregeln für C#-Bezeichner entsprechen.
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 Storage Analytics 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-lease-id:<ID>	Erforderlich, wenn die Zieldateifreigabe über eine aktive Lease verfügt. Verfügbar für Version 2020-02-10 und höher. Wenn die Anforderung die Lease-ID nicht enthält oder ungültig ist, schlägt der Vorgang mit status Code 412 (Vorbedingung fehlgeschlagen) fehl. Wenn dieser Header angegeben ist und die Zieldateifreigabe derzeit nicht über eine aktive Lease verfügt, schlägt der Vorgang mit status Code 412 (Vorbedingung fehlgeschlagen) fehl.

Anforderungstext

Keine.

Beispiel für eine Anforderung

PUT https://myaccount.file.core.windows.net/myshare?restype=share&comp=metadata HTTP/1.1  
  
Request Headers:  
x-ms-version: 2014-02-14  
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT  
x-ms-meta-Category: Images  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=  

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.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann auch zusätzliche HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antwortheader	BESCHREIBUNG
Last-Modified	Gibt das Datum und die Uhrzeit der letzten Änderung der Freigabe zurück. Das Datumsformat entspricht RFC 1123. Weitere Informationen finden Sie unter Darstellung von Datums-/Uhrzeitwerten in Headern. Bei jedem Vorgang, durch den die Freigabe oder deren Eigenschaften geändert werden, wird der Zeitpunkt der letzten Änderung aktualisiert. Vorgänge für Dateien wirken sich nicht auf den Zeitpunkt der letzten Änderung der Freigabe aus.
ETag	Enthält einen Wert, der die Version der Freigabe in Anführungszeichen darstellt.
x-ms-request-id	Identifiziert die durchgeführte Anforderung eindeutig. Sie können ihn verwenden, um probleme mit der Anforderung zu beheben. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
x-ms-version	Gibt die Version von Azure Files an, die zum Ausführen der Anforderung verwendet wurde.
Date oder x-ms-date	Ein UTC-Datums-/Uhrzeitwert, der den Zeitpunkt angibt, zu dem der Dienst die Antwort gesendet hat.
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 höchstens 1.024 sichtbare ASCII-Zeichen umfasst. Wenn der x-ms-client-request-id Header in der Anforderung nicht vorhanden ist, ist dieser Header in der Antwort nicht vorhanden.

Antworttext

Keine.

Authorization

Nur der Kontobesitzer kann diesen Vorgang aufrufen.

Hinweise

Durch aufrufen Set Share Metadata werden alle vorhandenen Metadaten überschrieben, die der Freigabe zugeordnet sind. Es ist nicht möglich, ein einzelnes Name-Wert-Paar zu ändern.

Sie können metadaten für eine Freigabe auch zum Zeitpunkt der Erstellung im Rahmen des Vorgangs Freigabe erstellen festlegen.

Durch aufrufen werden Set Share Metadata die ETag Eigenschaften und Last-Modified-Time für die Freigabe aktualisiert.

Set Share Metadatawird für eine Freigabe Momentaufnahme nicht unterstützt. Ein Versuch, diesen Vorgang für eine Freigabe Momentaufnahme auszuführen, schlägt mit status Code 400 (InvalidQueryParameterValue) fehl. Sie können Metadaten für eine Freigabe Momentaufnahme zum Zeitpunkt ihrer Erstellung im Rahmen des Snapshot Share Vorgangs festlegen.

Weitere Informationen

Vorgänge für FileShare-Ressourcen (Azure Files)