Festlegen von Dateieigenschaften
Der Set File Properties-Vorgang legt Systemeigenschaften für die Datei fest.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| SMB |
|
| NFS |
|
Bitten
Die Set File Properties Anforderung kann wie folgt erstellt werden. Es wird empfohlen, HTTPS zu verwenden.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| STELLEN | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties |
HTTP/1.1 |
Ersetzen Sie die pfadkomponenten, die im Anforderungs-URI angezeigt werden, wie folgt:
| Pfadkomponente | Beschreibung |
|---|---|
myaccount |
Der Name Ihres Speicherkontos. |
myshare |
Der Name Ihrer Dateifreigabe. |
mydirectorypath |
Wahlfrei. Der Pfad zum übergeordneten Verzeichnis. |
myfile |
Der Name der Datei. |
Informationen zu Pfadbenennungseinschränkungen finden Sie unter Namen- und Referenzfreigaben, Verzeichnisse, Dateien und Metadaten.
URI-Parameter
Sie können die folgenden zusätzlichen Parameter im Anforderungs-URI angeben:
| Parameter | Beschreibung |
|---|---|
timeout |
Wahlfrei. Der parameter timeout wird in Sekunden ausgedrückt. Weitere Informationen finden Sie unter Festlegen von Timeouts für Dateidienstvorgänge. |
Anforderungsheader
Die erforderlichen und optionalen Anforderungsheader werden in der folgenden Tabelle 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 (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 Vorgangs an, der für diese Anforderung verwendet werden soll. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure Storage-Dienste. |
x-ms-cache-control |
Wahlfrei. Ändert die Cachesteuerelementzeichenfolge für die Datei. Wenn diese Eigenschaft für die Anforderung nicht angegeben ist, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Abrufen von Dateieigenschaften geben diese Eigenschaft nicht zurück, es sei denn, sie wird explizit für die Datei erneut festgelegt. |
x-ms-content-type |
Wahlfrei. Legt den Inhaltstyp der Datei fest. Wenn diese Eigenschaft für die Anforderung nicht angegeben ist, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Abrufen von Dateieigenschaften geben diese Eigenschaft nicht zurück, es sei denn, sie wird explizit für die Datei erneut festgelegt. |
x-ms-content-md5 |
Wahlfrei. Legt den MD5-Hash der Datei fest. Wenn diese Eigenschaft für die Anforderung nicht angegeben ist, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Abrufen von Dateieigenschaften geben diese Eigenschaft nicht zurück, es sei denn, sie wird explizit für die Datei erneut festgelegt. |
x-ms-content-encoding |
Wahlfrei. Legt die Inhaltscodierung der Datei fest. Wenn diese Eigenschaft für die Anforderung nicht angegeben ist, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Abrufen von Dateieigenschaften geben diese Eigenschaft nicht zurück, es sei denn, sie wird explizit für die Datei erneut festgelegt. |
x-ms-content-language |
Wahlfrei. Legt die Inhaltssprache der Datei fest. Wenn diese Eigenschaft für die Anforderung nicht angegeben ist, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Abrufen von Dateieigenschaften geben diese Eigenschaft nicht zurück, es sei denn, sie wird explizit für die Datei erneut festgelegt. |
x-ms-content-disposition |
Wahlfrei. Legt den Content-Disposition Header der Datei fest.Wenn diese Eigenschaft für die Anforderung nicht angegeben ist, wird die Eigenschaft für die Datei gelöscht. Nachfolgende Aufrufe von Abrufen von Dateieigenschaften geben diese Eigenschaft nicht zurück, es sei denn, sie wird explizit für die Datei erneut festgelegt. |
x-ms-content-length: bytes |
Wahlfrei. Ändert die Größe einer Datei auf die angegebene Größe. Wenn der angegebene Bytewert kleiner als die aktuelle Größe der Datei ist, werden alle Bereiche oberhalb des angegebenen Bytewerts gelöscht. |
x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> } |
In Den Versionen 2019-02-02 bis 2021-04-10 ist dieser Header erforderlich, wenn x-ms-file-permission-key nicht angegeben ist. Ab Version 2021-06-08 sind beide Header optional. Diese Berechtigung ist der Sicherheitsdeskriptor für die Datei, die in der Security Descriptor Definition Language (SDDL) oder (Version 2024-11-04 oder höher) im base64-codierten binären Sicherheitsdeskriptorformatangegeben ist. Sie können angeben, welches Format mit der x-ms-file-permission-format Kopfzeile verwendet werden soll. Sie können diesen Header verwenden, wenn die Berechtigungsgröße 8 Kibibyte (KiB) oder weniger beträgt. Andernfalls können Sie x-ms-file-permission-keyverwenden. Wenn angegeben, muss sie über einen Besitzer, eine Gruppe und diskretionäre Zugriffssteuerungsliste (DACL)verfügen. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten.Hinweis: Sie können entweder x-ms-file-permission oder x-ms-file-permission-keyangeben. Wenn keines der Kopfzeilen angegeben ist, wird der Standardwert von preserve verwendet. |
x-ms-file-permission-format: { sddl ¦ binary } |
Wahlfrei. Version 2024-11-04 oder höher. Gibt an, ob sich der in x-ms-file-permission übergebene Wert in SDDL oder im Binärformat befindet. Wenn x-ms-file-permission-key auf preservefestgelegt ist, sollte diese Kopfzeile nicht festgelegt werden. Wenn x-ms-file-permission-key auf einen anderen Wert als preservefestgelegt ist und wenn dieser Header nicht festgelegt ist, wird der Standardwert sddl verwendet. |
x-ms-file-permission-key: <PermissionKey> |
In Den Versionen 2019-02-02 bis 2021-04-10 ist dieser Header erforderlich, wenn x-ms-file-permission nicht angegeben ist. Ab Version 2021-06-08 sind beide Header optional. Der Schlüssel der Berechtigung, die für die Datei festgelegt werden soll. Dies kann mithilfe der Create-Permission-API erstellt werden.Hinweis: Sie können entweder x-ms-file-permission oder x-ms-file-permission-keyangeben. Wenn keines der Kopfzeilen angegeben ist, wird der Standardwert von preserve für die x-ms-file-permission Kopfzeile verwendet. |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
Erforderlich, Version 2019-02-02 bis 2021-04-10. Optional, Version 2021-06-08 und höher. Die Dateisystemattribute, die für die Datei festgelegt werden sollen. Sehen Sie sich die Liste der verfügbaren Attributean. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten. Der Standardwert ist preserve. |
x-ms-file-creation-time: { preserve ¦ <DateTime> } |
Erforderlich, Version 2019-02-02 bis 2021-04-10. Optional, Version 2021-06-08 und höher. Die Utc-Erstellungszeiteigenschaft (Coordinated Universal Time) für eine Datei. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten. Der Standardwert ist preserve. |
x-ms-file-last-write-time: { preserve ¦ <DateTime> } |
Erforderlich, Version 2019-02-02 bis 2021-04-10. Optional, Version 2021-06-08 und höher. Die utc-Eigenschaft (Coordinated Universal Time) für die letzte Schreibeigenschaft für eine Datei. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten. Wenn preserve angegeben ist und die Größe der Datei geändert wird, wird die letzte Schreibzeit auf die aktuelle Uhrzeit aktualisiert. Wenn die Größe der Datei geändert wird, aber ein expliziter Zeitstempel angegeben wird, wird der explizite Zeitstempel verwendet. Der Standardwert ist preserve. |
x-ms-lease-id: <ID> |
Erforderlich, wenn die Datei über eine aktive Lease verfügt. Verfügbar für Version 2019-02-02 und höher. |
x-ms-client-request-id |
Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, der in den Protokollen aufgezeichnet wird, wenn die Protokollierung konfiguriert ist. 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 von Azure Files. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Wahlfrei. Version 2021-06-08 und höher. Die UTC-Eigenschaft (Coordinated Universal Time) ändert die Zeiteigenschaft für die Datei, die im ISO 8601-Format formatiert ist. Sie können einen Wert von now verwenden, um den Zeitpunkt der Anforderung anzugeben. Der Standardwert ist now. |
x-ms-file-request-intent |
Erforderlich, wenn Authorization Header ein OAuth-Token angibt. Zulässiger Wert ist backup. Dieser Header gibt an, dass die Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action oder Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action gewährt werden sollen, wenn sie in der RBAC-Richtlinie enthalten sind, die der Identität zugewiesen ist, die mithilfe des Authorization-Headers autorisiert ist. Verfügbar für Version 2022-11-02 und höher. |
x-ms-allow-trailing-dot: { <Boolean> } |
Wahlfrei. Version 2022-11-02 und höher. Der boolesche Wert gibt an, ob ein nachgestellter Punkt in der Anforderungs-URL gekürzt werden soll. Weitere Informationen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten. |
Anforderungstext
Nichts.
Antwort
Die Antwort enthält einen HTTP-Statuscode und eine Reihe von Antwortheadern.
Statuscode
Ein erfolgreicher Vorgang gibt den Statuscode 200 (OK) zurück.
Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.
Antwortheader
Die Antwort für diesen Vorgang enthält die folgenden Header. Die Antwort kann auch zusätzliche Standard-HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.
| Antwortheader | Beschreibung |
|---|---|
ETag |
Enthält einen Wert, der die Version der Datei darstellt. Der Wert wird in Anführungszeichen eingeschlossen. |
Last-Modified |
Gibt das Datum und die Uhrzeit der letzten Änderung der Datei zurück. Das Datumsformat folgt RFC 1123. Weitere Informationen finden Sie unter Darstellen von Datums-/Uhrzeitwerten in Kopfzeilen. Jeder Vorgang, der das Verzeichnis oder seine Eigenschaften ändert, aktualisiert die Uhrzeit der letzten Änderung. Vorgänge für Dateien wirken sich nicht auf die Uhrzeit der letzten Änderung des Verzeichnisses aus. |
x-ms-request-id |
Identifiziert eindeutig die Anforderung, die durchgeführt wurde, und kann zur Problembehandlung der Anforderung verwendet werden. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge. |
x-ms-version |
Gibt die Version des Dateidiensts an, der zum Ausführen der Anforderung verwendet wird. |
Date oder x-ms-date |
Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. |
x-ms-request-server-encrypted: true/false |
Version 2017-04-17 und höher. Der Wert dieses Headers wird auf true festgelegt, wenn der Inhalt der Anforderung mithilfe des angegebenen Algorithmus erfolgreich verschlüsselt wird. Andernfalls wird der Wert auf falsefestgelegt. |
x-ms-file-permission-key |
Version 2019-02-02 und höher. Der Schlüssel der Berechtigung der Datei. |
x-ms-file-attributes |
Version 2019-02-02 und höher. Die Dateisystemattribute in der Datei. Weitere Informationen finden Sie in der Liste der verfügbaren Attribute. |
x-ms-file-creation-time |
Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die Erstellungszeiteigenschaft für die Datei darstellt. |
x-ms-file-last-write-time |
Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die letzte Schreibzeiteigenschaft für die Datei darstellt. |
x-ms-file-change-time |
Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die Änderungszeiteigenschaft für die Datei darstellt. |
x-ms-client-request-id |
Kann verwendet werden, um Anfragen und entsprechende Antworten zu behandeln. 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
Nichts.
Ermächtigung
Nur der Kontobesitzer kann diesen Vorgang aufrufen.
Dateisystemattribute
| Attribut | Win32-Dateiattribute | Definition |
|---|---|---|
| ReadOnly | FILE_ATTRIBUTE_READONLY | Eine Datei, die schreibgeschützt ist. Anwendungen können die Datei lesen, aber nicht in die Datei schreiben oder löschen. |
| Versteckt | FILE_ATTRIBUTE_HIDDEN | Die Datei ist ausgeblendet. Sie ist nicht in einer normalen Verzeichnisauflistung enthalten. |
| System | FILE_ATTRIBUTE_SYSTEM | Eine Datei, von der das Betriebssystem ausschließlich einen Teil oder ausschließlich verwendet. |
| Nichts | FILE_ATTRIBUTE_NORMAL | Eine Datei, die keine anderen Attribute festgelegt hat. Dieses Attribut ist nur gültig, wenn es allein verwendet wird. |
| Archiv | FILE_ATTRIBUTE_ARCHIVE | Eine Datei, die eine Archivdatei ist. Anwendungen verwenden dieses Attribut normalerweise, um Dateien für die Sicherung oder Entfernung zu markieren. |
| Vorläufig | FILE_ATTRIBUTE_TEMPORARY | Eine Datei, die für temporären Speicher verwendet wird. |
| Offline | FILE_ATTRIBUTE_OFFLINE | Die Daten einer Datei sind nicht sofort verfügbar. Dieses Dateisystem-Attribut wird in erster Linie zur Bereitstellung der Kompatibilität mit Windows dargestellt. Azure Files unterstützt keine Offlinespeicheroptionen. |
| NotContentIndexed | FILE_ATTRIBUTE_NOT_CONTENT_INDEXED | Die Datei muss nicht vom Inhaltsindizierungsdienst indiziert werden. |
| NoScrubData | FILE_ATTRIBUTE_NO_SCRUB_DATA | Der Benutzerdatenstrom muss nicht vom Hintergrunddatenintegritätsscanner gelesen werden. Dieses Dateisystem-Attribut wird in erster Linie zur Bereitstellung der Kompatibilität mit Windows dargestellt. |
Bemerkungen
Die Semantik zum Aktualisieren der Eigenschaften einer Datei lautet wie folgt:
Die Größe einer Datei wird nur geändert, wenn die Anforderung einen Wert für den header
x-ms-content-lengthangibt.Wenn eine Anforderung nur
x-ms-content-lengthund keine anderen Eigenschaften festlegt, werden keine anderen Eigenschaften der Datei geändert.Wenn eine oder mehrere der folgenden Eigenschaften in der Anforderung festgelegt werden, werden alle diese Eigenschaften zusammen festgelegt. Wenn für eine angegebene Eigenschaft kein Wert bereitgestellt wird, wenn mindestens eine der folgenden Eigenschaften festgelegt wird, wird diese Eigenschaft für die Datei gelöscht.
x-ms-cache-controlx-ms-content-typex-ms-content-md5x-ms-content-encodingx-ms-content-language
Anmerkung
Die vorherigen Dateieigenschaften sind von den Dateisystemeigenschaften getrennt, die für SMB-Clients verfügbar sind. SMB-Clients können diese Eigenschaftswerte nicht lesen, schreiben oder ändern.
Set File properties wird für eine Freigabemomentaufnahme nicht unterstützt, bei der es sich um eine schreibgeschützte Kopie einer Freigabe handelt. Ein Versuch, diesen Vorgang für eine Freigabemomentaufnahme auszuführen, schlägt mit 400 (InvalidQueryParameterValue) fehl.
Wenn die Datei über eine aktive Lease verfügt, muss der Client eine gültige Lease-ID für die Anforderung angeben, um Eigenschaften in die Datei zu schreiben. Wenn der Client keine Lease-ID angibt oder eine ungültige Lease-ID angibt, gibt der Dateidienst den Statuscode 412 zurück (Vorbedingung fehlgeschlagen). Wenn der Client eine Lease-ID angibt, die Datei aber nicht über eine aktive Lease verfügt, gibt der Dateidienst auch den Statuscode 412 zurück (Vorbedingung fehlgeschlagen).