Freigeben über

Festlegen von Verzeichniseigenschaften

  • Artikel

Der Set Directory Properties-Vorgang legt Systemeigenschaften für das angegebene Verzeichnis fest. Diese API ist ab Version 2019-02-02 verfügbar.

Protokollverfügbarkeit

Aktiviertes Dateifreigabeprotokoll Verfügbar
SMB Ja
NFS Keine

Bitten

Die Set Directory 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/mydirectory?restype=directory&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.
mydirectory 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-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 das Verzeichnis, das im 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 er angegeben ist, muss er über einen Besitzer, eine Gruppe und diskretionäre Zugriffssteuerungsliste (DACL)verfügen. Um einen vorhandenen Wert unverändert zu halten, können Sie einen Wert von preserveübergeben.

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-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 für Versionen 2019-02-02 bis 2021-04-10. Optional für 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 für Versionen 2019-02-02 bis 2021-04-10. Optional für Version 2021-06-08 und höher. Die Utc-Erstellungszeiteigenschaft (Coordinated Universal Time) für ein Verzeichnis. 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 für Versionen 2019-02-02 bis 2021-04-10. Optional für Version 2021-06-08 und höher. Die Utc-Eigenschaft (Coordinated Universal Time, koordinierte Weltzeit) für ein Verzeichnis. Ein Wert von preserve kann übergeben werden, um einen vorhandenen Wert unverändert zu halten. Der Standardwert ist preserve.
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 das Verzeichnis, das 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.

Weitere 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 des Verzeichnisses 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 die anforderung eindeutig, die durchgeführt wurde, und kann verwendet werden, um die Anforderung zu behandeln. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge.
x-ms-version Gibt die Dateidienstversion an, die zum Ausführen der Anforderung verwendet wurde.
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 des Verzeichnisses.
x-ms-file-attributes Version 2019-02-02 und höher. Die Dateisystemattribute im Verzeichnis. 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 das Verzeichnis darstellt.
x-ms-file-last-write-time Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die letzte Schreibzeiteigenschaft für das Verzeichnis darstellt.
x-ms-file-change-time Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die Änderungszeiteigenschaft für das Verzeichnis 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 Ein Schreibgeschütztes Verzeichnis.
Versteckt FILE_ATTRIBUTE_HIDDEN Das Verzeichnis ist ausgeblendet. Sie ist nicht in einer normalen Verzeichnisauflistung enthalten.
System FILE_ATTRIBUTE_SYSTEM Ein Verzeichnis, von dem das Betriebssystem ausschließlich einen Teil oder ausschließlich verwendet.
Nichts FILE_ATTRIBUTE_NORMAL Ein Verzeichnis, das keine anderen Attribute festgelegt hat. Dieses Attribut ist nur gültig, wenn es allein verwendet wird.
Verzeichnis FILE_ATTRIBUTE_DIRECTORY Das Handle, das ein Verzeichnis identifiziert.
Archiv FILE_ATTRIBUTE_ARCHIVE Ein Verzeichnis, das ein Archivverzeichnis ist. Anwendungen verwenden dieses Attribut in der Regel, um Dateien für die Sicherung oder Entfernung zu markieren.
Offline FILE_ATTRIBUTE_OFFLINE Die Daten eines Verzeichnisses 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 Das Verzeichnis 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

Set Directory 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.

Eigenschaften, die für ein Verzeichnis mit Set Directory Properties festgelegt sind, werden nicht an Unterverzeichnisse unter diesem Verzeichnis weitergegeben. Sie müssen Set Directory Properties für jedes Verzeichnis aufrufen, für das Sie Eigenschaften aktualisieren möchten.

Siehe auch

Vorgänge in Verzeichnissen