Dizinleri ve Dosyaları Listele

List Directories and Files işlemi, belirtilen paylaşım veya dizin altındaki dosyaların veya dizinlerin listesini döndürür. Yalnızca dizin hiyerarşisinin tek bir düzeyi için içeriği listeler. Bu işlem, NFS protokolü etkinleştirilmiş Dosya Paylaşımları için 2025-05-05 ve sonraki sürümlerde desteklenir.

Protokol kullanılabilirliği

Etkin dosya paylaşımı protokolü	Mevcut
SMB
NFS

İstek

List Directories and Files isteği aşağıdaki gibi oluşturulur. HTTPS kullanmanızı öneririz.

İstek URI'sinde gösterilen yol bileşenlerini aşağıdaki gibi kendinizle değiştirin:

Yol adlandırma kısıtlamaları hakkında ayrıntılı bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma.

URI parametreleri

URI'de aşağıdaki ek parametreleri belirtebilirsiniz.

Yaygın URI parametreleri

Yalnızca SMB URI parametreleri

Yalnızca NFS URI parametreleri

Hiç kimse.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tablolarda açıklanmıştır:

Ortak istek üst bilgileri

Yalnızca SMB istek üst bilgileri

Yalnızca NFS istek üst bilgileri

Hiç kimse.

İstek gövdesi

Hiç kimse.

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve XML biçiminde bir yanıt gövdesi içerir.

Durum kodu

Başarılı bir işlem 200 durum kodunu döndürür (Tamam). Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki tablolardaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Ortak yanıt üst bilgileri

Yalnızca SMB yanıt üst bilgileri

Hiç kimse.

Yalnızca NFS yanıt üst bilgileri

Hiç kimse.

Yanıt gövdesi

XML yanıtının biçimi aşağıdaki gibidir.

Marker, ShareSnapshotve MaxResults öğeleri yalnızca istek URI'sinde belirttiğinizde bulunur. NextMarker öğesi yalnızca liste sonuçları tamamlanmazsa bir değere sahiptir.

Content-Length öğesi dosyaların listesinde döndürülür ve bu da dosyanın boyutunu gösterir. Ancak, bir SMB veya NFS istemcisi dosyayı yerel olarak değiştirdiğinden bu değer up-to-date olmayabilir. Content-Length değeri, tanıtıcı kapatılana veya SMB op-lock bozulana kadar bu gerçeği yansıtmayabilir. Geçerli özellik değerlerini almak için, SMB protokolü etkin bir Dosya Paylaşımı'nda bulunan dizin için x-ms-file-extended-info: true kullanın veya belirli bir dosyaya karşı Dosya Özelliklerini Al çağırın.

2021-12-02 ve daha yeni sürümlerde List Directory and Files, XML'de geçersiz karakterler (özellikle U+FFFE veya U+FFFF) içeren tüm FileName, DirectoryName, Prefix veya DirectoryPath öğe değerlerini yüzde kodlar (RFC 2396 başına). Kodlanmışsa, Name, Prefix veya EnumerationResults öğesi bir Encoded=true özniteliği içerir. Bu yalnızca xml içinde geçersiz karakterleri içeren Name öğe değerleri için oluşur, yanıttaki kalan Name öğeleri için değil.

SMB protokolü etkin dosya paylaşımları için yanıt gövdesi

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

2020-04-08, 2020-06-12 ve 2020-08-04 sürümlerinde, üst bilgi FileId doğruysa dosyalar ve dizinler için x-ms-file-extended-info döndürülür. Sürüm 2020-10-02 ve sonraki sürümlerde, dosyalar ve dizinler için her zaman FileId döndürülür.

Sürüm 2020-04-08'de include={timestamps} şu zaman damgası özelliklerini döndürür: CreationTime, LastAccessTimeve LastWriteTime. sürüm 2020-06-12 ve sonraki sürümlerde include={timestamps} şu zaman damgası özelliklerini döndürür: CreationTime, LastAccessTime, LastWriteTime, ChangeTimeve Last-Modified.

Sürüm 2020-10-02 ve sonraki sürümlerde yanıtta DirectoryId döndürülür. API'nin çağrıldığı dizinin FileId belirtir.

NFS protokolü etkin dosya paylaşımları için yanıt gövdesi

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

Zaman damgası alanları için tarih saat biçimi ve API sürümü

İzin

Bu işlemi yalnızca hesap sahibi çağırabilir.

Açıklamalar

Content-Length öğesinde döndürülen değer, dosyanın x-ms-content-length üst bilgisinin değerine karşılık gelir.

Döndürülen her Directory öğesi, her File öğesinde olduğu gibi en yüksek sonuç için sayılır. Dosyalar ve dizinler, yanıt gövdesinde sözcük temelli olarak sıralanmış şekilde birbirine bağlı olarak listelenir.

Listeleme, dizin hiyerarşisinin tek bir düzeyiyle sınırlıdır. Birden çok düzeyi listelemek için yinelemeli bir şekilde birden çok çağrı yapabilirsiniz. bir sonuçtan döndürülen Directory değerini sonraki List Directories and Filesçağrısında kullanın.

Ayrıca bkz.

Dizinlerde İşlemleri