Verzeichnisse und Dateien auflisten

Der vorgang List Directories and Files gibt eine Liste von Dateien oder Verzeichnissen unter der angegebenen Freigabe oder dem angegebenen Verzeichnis zurück. Er listet den Inhalt nur für eine einzelne Ebene der Verzeichnishierarchie auf. 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 List Directories and Files Anforderung wird wie folgt erstellt. Es wird empfohlen, HTTPS zu verwenden.

Ersetzen Sie die pfadkomponenten, die im Anforderungs-URI angezeigt werden, wie folgt:

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

URI-Parameter

Sie können die folgenden zusätzlichen Parameter für den URI angeben.

Allgemeine URI-Parameter

Nur SMB-URI-Parameter

NUR NFS-URI-Parameter

Nichts.

Anforderungsheader

Die erforderlichen und optionalen Anforderungsheader werden in den folgenden Tabellen beschrieben:

Allgemeine Anforderungsheader

Nur SMB-Anforderungsheader

NUR NFS-Anforderungsheader

Nichts.

Anforderungstext

Nichts.

Antwort

Die Antwort enthält einen HTTP-Statuscode, eine Reihe von Antwortheadern und einen Antworttext im XML-Format.

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

Nur SMB-Antwortheader

Nichts.

NUR NFS-Antwortheader

Nichts.

Antworttext

Das Format der XML-Antwort lautet wie folgt.

Die elemente Marker, ShareSnapshotund MaxResults sind nur vorhanden, wenn Sie sie für den Anforderungs-URI angeben. Das NextMarker-Element weist nur dann einen Wert auf, wenn die Listenergebnisse nicht abgeschlossen sind.

Das Content-Length-Element wird in der Auflistung für Dateien zurückgegeben, die die Größe der Datei angibt. Dieser Wert ist jedoch möglicherweise nicht up-to-datum, da ein SMB- oder NFS-Client die Datei möglicherweise lokal geändert hat. Der Wert von Content-Length spiegelt möglicherweise nicht wider, bis der Handle geschlossen wird, oder die SMB-Op-Sperre ist unterbrochen. Um aktuelle Eigenschaftswerte abzurufen, verwenden Sie x-ms-file-extended-info: true für ein Verzeichnis, das in einer Dateifreigabe mit aktiviertem SMB-Protokoll gespeichert ist, oder rufen Sie Abrufen von Dateieigenschaften für die jeweilige Datei auf.

In Den Versionen 2021-12-02 und höher codiert List Directory and Files (pro RFC 2396) alle FileName, DirectoryName, Prefix oder DirectoryPath Elementwerte, die Zeichen enthalten, die in XML ungültig sind (insbesondere U+FFFE oder U+FFFF). Wenn codiert, enthält das Name-, Prefix- oder EnumerationResults-Element ein Encoded=true-Attribut. Dies geschieht nur für die Name-Elementwerte, die die in XML ungültigen Zeichen enthalten, nicht für die verbleibenden Name Elemente in der Antwort.

Antworttext für Dateifreigaben mit aktivierten SMB-Protokoll

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="https://myaccount.file.core.windows.net/" ShareName="myshare" ShareSnapshot="date-time" DirectoryPath="directory-path">  
  <Marker>string-value</Marker>
  <Prefix>string-value</Prefix>
  <MaxResults>int-value</MaxResults>
  <DirectoryId>directory-id</DirectoryId>
  <Entries>
    <File>
      <FileId>file-id</FileId>
      <Name>file-name</Name>  
      <Properties>  
        <Content-Length>size-in-bytes</Content-Length>
        <CreationTime>datetime</CreationTime>
        <LastAccessTime>datetime</LastAccessTime>
        <LastWriteTime>datetime</LastWriteTime>
        <ChangeTime>datetime</ChangeTime>
        <Last-Modified>datetime</Last-Modified>
        <Etag>etag</Etag>
      </Properties>
      <Attributes>Archive|Hidden|Offline|ReadOnly</Attributes>
      <PermissionKey>4066528134148476695*1</PermissionKey>
    </File>  
    <Directory>
      <FileId>file-id</FileId>
      <Name>directory-name</Name>  
      <Properties>
        <CreationTime>datetime</CreationTime>
        <LastAccessTime>datetime</LastAccessTime>
        <LastWriteTime>datetime</LastWriteTime>
        <ChangeTime>datetime</ChangeTime>
        <Last-Modified>datetime</Last-Modified>
        <Etag>etag</Etag>
      </Properties>
      <Attributes>Archive|Hidden|Offline|ReadOnly</Attributes>
      <PermissionKey>4066528134148476695*1</PermissionKey>
    </Directory>  
  </Entries>  
  <NextMarker />  
</EnumerationResults>  

In den Versionen 2020-04-08, 2020-06-12 und 2020-08-04 wird FileId für Dateien und Verzeichnisse zurückgegeben, wenn der Header x-ms-file-extended-info wahr ist. In Version 2020-10-02 und höher wird FileId immer für Dateien und Verzeichnisse zurückgegeben.

In Version 2020-04-08 gibt include={timestamps} die folgenden Zeitstempeleigenschaften zurück: CreationTime, LastAccessTimeund LastWriteTime. In Version 2020-06-12 und höher gibt include={timestamps} die folgenden Zeitstempeleigenschaften zurück: CreationTime, LastAccessTime, LastWriteTime, ChangeTimeund Last-Modified.

In Version 2020-10-02 und höher wird DirectoryId in der Antwort zurückgegeben. Es gibt die FileId des Verzeichnisses an, für das die API aufgerufen wird.

Antworttext für Dateifreigaben mit aktiviertem NFS-Protokoll

<?xml version="1.0" encoding="utf-8"?>
<EnumerationResults ServiceEndpoint="https://myaccount.file.core.windows.net/" ShareName="myshare" ShareSnapshot="date-time" DirectoryPath="directory-path">
  <Marker>string-value</Marker>
  <Prefix>string-value</Prefix>
  <MaxResults>int-value</MaxResults>
  <DirectoryId>directory-id</DirectoryId>
  <Entries>
    <File>
      <FileId>file-id</FileId>
      <Name>file-name</Name>
      <Properties>
        <Content-Length>size-in-bytes</Content-Length>
      </Properties>
    </File>
    <Directory>
      <FileId>file-id</FileId>
      <Name>directory-name</Name>
    </Directory>
  </Entries>
  <NextMarker />
</EnumerationResults>

Datetime-Format und API-Version für Zeitstempelfelder

Ermächtigung

Nur der Kontobesitzer kann diesen Vorgang aufrufen.

Bemerkungen

Der im Content-Length-Element zurückgegebene Wert entspricht dem Wert des x-ms-content-length Headers der Datei.

Jedes zurückgegebene Directory-Element zählt zu dem maximalen Ergebnis, genau wie jedes File Element. Dateien und Verzeichnisse werden in einer lexikalisch sortierten Reihenfolge im Antworttext aufgelistet.

Die Auflistung ist auf eine einzelne Ebene der Verzeichnishierarchie beschränkt. Zum Auflisten mehrerer Ebenen können Sie mehrere Aufrufe iterativ durchführen. Verwenden Sie den von einem Ergebnis zurückgegebenen Directory Wert in einem nachfolgenden Aufruf von List Directories and Files.

Siehe auch

Vorgänge in Verzeichnissen