Dizin Özelliklerini Ayarla
İşlem, Set Directory Properties belirtilen dizin için sistem özelliklerini ayarlar. Bu API, 2019-02-02 sürümünden itibaren kullanılabilir.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Kullanılabilir |
|---|---|
| SMB |
|
| NFS |
|
İstek
İstek Set Directory Properties aşağıdaki gibi oluşturulabilir. HTTPS kullanmanızı öneririz.
| Yöntem | İstek URI'si | HTTP sürümü |
|---|---|---|
| PUT | 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 | Description |
|---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
mydirectorypath |
İsteğe bağlı. Ü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 |
İsteğe bağlı.
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 tabloda açıklanmıştı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'ya istekleri 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'ya 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. Daha fazla bilgi için bkz. Azure Depolama hizmetleri için sürüm oluşturma. |
x-ms-file-permission: { preserve ¦ <SDDL> } |
2019-02-02 - 2021-04-10 sürümlerinde, belirtilmezse x-ms-file-permission-key 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'nde (SDDL) belirtilen dizinin güvenlik tanımlayıcısıdır. İzin boyutu 8 kibibayt (KiB) veya daha küçükse bu üst bilgiyi kullanabilirsiniz. Aksi takdirde kullanabilirsiniz x-ms-file-permission-key. Belirtilmişse sahip, grup ve isteğe bağlı erişim denetimi listesi (DACL) olmalıdır. Mevcut bir değeri değiştirmeden tutmak için değerini geçirebilirsiniz preserve.Not: veya x-ms-file-permission-keybelirtebilirsinizx-ms-file-permission. Üst bilgi belirtilmezse, üst bilgi için x-ms-file-permission varsayılan değeri preserve kullanılır. |
x-ms-file-permission-key: <PermissionKey> |
2019-02-02 - 2021-04-10 sürümlerinde, belirtilmezse x-ms-file-permission 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, API kullanılarak Create-Permission oluşturulabilir.Not: veya x-ms-file-permission-keybelirtebilirsinizx-ms-file-permission. Üst bilgi belirtilmezse, üst bilgi için x-ms-file-permission varsayılan değeri preserve kullanılır. |
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } |
2019-02-02 - 2021-04-10 sürümleri için gereklidir. Sürüm 2021-06-08 ve üzeri için isteğe bağlı. Dosyada ayarlanacak dosya sistemi öznitelikleri.
Kullanılabilir özniteliklerin listesine bakın. Mevcut bir değeri preserve değiştirmeden tutmak için değeri geçirilebilir.
preserve varsayılan değerdir. |
x-ms-file-creation-time: { preserve ¦ <DateTime> } |
2019-02-02 - 2021-04-10 sürümleri için gereklidir. Sürüm 2021-06-08 ve üzeri 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 preserve değiştirmeden tutmak için değeri geçirilebilir.
preserve varsayılan değerdir. |
x-ms-file-last-write-time: { preserve ¦ <DateTime> } |
2019-02-02 - 2021-04-10 sürümleri için gereklidir. Sürüm 2021-06-08 ve üzeri 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 preserve değiştirmeden tutmak için değeri geçirilebilir.
preserve varsayılan değerdir. |
x-ms-client-request-id |
İsteğe bağlı. 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. İzleme Azure Dosyalar. |
x-ms-file-change-time: { now ¦ <DateTime> } |
İsteğe bağlı. 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 değerini now kullanabilirsiniz.
now varsayılan değerdir. |
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 yetkilendirilmiş kimliğe atanan RBAC ilkesine dahil edildiyse veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action izni verilmesi Authorization gerektiğini belirtirMicrosoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action. 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 ve bir dizi yanıt üst bilgisi içerir.
Durum kodu
Başarılı bir işlem 200 (Tamam) durum kodunu döndürür.
Durum kodları hakkında daha fazla 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 |
|---|---|
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 tarihi ve saati döndürür. Tarih biçimi RFC 1123'e göredir. 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. Dosyalar üzerindeki işlemler, dizinin son değiştirilme 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şlemleriyle ilgili sorunları 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 olarak ayarlanır true . Aksi takdirde, değer olarak falseayarlanır. |
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 özniteliklerin listesine bakın. |
x-ms-file-creation-time |
Sürüm 2019-02-02 ve üzeri. 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-client-request-id |
İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte varsa ve değer 1.024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa yanıtta bulunmaz. |
Yanıt gövdesi
Yok.
Yetkilendirme
Bu işlemi yalnızca hesap sahibi çağırabilir.
Dosya sistemi öznitelikleri
| Öznitelik | Win32 dosya özniteliği | Tanım |
|---|---|---|
| ReadOnly | 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 kısmını kullandığı veya özel olarak kullandığı bir dizin. |
| Hiçbiri | FILE_ATTRIBUTE_NORMAL | Başka öznitelikleri ayarlı olmayan bir dizin. Bu öznitelik yalnızca tek başına kullanıldığında geçerlidir. |
| Directory | 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. |
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.
ile Set Directory Properties bir dizinde ayarlanan özellikler, bu dizinin altındaki hiçbir alt dizine yayılmaz. Özelliklerini güncelleştirmek istediğiniz her dizin için aramanız Set Directory Properties gerekir.