Dizinleri ve Dosyaları Listele

Makale
03/29/2023

İşlem, List Directories and Files 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.

Protokol kullanılabilirliği

Etkin dosya paylaşımı protokolü	Kullanılabilir
SMB
NFS

İstek

İsteği aşağıdaki gibi oluşturabilirsiniz List Directories and Files . HTTPS önerilir.

Yöntem	İstek URI'si	HTTP sürümü
`GET`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath?restype=directory&comp=list`	HTTP/1.1
`GET`	`https://myaccount.file.core.windows.net/myshare/mydirectorypath?restype=directory&sharesnapshot=<DateTime>&comp=list`	HTTP/1.1

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

Yol bileşeni	Description
`myaccount`	Depolama hesabınızın adı.
`myshare`	Dosya paylaşımınızın adı.
`mydirectorypath`	Dizinin yolu.

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

URI parametreleri

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

Parametre	Açıklama
`prefix`	İsteğe bağlı. Sürüm 2016-05-31 ve üzeri. Sonuçları yalnızca belirtilen ön ekle başlayan adlara sahip dosyaları ve dizinleri döndürecek şekilde filtreler.
`sharesnapshot`	İsteğe bağlı. Sürüm 2017-04-17 ve üzeri. Paylaşım anlık görüntüsü parametresi, mevcut olduğunda dosya ve dizin listesi için sorguya çekebilecek paylaşım anlık görüntüsünü belirten opak `DateTime` bir değerdir.
`marker`	İsteğe bağlı. Listenin bir sonraki liste işlemiyle döndürülecek bölümünü tanımlayan dize değeri. Döndürülen liste tamamlanmadıysa işlem yanıt gövdesi içinde bir işaretçi değeri döndürür. Bundan sonra sonraki bir çağrıda işaretleyici değerini kullanarak bir sonraki liste öğesi kümesini isteyebilirsiniz. İşaretçi değeri istemci için opaktır.
`maxresults`	İsteğe bağlı. Döndürülecek dosya veya dizin sayısı üst sınırını belirtir. İstek belirtmezse `maxresults`veya 5.000'den büyük bir değer belirtirse, sunucu en fazla 5.000 öğe döndürür. Sıfırdan küçük veya sıfıra eşit bir değere ayarlanması `maxresults` hata yanıtı kodu 400 (Hatalı İstek) ile sonuçlanır.
`include={Timestamps, ETag, Attributes, PermissionKey}`	İsteğe bağlı olarak, sürüm 2020-04-08'den itibaren kullanılabilir. Yanıta eklenecek bir veya daha fazla özelliği belirtir: `Timestamps` `ETag` `Attributes` (Win32 dosya öznitelikleri) `PermissionKey` URI'de bu seçeneklerden birden fazlasını belirtmek için, her seçeneği URL ile kodlanmış virgülle (`%82` ) ayırmanız gerekir. Bu parametre belirtildiğinde üst bilginin `x-ms-file-extended-info` örtük olarak true olduğu varsayılır.
`timeout`	İsteğe bağlı. `timeout` parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Azure Dosyalar işlemleri için zaman aşımlarını ayarlama.

İstek üst bilgileri

Aşağıdaki tabloda gerekli ve isteğe bağlı istek üst bilgileri açıklanmaktadır.

İstek üst bilgisi	Açıklama
`Authorization`	Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
`Date` veya `x-ms-date`	Gereklidir. İstek için Eşgüdümlü Evrensel Saat (UTC) biçimini belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini yetkilendirme.
`x-ms-version`	Anonim istekler için isteğe bağlı olarak tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
`x-ms-client-request-id`	İsteğe bağlı. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibaytlık (KiB) karakter sınırıyla istemci tarafından oluşturulan, opak bir değer sağlar. İstemci tarafı etkinlikleriyle sunucunun aldığı istekler arasında bağıntı sağlamak için bu üst bilgiyi kullanmanızı kesinlikle öneririz. Daha fazla bilgi için bkz. İzleme Azure Dosyalar.
`x-ms-file-extended-info: {true}`	İsteğe bağlı. Sürüm 2020-04-08 ve üzeri. Sorgu parametresi boş değilse `include` bu üst bilginin örtük olarak true olduğu varsayılır. True ise özellik `Content-Length` güncel olacaktır. 2020-04-08, 2020-06-12 ve 2020-08-04 sürümlerinde, `FileId` dosyalar ve dizinler için yalnızca bu üst bilgi doğru olduğunda döndürülür. 2020-10-02 ve sonraki sürümlerde dosyalar `FileId` ve dizinler için her zaman döndürülür.
`x-ms-file-request-intent`	Üst bilgi bir OAuth belirteci belirtiyorsa `Authorization` gereklidir. Kabul edilebilir değer: `backup`. Bu üst bilgi, üst bilgi kullanılarak `Authorization` yetkilendirilen `Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action` kimliğe atanan RBAC ilkesine eklenmişse veya `Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action` izni verilmesi gerektiğini belirtir. Sürüm 2022-11-02 ve üzeri için kullanılabilir.
`x-ms-allow-trailing-dot: { <Boolean> }`	İsteğe bağlı. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir. Daha fazla bilgi için bkz . Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve buna başvurma.

İstek gövdesi

Yok.

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 (Tamam) durum kodunu döndürür. Durum kodları hakkında bilgi için bkz. Durum ve hata kodları.

Yanıt üst bilgileri

Bu işlemin yanıtı aşağıdaki ü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.

Yanıt üst bilgisi	Description
`Content-Type`	Sonuçların döndürüldiği biçimi belirtir. Şu anda bu değer şeklindedir `application/xml`.
`x-ms-request-id`	Bu üst bilgi, yapılan isteği benzersiz olarak tanımlar ve isteğin sorunlarını gidermek için kullanılabilir. Daha fazla bilgi için bkz. API işlemleriyle ilgili sorunları giderme.
`x-ms-version`	İsteği çalıştırmak için kullanılan Azure Dosyalar sürümünü gösterir.
`Date` veya `x-ms-date`	Yanıtın başlatıldığı saati gösteren utc tarih/saat değeri. Hizmet bu değeri oluşturur.
`x-ms-client-request-id`	İstekler ve karşılık gelen yanıtlarla ilgili sorunları gidermek için bu üst bilgiyi kullanabilirsiniz. Bu üst bilginin değeri, istekte varsa üst bilginin değerine `x-ms-client-request-id` eşittir. Değer en fazla 1024 görünür ASCII karakterdir. `x-ms-client-request-id` Üst bilgi istekte yoksa, yanıtta bu üst bilgi bulunmaz.

Yanıt gövdesi

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

, ShareSnapshotve MaxResults öğelerinin Markeryalnızca istek URI'sinde belirttiğinizde mevcut olduğunu unutmayın. öğesinin NextMarker yalnızca liste sonuçları tamamlanmazsa bir değeri vardır.

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

öğesinin Content-Length listede döndürüldüğünü unutmayın. Ancak, bir SMB istemcisi dosyayı yerel olarak değiştirdiğinden bu değer güncel olmayabilir. değeri Content-Length , tanıtıcı kapatılana veya op-lock bozulana kadar bu gerçeği yansıtmayabilir. Geçerli özellik değerlerini almak için kullanın x-ms-file-extended-info: trueveya Dosya Özelliklerini Al'ı çağırabilirsiniz.

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

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

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

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, PrefixDirectoryNameveya DirectoryPath öğe değerlerini yüzde kodlar (RFC 2396 başına). Kodlandıysa, Nameveya PrefixEnumerationResults öğesi bir Encoded=true öznitelik içerir. Bunun yanıttaki Name kalan Name öğeler için değil yalnızca XML'de geçersiz karakterleri içeren öğe değerleri için gerçekleşeceğini unutmayın.

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

Öğe	Tarih saat biçimi	Örnek değer	API sürümü
`CreationTime`	ISO 8601	`2020-09-17T13:38:03.2740000Z`	2020-04-08 ve üzeri
`LastAccessTime`	ISO 8601	`2020-09-17T13:38:03.2740000Z`	2020-04-08 ve üzeri
`LastWriteTime`	ISO 8601	`2020-09-17T13:38:03.2740000Z`	2020-04-08 ve üzeri
`ChangeTime`	ISO 8601	`2020-09-17T13:38:03.2740000Z`	2020-06-12 ve üzeri
`Last-Modified`	RFC 1123	`Thu, 17 Sep 2020 13:38:07 GMT`	2020-06-12 ve üzeri

Yetkilendirme

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

Açıklamalar

öğesinde Content-Length 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 öğenin, her DirectoryFile öğenin yaptığı gibi en yüksek sonuç için de sayı olduğunu unutmayın. Dosyalar ve dizinler, yanıt gövdesinde sözcük temelli olarak sıralanmış olarak 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. Directory Sonraki çağrısında List Directories and Filesbir sonuçtan döndürülen değeri kullanın.

Ayrıca bkz.

Dizinler üzerindeki işlemler