Aracılığıyla paylaş

Dizin Özelliklerini Alma

  • Makale

Get Directory Properties işlemi, belirtilen dizin için tüm sistem özelliklerini döndürür ve bir dizinin varlığını denetlemek için de kullanılabilir. Döndürülen veriler dizindeki dosyaları veya alt dizinleri içermez. 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 Evet
NFS Evet

İstek

Get Directory Properties isteği aşağıdaki gibi oluşturulur. HTTPS kullanmanızı öneririz.

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

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

Yol bileşeni Açıklama
myaccount Depolama hesabınızın adı.
myshare Dosya paylaşımınızın adı.
myparentdirectorypath Opsiyonel. Üst dizinin yolu.
mydirectory Dizinin adı.

Yol adlandırma kısıtlamaları hakkında bilgi için bkz. Ad ve başvuru paylaşımları, dizinler, dosyalar ve meta veriler.

URI parametreleri

İstek URI'sinde aşağıdaki ek parametreler belirtilebilir:

Parametre Açıklama
sharesnapshot Opsiyonel. Sürüm 2017-04-17 ve üzeri. sharesnapshot parametresi, mevcut olduğunda dizin özelliklerini sorgulamak üzere paylaşım anlık görüntüsünü belirten opak bir DateTime değeridir
timeout Opsiyonel. 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

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

Ortak istek üst bilgileri

İstek üst bilgisi Açıklama
Authorization Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolama istekleri yetkilendirme.
Date veya x-ms-date Gerekli. İstek için Eşgüdümlü Evrensel Saati (UTC) belirtir. Daha fazla bilgi için bkz. azure depolama istekleri yetkilendirme.
x-ms-version Tüm yetkili istekler için gereklidir. Bu istek için kullanılacak işlemin sürümünü belirtir. Bu işlem, NFS protokolü etkinleştirilmiş Dosya Paylaşımları için 2025-05-05 ve sonraki sürümlerde desteklenir.

Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma.
x-ms-client-request-id Opsiyonel. Günlüğe kaydetme yapılandırıldığında günlüklere kaydedilen 1 kibibayt (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. azure dosyaları izleme.
x-ms-file-request-intent Authorization üst bilgisi bir OAuth belirteci belirtiyorsa gereklidir. Kabul edilebilir değer backup. Bu üst bilgi, Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action, Authorization üst bilgisi kullanılarak yetkilendirilmiş kimliğe atanan RBAC ilkesine dahil edilirse verilmesi gerektiğini belirtir. Sürüm 2022-11-02 ve üzeri için kullanılabilir.
x-ms-allow-trailing-dot: { <Boolean> } Opsiyonel. Sürüm 2022-11-02 ve üzeri. Boole değeri, istek URL'sinde bulunan sondaki bir noktanın kırpılıp kırpılmaması gerektiğini belirtir.

Hedef, varsayılan olarak sondaki noktayı destekleyen NFS protokolü etkinleştirilmiş bir Dosya Paylaşımında bulunuyorsa bu üst bilgi yoksayılır.

Daha fazla bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma.

Yalnızca SMB istek üst bilgileri

Hiç kimse.

Yalnızca NFS istek üst bilgileri

Hiç kimse.

İstek gövdesi

Hiç kimse.

Örnek istek

HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1  
  
Request Headers:  
x-ms-version: 2015-02-21  
x-ms-date: <date>  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Yanıt

Yanıt bir HTTP durum kodu ve bir dizi yanıt üst bilgisi 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

Yanıt üst bilgisi Açıklama
ETag ETag, işlemleri koşullu olarak gerçekleştirmek için kullanabileceğiniz bir değer içerir. Değer tırnak içine alınır.
Last-Modified Dizinin en son değiştirildiği tarih ve saati döndürür. Tarih biçimi RFC 1123'e uyar. Daha fazla bilgi için bkz. üst bilgilerde tarih/saat değerlerini temsil edin. Dizindeki dosyalar üzerindeki işlemler, dizinin son değiştirme zamanını etkilemez.
x-ms-meta-name:value Dizinin meta verilerini içeren bir dizi ad-değer çifti.
x-ms-request-id İsteğin benzersiz tanımlayıcısını döndürür ve bu, isteğin sorunlarını gidermenize yardımcı olabilir. Daha fazla bilgi için bkz. API işlem sorunlarını giderme.
x-ms-version İsteği yürütmek için kullanılan hizmet sürümünü gösterir.
Date Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
x-ms-server-encrypted: true/false Sürüm 2017-04-17 ve üzeri. Dizin meta verileri belirtilen algoritma kullanılarak tamamen şifrelenirse, bu üst bilginin değeri true olarak ayarlanır. Meta veriler şifrelenmemişse, değeri falseolarak ayarlanır.
x-ms-file-creation-time Sürüm 2019-02-02 ve üzeri. Bir dizin için oluşturma zamanı özelliğini temsil eden UTC tarih/saat değeri.
x-ms-file-last-write-time Sürüm 2019-02-02 ve üzeri. Dizinin son yazma zamanı özelliğini temsil eden UTC tarih/saat değeri.
x-ms-file-change-time Sürüm 2019-02-02 ve üzeri. Dizinin değişiklik zamanı özelliğini temsil eden UTC tarih/saat değeri.
x-ms-file-file-id Sürüm 2019-02-02 ve üzeri. Dizinin dosya kimliği.
x-ms-file-parent-id Sürüm 2019-02-02 ve üzeri. Dizinin üst dosya kimliği.
x-ms-client-request-id İstekleri ve ilgili yanıtlarını gidermek için kullanılabilir. bu üst bilginin değeri, istekte mevcutsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa x-ms-client-request-id üst bilgisinin değerine eşittir. İstekte x-ms-client-request-id üst bilgisi yoksa yanıtta bulunmaz.

Yalnızca SMB yanıt üst bilgileri

Yanıt üst bilgisi Açıklama
x-ms-file-permission-key Sürüm 2019-02-02 ve üzeri. Dizinin izninin anahtarı.
x-ms-file-attributes Sürüm 2019-02-02 ve üzeri. Dizindeki dosya sistemi öznitelikleri. Daha fazla bilgi için kullanılabilir özniteliklerinlistesine bakın.

Yalnızca NFS yanıt üst bilgileri

Yanıt üst bilgisi Açıklama
x-ms-mode Sürüm 2025-05-05 ve üzeri. Dizinin modu. bkz. POSIX dosya izinleri (mod).
x-ms-owner Sürüm 2025-05-05 ve üzeri. Dizin sahibinin kullanıcı tanımlayıcısı (UID).
x-ms-group Sürüm 2025-05-05 ve üzeri. Dizin sahibinin grup tanımlayıcısı (GID).
x-ms-file-file-type Sürüm 2025-05-05 ve üzeri. Dosyanın türü, olası değerler şunlardır: Directory.

Yanıt gövdesi

Hiç kimse.

Örnek yanıt

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: <date>  
ETag: "0x8CAFB82EFF70C46"  
Last-Modified: <date>  
x-ms-version: 2015-02-21  
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0

İzin

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

Dosya sistemi öznitelikleri

Öznitelik Win32 dosya özniteliği Tanım
Salt Okunur FILE_ATTRIBUTE_READONLY Salt okunur bir dosya. Uygulamalar dosyayı okuyabilir, ancak dosyaya yazamaz veya silemez.
Gizli FILE_ATTRIBUTE_HIDDEN Dosya gizlidir. Sıradan bir dizin listesine dahil değildir.
Sistem FILE_ATTRIBUTE_SYSTEM İşletim sisteminin bir kısmını kullandığı veya özel olarak kullandığı bir dosya.
Hiç kimse FILE_ATTRIBUTE_NORMAL Başka öznitelikleri ayarlı olmayan bir dosya. Bu öznitelik yalnızca tek başına kullanıldığında geçerlidir.
Arşiv FILE_ATTRIBUTE_ARCHIVE Arşiv dosyası olan bir dosya. Uygulamalar normalde dosyaları yedekleme veya kaldırma amacıyla işaretlemek için bu özniteliği kullanır.
Geçici FILE_ATTRIBUTE_TEMPORARY Geçici depolama için kullanılan bir dosya.
Çevrimdışı FILE_ATTRIBUTE_OFFLINE Bir dosyanın verileri hemen kullanılamaz. Bu dosya sistemi özniteliği öncelikle Windows ile uyumluluk sağlamak için sunulur. Azure Dosyalar çevrimdışı depolama seçeneklerini desteklemez.
NotContentIndexed FILE_ATTRIBUTE_NOT_CONTENT_INDEXED Dosya, içerik dizin oluşturma hizmeti tarafından dizine alınamaz.
NoScrubData FILE_ATTRIBUTE_NO_SCRUB_DATA Kullanıcı veri akışı, arka plan veri bütünlüğü tarayıcısı tarafından okunamaz. Bu dosya sistemi özniteliği öncelikle Windows ile uyumluluk sağlamak için sunulur.

POSIX dosya izinleri (mod)

POSIX dosya izinleri sayısal olarak 12 bit sayısal sekizli biçimde veya sembolik "rwx" biçiminde belirtilebilir. Örnekler:

  • "0644" veya "rw-r--r--": Kullanıcının (dosya sahibi) okuma, yazma izni vardır. Grubun okuma izni var. Diğerleri okuma iznine sahiptir.
  • "0755" veya "rwxr-xr-x": Kullanıcının (dosya sahibi) okuma, yazma ve yürütme izni vardır. Grup okuma ve yürütme iznine sahiptir. Diğerleri okuma ve yürütme iznine sahiptir.

Sayısal sekizli biçim

En düşük üç sekizli sayı sahip/kullanıcı, grup ve diğer kişilerin izinlerini temsil eder ve '4' (Okuma), '2' (Yazma), '1' (Yürüt) bit düzeyinde bir birleşim kullanılarak oluşturulan sekizli bir sayı (0-7) kullanılarak belirtilir. En yüksek sıralı sekizli sayı (0-7), '4' (SetUID), '2' (SetGID), '1' (Yapışkan Bit) izinlerinin birleşimini belirtmek için kullanılır.

Biçim İzin
0700 Kullanıcının (dosya sahibi) okuma, yazma ve yürütme izni vardır.
0400 Kullanıcının okuma izni var.
0200 Kullanıcının yazma izni var.
0100 Kullanıcının yürütme izni var.
0070 Grup okuma, yazma ve yürütme iznine sahiptir.
0040 Grubun okuma izni var.
0020 Grubun yazma izni var.
0010 Grubun yürütme izni var.
0007 Diğerleri okuma, yazma ve yürütme iznine sahiptir.
0004 Diğerleri okuma iznine sahiptir.
0002 Başkalarının yazma izni vardır.
0001 Diğerleri yürütme iznine sahiptir.
4000 Dosyada etkin kullanıcı kimliğini ayarlayın.
2000 Dosyada etkin grup kimliğini ayarlayın.
1000 Dosyanın yalnızca dosya sahibi, dizin sahibi veya kök kullanıcı tarafından silinebileceğini veya yeniden adlandırılabildiğini belirtmek için ayarlayın.

Sembolik "rwx" biçimi

Sahip/kullanıcı, grup ve diğerleri için izinler , 'r' (Okuma), 'w' (Yazma) ve 'x' (Yürütme) karakterlerinin birleşimi kullanılarak belirtilir.

Biçim İzin
rwx------ Kullanıcının (dosya sahibi) okuma, yazma ve yürütme izni vardır.
r-------- Kullanıcının okuma izni var.
-w------- Kullanıcının yazma izni var.
--x------ Kullanıcının yürütme izni var.
---rwx--- Grup okuma, yazma ve yürütme iznine sahiptir.
---r----- Grubun okuma izni var.
----w---- Grubun yazma izni var.
-----x--- Grubun yürütme izni var.
------rwx Diğerleri okuma, yazma ve yürütme iznine sahiptir.
------r. Diğerleri okuma iznine sahiptir.
-------w- Başkalarının yazma izni vardır.
--------x Diğerleri yürütme iznine sahiptir.

Açıklamalar

Belirtilen dizin yolu yoksa, istek 404 (Bulunamadı) durum koduyla başarısız olur.

Ayrıca bkz.

Dizinlerde İşlemleri