Auflisten von Verzeichnissen und Dateien

Der List Directories and Files-Vorgang gibt eine Liste der Dateien oder Verzeichnisse unter der angegebenen Freigabe oder dem angegebenen Verzeichnis zurück. Er führt die Inhalte nur für eine einzelne Ebene der Verzeichnishierarchie auf.

Protokollverfügbarkeit

Aktiviertes Dateifreigabeprotokoll	Verfügbar
SMB
NFS

Anforderung

Sie können die List Directories and Files Anforderung wie folgt erstellen. HTTPS wird empfohlen.

Ersetzen Sie die im Anforderungs-URI angezeigten Pfadkomponenten wie folgt durch Ihre eigenen Angaben:

Ausführliche Informationen zu Einschränkungen bei der Pfadbenennung 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.

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungstext

Keine.

Antwort

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

Statuscode

Bei einem erfolgreichen Vorgang wird der Statuscode 200 (OK) zurückgegeben. Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Die Antwort für diesen Vorgang umfasst die folgenden Header. Die Antwort kann auch zusätzliche HTTP-Standardheader enthalten. Alle Standardheader entsprechen der HTTP/1.1-Protokollspezifikation.

Antworttext

Die XML-Antwort weist das folgende Format auf:

Beachten Sie, dass die MarkerElemente , ShareSnapshotund MaxResults nur vorhanden sind, wenn Sie sie im Anforderungs-URI angeben. Das NextMarker Element verfügt nur dann über einen Wert, wenn die Listenergebnisse nicht vollständig sind.

<?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>  

Beachten Sie, dass das Element Content-Length in der Liste zurückgegeben wird. Dieser Wert ist jedoch möglicherweise nicht auf dem neuesten Stand, da die Datei möglicherweise von einem SMB-Client lokal geändert wurde. Der Wert von Content-Length spiegelt diese Tatsache möglicherweise erst wider, wenn der Handle geschlossen oder die Betriebssperre unterbrochen ist. Um aktuelle Eigenschaftswerte abzurufen, verwenden Sie x-ms-file-extended-info: true, oder rufen Sie Dateieigenschaften abrufen auf.

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

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

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

In den Versionen 2021-12-02 und höher List Directory and Files werden alleNameFile Elementwerte PrefixDirectoryNameDirectoryPath prozentual codiert (gemäß RFC 2396), die ungültige Zeichen in XML enthalten (insbesondere U+FFFE oder U+FFFF). Wenn es codiert ist, enthält das Name- Prefix oder EnumerationResults -Element ein Encoded=true -Attribut. Beachten Sie, dass dies nur für die Name Elementwerte auftritt, die die ungültigen Zeichen in XML enthalten, nicht für die restlichen Name Elemente in der Antwort.

Datetime-Format und API-Version für Zeitstempelfelder

Autorisierung

Nur der Kontobesitzer kann diesen Vorgang aufrufen.

Hinweise

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

Beachten Sie, dass jedes zurückgegebene Directory-Element in das maximale Ergebnis eingerechnet wird, ebenso wie jedes File-Element. Dateien und Verzeichnisse werden in lexisch sortierter Reihenfolge im Antworttext vermischt aufgeführt.

Die Auflistung ist auf eine einzelne Ebene der Verzeichnishierarchie beschränkt. Um mehrere Ebenen aufzulisten, können Sie mehrere Aufrufe iterativ tätigen. Verwenden Sie den Directory von einem Ergebnis zurückgegebenen Wert in einem nachfolgenden Aufruf von List Directories and Files.

Weitere Informationen

Vorgänge in Verzeichnissen