Freigeben über

Dateieigenschaften abrufen

  • Artikel

Der vorgang Get File Properties gibt alle benutzerdefinierten Metadaten, Standard-HTTP-Eigenschaften und Systemeigenschaften für die Datei zurück. Der Inhalt der Datei wird nicht zurückgegeben. 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 Ja
NFS Ja

Bitten

Die Get File Properties Anforderung wird wie folgt erstellt. Es wird empfohlen, HTTPS zu verwenden.

Methode Anforderungs-URI HTTP-Version
HEAD https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile HTTP/1.1
HEAD https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?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.
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

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 Dateieigenschaften 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
Ermächtigung 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-lease-id:<ID> Wahlfrei. Version 2019-02-02 und höher. Wenn der Header angegeben ist, wird der Vorgang nur ausgeführt, wenn die Lease der Datei aktuell aktiv ist und die in der Anforderung angegebene Lease-ID mit der Lease-ID der Datei übereinstimmt. Wenn sie nicht übereinstimmen, schlägt der Vorgang mit dem Statuscode 412 fehl (Vorbedingung fehlgeschlagen).

Dieser Header wird ignoriert, wenn sich die Datei auf einer Dateifreigabe mit aktiviertem NFS-Protokoll befindet, was keine Dateileases unterstützt.
x-ms-client-request-id Wahlfrei. Stellt einen vom Client generierten, undurchsichtigen Wert mit einem 1-Kibibyte-Zeichenlimit (KiB) bereit, der in den Analyseprotokollen aufgezeichnet wird, wenn die Azure Storage Analytics-Protokollierung aktiviert ist. Es wird dringend empfohlen, diesen Header zu verwenden, wenn Sie clientseitige Aktivitäten mit Anforderungen korrelieren, die vom Server empfangen werden. Weitere Informationen finden Sie unter Überwachen von Azure Blob Storage.
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.

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
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 die Datei oder die zugehörigen Eigenschaften ändert, aktualisiert den Zeitpunkt der letzten Änderung.
x-ms-meta-name:value Eine Gruppe von Name-Wert-Paaren, die dieser Datei als benutzerdefinierte Metadaten zugeordnet sind.
x-ms-type: <File> Gibt den Typ Filezurück. Reserviert für die zukünftige Verwendung.
Content-Length Die Größe der Datei in Byte. Dieser Header gibt den Wert des x-ms-content-length Headers zurück, der mit der Datei gespeichert ist.
Content-Type Der für die Datei angegebene Inhaltstyp. Wenn kein Inhaltstyp angegeben ist, wird der Standardinhaltstyp application/octet-stream.
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.
Content-MD5 Wenn der Content-MD5 Header für die Datei festgelegt wurde, wird der Content-MD5 Antwortheader zurückgegeben, sodass der Client auf die Nachrichteninhaltsintegrität überprüfen kann.
Content-Encoding Wenn der Content-Encoding Anforderungsheader zuvor für die Datei festgelegt wurde, wird der Content-Encoding Wert in diesem Header zurückgegeben.
Content-Language Wenn der Content-Language Anforderungsheader zuvor für die Datei festgelegt wurde, wird der Content-Language Wert in diesem Header zurückgegeben.
Cache-Control Wenn der Cache-Control Anforderungsheader zuvor für die Datei festgelegt wurde, wird der Cache-Control Wert in diesem Header zurückgegeben.
Content-Disposition Gibt den Wert zurück, der für den x-ms-content-disposition-Header angegeben wurde, und gibt an, wie die Antwort verarbeitet werden soll.

Das feld Content-Disposition Antwortheader vermittelt zusätzliche Informationen zum Verarbeiten der Antwortnutzlast, und Sie können es verwenden, um zusätzliche Metadaten anzufügen. Wenn sie beispielsweise auf attachmentfestgelegt ist, gibt Content-Disposition an, dass der Benutzer-Agent die Antwort nicht anzeigen sollte, sondern stattdessen ein Fenster "Speichern unter" anzeigen sollte.
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 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-copy-completion-time:<datetime> Version 2015-02-21 und höher. Die Schlussfolgerungszeit des letzten versuchten Operation "Datei kopieren", bei dem diese Datei die Zieldatei war. Dieser Wert kann den Zeitpunkt eines abgeschlossenen, abgebrochenen oder fehlgeschlagenen Kopierversuchs angeben. Dieser Header wird nicht angezeigt, wenn eine Kopie aussteht, wenn diese Datei nie das Ziel in einem Vorgang "Datei kopieren" war oder wenn diese Datei nach einem abgeschlossenen Vorgang zum Kopieren durch Verwenden Festlegen von Dateieigenschaften oder Erstellen von Dateigeändert wurde.
x-ms-copy-status-description: <error string> Version 2015-02-21 und höher. Wird nur angezeigt, wenn x-ms-copy-statusfehlgeschlagen ist, oder ausstehende. Es beschreibt die Ursache eines schwerwiegenden oder nicht schwerwiegenden Kopiervorgangsfehlers. Dieser Header wird nicht angezeigt, wenn eine Kopie aussteht, wenn diese Datei nie das Ziel in einem Vorgang "Datei kopieren" war oder wenn diese Datei nach einem abgeschlossenen Vorgang zum Kopieren durch Verwenden Festlegen von Dateieigenschaften oder Erstellen von Dateigeändert wurde.
x-ms-copy-id: <id> Version 2015-02-21 und höher. Der Zeichenfolgenbezeichner für den zuletzt versuchten Vorgang "Datei kopieren", bei dem es sich bei dieser Datei um die Zieldatei handelte. Dieser Header wird nicht angezeigt, wenn diese Datei noch nie das Ziel in einem -Vorgang "Datei kopieren" war oder wenn diese Datei nach einem abgeschlossenen Vorgang "Datei kopieren" durch Verwenden Festlegen von Dateieigenschaften oder Erstellen einer Dateigeändert wurde.
x-ms-copy-progress: <bytes copied/bytes total> Version 2015-02-21 und höher. Enthält die Anzahl der kopierten Bytes und die Gesamtzahl der Bytes in der Quelle im letzten Versuch, Datei kopieren Vorgang, bei dem diese Datei die Zieldatei war. Kann zwischen 0 und der Anzahl der kopierten Content-Length Bytes angezeigt werden. Dieser Header wird nicht angezeigt, wenn diese Datei noch nie das Ziel in einem -Vorgang "Datei kopieren" war oder wenn diese Datei nach einem abgeschlossenen Vorgang "Datei kopieren" durch Verwenden Festlegen von Dateieigenschaften oder Erstellen einer Dateigeändert wurde.
x-ms-copy-source: url Version 2015-02-21 und höher. Eine URL von bis zu 2 KB Zeichen, die die Quelldatei angibt, die beim letzten Versuch verwendet wurde, Datei kopieren Vorgang, bei dem diese Datei die Zieldatei war. Dieser Header wird nicht angezeigt, wenn diese Datei noch nie das Ziel in einem -Vorgang "Datei kopieren" war oder wenn diese Datei nach einem abgeschlossenen Vorgang "Datei kopieren" durch Verwenden Festlegen von Dateieigenschaften oder Erstellen einer Dateigeändert wurde.
x-ms-copy-status: <pending ¦ success ¦ aborted ¦ failed> Version 2015-02-21 und höher. Der Zustand des Kopiervorgangs, der durch x-ms-copy-ididentifiziert wird, mit den folgenden Werten:

- Erfolg: Kopie erfolgreich abgeschlossen.
- ausstehend: Kopieren wird ausgeführt. Überprüfen Sie x-ms-copy-status-description, wenn vorübergehende, nicht schwerwiegende Fehler den Kopierfortschritt behindern, aber keinen Fehler verursachen.
- abgebrochen: Kopie wurde durch Abgebrochene Kopiebeendet.
fehler beim - : fehler beim Kopieren. Details zu Fehlern finden Sie unter x-ms-copy-status-description.

Dieser Header wird nicht angezeigt, wenn diese Datei noch nie das Ziel in einem -Vorgang "Datei kopieren" war oder wenn diese Datei nach einem abgeschlossenen Vorgang "Datei kopieren" durch Verwenden Festlegen von Dateieigenschaften oder Erstellen einer Dateigeändert wurde.
x-ms-server-encrypted: true/false Version 2017-04-17 und höher. Der Wert dieses Headers wird auf true festgelegt, wenn die Dateidaten und Anwendungsmetadaten vollständig mithilfe des angegebenen Algorithmus verschlüsselt werden. Der Wert wird auf false festgelegt, wenn die Datei unverschlüsselt ist oder nur Teile der Datei- oder Anwendungsmetadaten verschlüsselt sind.
x-ms-file-creation-time Version 2019-02-02 und höher. Der UTC-Datums-/Uhrzeitwert, der die Erstellungszeiteigenschaft für eine 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-file-file-id Version 2019-02-02 und höher. Die Datei-ID der Datei.
x-ms-file-parent-id Version 2019-02-02 und höher. Die übergeordnete Datei-ID der Datei.
x-ms-lease-duration:infinite Version 2019-02-02 und höher. Wenn eine Datei geleast wird, gibt sie an, dass die Lease unendlich lange ist.
x-ms-lease-state:<available;leased;broken> Version 2019-02-02 und höher. Wenn eine Datei leaset wird, gibt sie den Leasestatus der Datei an.
x-ms-lease-status:<locked;unlocked> Version 2019-02-02 und höher. Wenn eine Datei leaset wird, gibt sie den Leasestatus der Datei an.
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.

Nur SMB-Antwortheader

Antwortheader Beschreibung
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 der Datei. 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 der Datei. Siehe POSIX Dateiberechtigungen (Modus).
x-ms-owner Version 2025-05-05 und höher. Der Benutzerbezeichner (UID) des Dateibesitzers.
x-ms-group Version 2025-05-05 und höher. Der Gruppenbezeichner (GID) des Dateibesitzers.
x-ms-link-count Version 2025-05-05 und höher. Die Anzahl der Verknüpfungen der Datei.
x-ms-file-file-type Version 2025-05-05 und höher. Der Typ der Datei, die möglichen Werte sind: Regular, Symlink.

Antworttext

Nichts.

Beispielantwort

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-type: File  
x-ms-meta-m1: v1  
x-ms-meta-m2: v2  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CB171DBEAD6A6B"  
Last-Modified: <date>  
x-ms-version: 2019-02-02  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0  
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6  
x-ms-copy-source: <url>  
x-ms-copy-status: success  
x-ms-copy-progress: 11/11  
x-ms-copy-completion-time: <date>  
x-ms-lease-duration: infinite   
x-ms-lease-state: leased 
x-ms-lease-status: locked

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.

Siehe auch

Vorgänge für Dateien