Dizin Özelliklerini Ayarla

Makale
02/19/2025

Set Directory Properties işlemi, belirtilen dizin için sistem özelliklerini ayarlar. Bu işlem, SMB protokolü etkinleştirilmiş Dosya Paylaşımları için 2019-02-02 ve sonraki sürümlerde ve 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

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

Yöntem	İstek URI'si	HTTP sürümü
KOYMAK	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/mydirectory?restype=directory&comp=properties`	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ı.
`mydirectorypath`	Opsiyonel. Üst dizinin yolu.
`mydirectory`	Dosyanın 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 parametreleri belirtebilirsiniz:

Parametre	Açıklama
`timeout`	Opsiyonel. `timeout` parametresi saniye cinsinden ifade edilir. Daha fazla bilgi için bkz. Dosya hizmeti 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-file-creation-time: { preserve ¦ <DateTime> }`	2019-02-02 ile 2021-04-10 arası sürümler için gereklidir. 2021-06-08 ve üzeri sürümler için isteğe bağlı. Bir dizin için Eşgüdümlü Evrensel Saat (UTC) oluşturma zamanı özelliği. Mevcut bir değeri değişmeden tutmak için `preserve` değeri geçirilebilir. Varsayılan değer `preserve`.
`x-ms-file-last-write-time: { preserve ¦ <DateTime> }`	2019-02-02 ile 2021-04-10 arası sürümler için gereklidir. 2021-06-08 ve üzeri sürümler için isteğe bağlı. Bir dizin için Eşgüdümlü Evrensel Saat (UTC) son yazma özelliği. Mevcut bir değeri değişmeden tutmak için `preserve` değeri geçirilebilir. Varsayılan değer `preserve`.
`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

İstek üst bilgisi	Açıklama
`x-ms-file-change-time: { now ¦ <DateTime> }`	Opsiyonel. Sürüm 2021-06-08 ve üzeri. Iso 8601 biçiminde biçimlendirilmiş dizin için Eşgüdümlü Evrensel Saat (UTC) değiştirme zamanı özelliği. İsteğin zamanını belirtmek için `now` değerini kullanabilirsiniz. Varsayılan değer `now`.
`x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> }`	2019-02-02 - 2021-04-10 sürümlerinde, `x-ms-file-permission-key` belirtilmezse bu üst bilgi gereklidir. 2021-06-08 sürümünden itibaren her iki üst bilgi de isteğe bağlıdır. Bu izin, Güvenlik Tanımlayıcısı Tanım Dili (SDDL) veya (sürüm 2024-11-04 veya üzeri) base64 ile kodlanmış ikili güvenlik tanımlayıcısı biçimindebelirtilen dizinin güvenlik tanımlayıcısıdır. `x-ms-file-permission-format` üst bilgisi ile hangi biçimin kullanılacağını belirtebilirsiniz. İzin boyutu 8 kibibayt (KiB) veya daha azsa bu üst bilgiyi kullanabilirsiniz. Aksi takdirde, `x-ms-file-permission-key`kullanabilirsiniz. Belirtilmişse sahip, grup ve isteğe bağlı erişim denetimi listesi (DACL)olmalıdır. Mevcut bir değeri değişmeden tutmak için `preserve`değerini geçirebilirsiniz. Not: `x-ms-file-permission` veya `x-ms-file-permission-key`belirtebilirsiniz. Üst bilgi belirtilmezse, `preserve` üst bilgisi için varsayılan `x-ms-file-permission` değeri kullanılır.
`x-ms-file-permission-format: { sddl ¦ binary }`	Opsiyonel. Sürüm 2024-11-04 veya üzeri. `x-ms-file-permission` geçirilen değerin SDDL'de mi yoksa ikili biçimde mi olduğunu belirtir. `x-ms-file-permission` `preserve`olarak ayarlandıysa, bu üst bilgi ayarlanmalıdır. `x-ms-file-permission` `preserve`dışında bir değere ayarlanırsa ve bu üst bilgi ayarlanmazsa varsayılan `sddl` değeri kullanılır.
`x-ms-file-permission-key: <PermissionKey>`	2019-02-02 - 2021-04-10 sürümlerinde, `x-ms-file-permission` belirtilmezse bu üst bilgi gereklidir. 2021-06-08 sürümünden itibaren her iki üst bilgi de isteğe bağlıdır. Dosya için ayarlanacak iznin anahtarı. Bu, `Create-Permission` API kullanılarak oluşturulabilir. Not: `x-ms-file-permission` veya `x-ms-file-permission-key`belirtebilirsiniz. Üst bilgi belirtilmezse, `preserve` üst bilgisi için varsayılan `x-ms-file-permission` değeri kullanılır.
`x-ms-file-attributes: { preserve ¦ <FileAttributeList> }`	2019-02-02 ile 2021-04-10 arası sürümler için gereklidir. 2021-06-08 ve üzeri sürümler için isteğe bağlı. Dosyada ayarlanacak dosya sistemi öznitelikleri. kullanılabilirözniteliklerin listesine bakın. Mevcut bir değeri değişmeden tutmak için `preserve` değeri geçirilebilir. Varsayılan değer `preserve`.

Yalnızca NFS istek üst bilgileri

İstek üst bilgisi	Açıklama
`x-ms-mode`	Sürüm 2025-05-05 ve üzeri. Dosyada ayarlanacak mod bitleri. Mod, 12 bit sayısal sekizli biçimde veya sembolik 'rwx' biçiminde temsil edilir. bkz. POSIX dosya izinleri (mod).
`x-ms-owner`	Sürüm 2025-05-05 ve üzeri. Dosya üzerinde ayarlanacak dosya sahibinin kullanıcı tanımlayıcısı (UID).
`x-ms-group`	Sürüm 2025-05-05 ve üzeri. Dosya üzerinde ayarlanacak dosya sahibinin grup tanımlayıcısı (GID).

İstek gövdesi

Hiç kimse.

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`	Dosyanın sürümünü temsil eden 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. Dizini veya özelliklerini değiştiren tüm işlemler son değiştirme zamanını güncelleştirir. Dosyalardaki işlemler dizinin son değiştirme zamanını etkilemez.
`x-ms-request-id`	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şlem sorunlarını giderme.
`x-ms-version`	İsteği yürütmek için kullanılan Dosya hizmeti sürümünü gösterir.
`Date` veya `x-ms-date`	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
`x-ms-request-server-encrypted: true/false`	Sürüm 2017-04-17 ve üzeri. İsteğin içeriği belirtilen algoritma kullanılarak başarıyla şifrelenirse, bu üst bilginin değeri `true` olarak ayarlanır. Aksi takdirde, değeri `false`olarak ayarlanır.
`x-ms-file-creation-time`	Sürüm 2019-02-02 ve üzeri. Dizinin 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-client-request-id`	İsteklerde ve ilgili yanıtlarda sorun 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).

Yanıt gövdesi

Hiç kimse.

İ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 dizin.
Gizli	FILE_ATTRIBUTE_HIDDEN	Dizin gizlidir. Sıradan bir dizin listesine dahil değildir.
Sistem	FILE_ATTRIBUTE_SYSTEM	İşletim sisteminin bir bölümünü kullandığı veya özel olarak kullandığı bir dizin.
Hiç kimse	FILE_ATTRIBUTE_NORMAL	Başka öznitelikleri ayarlı olmayan bir dizin. Bu öznitelik yalnızca tek başına kullanıldığında geçerlidir.
Dizin	FILE_ATTRIBUTE_DIRECTORY	Bir dizini tanımlayan tanıtıcı.
Arşiv	FILE_ATTRIBUTE_ARCHIVE	Arşiv dizini olan bir dizin. Uygulamalar genellikle dosyaları yedekleme veya kaldırma amacıyla işaretlemek için bu özniteliği kullanır.
Çevrimdışı	FILE_ATTRIBUTE_OFFLINE	Bir dizinin 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	Dizin, 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

Set Directory Properties, paylaşımın salt okunur bir kopyası olan paylaşım anlık görüntüsünde desteklenmez. Paylaşım anlık görüntüsünde bu işlemi gerçekleştirme girişimi 400 (InvalidQueryParameterValue) ile başarısız oluyor.

Set Directory Properties içeren bir dizinde ayarlanan özellikler, bu dizinin altındaki hiçbir alt dizine yayılmaz. Özelliklerini güncelleştirmek istediğiniz her dizin için Set Directory Properties çağırmalısınız.

Ayrıca bkz.

Dizinlerde İşlemleri

Aracılığıyla paylaş