Verzeichniseigenschaften abrufen
Der vorgang Get Directory Properties gibt alle Systemeigenschaften für das angegebene Verzeichnis zurück und kann auch verwendet werden, um das Vorhandensein eines Verzeichnisses zu überprüfen. Die zurückgegebenen Daten enthalten nicht die Dateien im Verzeichnis oder in allen Unterverzeichnissen. Dieser Vorgang wird in Version 2025-05-05 und höher für Dateifreigaben mit aktiviertem NFS-Protokoll unterstützt.
Protokollverfügbarkeit
| Aktiviertes Dateifreigabeprotokoll | Verfügbar |
|---|---|
| SMB |
|
| NFS |
|
Bitten
Die Get Directory Properties Anforderung wird wie folgt erstellt. Es wird empfohlen, HTTPS zu verwenden.
| Methode | Anforderungs-URI | HTTP-Version |
|---|---|---|
| GET/HEAD | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
| GET/HEAD | https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
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. |
myparentdirectorypath |
Wahlfrei. Der Pfad zum übergeordneten Verzeichnis. |
mydirectory |
Der Name des Verzeichnisses. |
Informationen zu Pfadbenennungseinschränkungen finden Sie unter Namen- und Referenzfreigaben, Verzeichnisse, Dateien und Metadaten.
URI-Parameter
Die folgenden zusätzlichen Parameter können für den Anforderungs-URI angegeben werden:
| Parameter | Beschreibung |
|---|---|
sharesnapshot |
Wahlfrei. Version 2017-04-17 und höher. Der sharesnapshot-Parameter ist ein undurchsichtiger DateTime-Wert, der, wenn vorhanden, die Freigabemomentaufnahme angibt, um die Verzeichniseigenschaften abzufragen. |
timeout |
Wahlfrei. Der parameter timeout wird in Sekunden ausgedrückt. Weitere Informationen finden Sie unter Festlegen von Timeouts für Azure Files-Vorgänge. |
Anforderungsheader
Die erforderlichen und optionalen Anforderungsheader werden in den folgenden Tabellen beschrieben:
Allgemeine Anforderungsheader
| 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. Dieser Vorgang wird in Version 2025-05-05 und höher für Dateifreigaben mit aktiviertem NFS-Protokoll unterstützt. Weitere Informationen finden Sie unter Versionsverwaltung für die Azure Storage-Dienste. |
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-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. Dieser Header wird ignoriert, wenn sich das Ziel auf einer Dateifreigabe mit aktiviertem NFS-Protokoll befindet, das den nachfolgenden Punkt standardmäßig unterstützt. Weitere Informationen finden Sie unter Benennen und Verweisen auf Freigaben, Verzeichnisse, Dateien und Metadaten. |
Nur SMB-Anforderungsheader
Nichts.
NUR NFS-Anforderungsheader
Nichts.
Anforderungstext
Nichts.
Beispielanforderung
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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 Kopfzeilen in den folgenden Tabellen. Die Antwort kann auch zusätzliche Standard-HTTP-Header enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.
Allgemeine Antwortheader
| Antwortheader | Beschreibung |
|---|---|
ETag |
Das ETag enthält einen Wert, den Sie zum bedingten Ausführen von Vorgängen verwenden können. 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. Vorgänge in Dateien innerhalb des Verzeichnisses wirken sich nicht auf die Uhrzeit der letzten Änderung des Verzeichnisses aus. |
x-ms-meta-name:value |
Eine Gruppe von Name-Wert-Paaren, die Metadaten für das Verzeichnis enthalten. |
x-ms-request-id |
Gibt den eindeutigen Bezeichner der Anforderung zurück, der Ihnen bei der Problembehandlung bei der Anforderung helfen kann. Weitere Informationen finden Sie unter Problembehandlung für API-Vorgänge. |
x-ms-version |
Gibt die Dienstversion an, die zum Ausführen der Anforderung verwendet wurde. |
Date |
Ein UTC-Datums-/Uhrzeitwert, der vom Dienst generiert wird, der die Uhrzeit angibt, zu der die Antwort initiiert wurde. |
x-ms-server-encrypted: true/false |
Version 2017-04-17 und höher. Der Wert dieses Headers wird auf true festgelegt, wenn die Verzeichnismetadaten mit dem angegebenen Algorithmus vollständig verschlüsselt sind. Wenn die Metadaten nicht verschlüsselt sind, wird der Wert auf falsefestgelegt. |
x-ms-file-creation-time |
Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die Erstellungszeiteigenschaft für ein 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-file-file-id |
Version 2019-02-02 und höher. Die Datei-ID des Verzeichnisses. |
x-ms-file-parent-id |
Version 2019-02-02 und höher. Die übergeordnete Datei-ID des Verzeichnisses. |
x-ms-client-request-id |
Kann verwendet werden, um Anfragen und die entsprechenden 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. |
Nur SMB-Antwortheader
| Antwortheader | Beschreibung |
|---|---|
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. |
NUR NFS-Antwortheader
| Antwortheader | Beschreibung |
|---|---|
x-ms-mode |
Version 2025-05-05 und höher. Der Modus des Verzeichnisses. Siehe POSIX Dateiberechtigungen (Modus). |
x-ms-owner |
Version 2025-05-05 und höher. Der Benutzerbezeichner (UID) des Verzeichnisbesitzers. |
x-ms-group |
Version 2025-05-05 und höher. Der Gruppenbezeichner (GID) des Verzeichnisbesitzers. |
x-ms-file-file-type |
Version 2025-05-05 und höher. Der Typ der Datei, die möglichen Werte sind: Directory. |
Antworttext
Nichts.
Beispielantwort
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
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. |
POSIX-Dateiberechtigungen (Modus)
POSIX-Dateiberechtigungen können numerisch in einem 12-Bit-Numerischen Oktalformat oder in einem symbolischen "rwx"-Format angegeben werden. Beispiele:
- "0644" oder "rw-r-r---": Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreibberechtigungen. Gruppe verfügt über Leseberechtigungen. Andere Personen verfügen über Leseberechtigungen.
- "0755" oder "rwxr-xr-x": Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreib- und Ausführungsberechtigungen. Die Gruppe verfügt über Lese- und Ausführungsberechtigungen. Andere Haben Lese- und Ausführungsberechtigungen.
Numerisches oktales Format
Die drei niedrigsten oktalen Zahlen der Reihenfolge stellen die Berechtigungen für Besitzer/Benutzer, Gruppe und andere dar und werden mit einer oktalen Zahl (0-7) angegeben, die mit einer bitweisen Kombination von "4" (Lesen), "2" (Schreiben), "1" (Ausführen) gebildet wird. Die höchste Oktale Zahl (0-7) wird verwendet, um eine Kombination von '4' (SetUID), '2' (SetGID), '1' (StickyBit)-Berechtigungen anzugeben.
| Format | Erlaubnis |
|---|---|
| 0700 | Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreib- und Ausführungsberechtigungen. |
| 0400 | Der Benutzer verfügt über Leseberechtigungen. |
| 0200 | Der Benutzer verfügt über Schreibberechtigungen. |
| 0100 | Der Benutzer hat die Berechtigung "Ausführen". |
| 0070 | Die Gruppe verfügt über Lese-, Schreib- und Ausführungsberechtigungen. |
| 0040 | Gruppe verfügt über Leseberechtigungen. |
| 0020 | Gruppe verfügt über Schreibberechtigungen. |
| 0010 | Die Gruppe hat die Berechtigung "Ausführen". |
| 0007 | Andere verfügen über Lese-, Schreib- und Ausführungsberechtigungen. |
| 0004 | Andere Personen verfügen über Leseberechtigungen. |
| 0002 | Andere verfügen über Schreibberechtigungen. |
| 0001 | Andere haben die Berechtigung zum Ausführen. |
| 4000 | Legen Sie die effektive Benutzer-ID für die Datei fest. |
| 2000 | Legen Sie die effektive Gruppen-ID für die Datei fest. |
| 1000 | Legen Sie fest, dass die Datei gelöscht oder nur vom Dateibesitzer, Verzeichnisbesitzer oder Stammbenutzer umbenannt werden kann. |
Symbolisches "rwx"-Format
Berechtigungen für Besitzer/Benutzer, Gruppen und andere werden mithilfe einer Kombination von Zeichen "r" (Lesen), "w" (Schreiben) und "x" (Execute) angegeben.
| Format | Erlaubnis |
|---|---|
| rwx------ | Der Benutzer (Dateibesitzer) verfügt über Lese-, Schreib- und Ausführungsberechtigungen. |
| r-------- | Der Benutzer verfügt über Leseberechtigungen. |
| -w------- | Der Benutzer verfügt über Schreibberechtigungen. |
| --x------ | Der Benutzer hat die Berechtigung "Ausführen". |
| ---rwx--- | Die Gruppe verfügt über Lese-, Schreib- und Ausführungsberechtigungen. |
| ---r----- | Gruppe verfügt über Leseberechtigungen. |
| ----w---- | Gruppe verfügt über Schreibberechtigungen. |
| -----x--- | Die Gruppe hat die Berechtigung "Ausführen". |
| ------rwx | Andere verfügen über Lese-, Schreib- und Ausführungsberechtigungen. |
| ------r-- | Andere Personen verfügen über Leseberechtigungen. |
| -------w- | Andere verfügen über Schreibberechtigungen. |
| --------x | Andere haben die Berechtigung zum Ausführen. |
Bemerkungen
Wenn der angegebene Verzeichnispfad nicht vorhanden ist, schlägt die Anforderung mit dem Statuscode 404 (Nicht gefunden) fehl.