Dosya Özelliklerini Ayarla

  • Makale

Set File Properties işlemi dosyadaki sistem özelliklerini ayarlar.

Protokol kullanılabilirliği

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

İstek

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

Yöntem İstek URI'si HTTP sürümü
KOYMAK https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?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.
myfile 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 tabloda açıklanmıştır:

İstek üst bilgisi Açıklama
Authorization Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri 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 depolamaistekleri 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-cache-control Opsiyonel. Dosyanın önbellek denetim dizesini değiştirir.

bu özellik istekte belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al yapılan sonraki çağrılar, dosyada açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-type Opsiyonel. Dosyanın içerik türünü ayarlar.

bu özellik istekte belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al yapılan sonraki çağrılar, dosyada açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-md5 Opsiyonel. Dosyanın MD5 karması olarak ayarlar.

bu özellik istekte belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al yapılan sonraki çağrılar, dosyada açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-encoding Opsiyonel. Dosyanın içerik kodlamasını ayarlar.

bu özellik istekte belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al yapılan sonraki çağrılar, dosyada açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-language Opsiyonel. Dosyanın içerik dilini ayarlar.

bu özellik istekte belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al yapılan sonraki çağrılar, dosyada açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-disposition Opsiyonel. Dosyanın Content-Disposition üst bilgisini ayarlar.

bu özellik istekte belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al yapılan sonraki çağrılar, dosyada açıkça yeniden ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-length: bytes Opsiyonel. Bir dosyayı belirtilen boyuta yeniden boyutlandırıyor. Belirtilen bayt değeri dosyanın geçerli boyutundan küçükse, belirtilen bayt değerinin üzerindeki tüm aralıklar temizlenir.
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, base64 ile kodlanmış ikili güvenlik tanımlayıcısı biçimindeGüvenlik Tanımlayıcısı Tanım Dili (SDDL) veya (sürüm 2024-11-04 veya üzeri) içinde belirtilen dosyanın 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-keykullanabilirsiniz. Belirtilirse, bir 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ğeri geçirilebilir.

Not: x-ms-file-permission veya x-ms-file-permission-keybelirtebilirsiniz. Üst bilgi belirtilmezse varsayılan preserve 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-key preserveolarak ayarlandıysa, bu üst bilgi ayarlanmamalıdır. x-ms-file-permission-key preservedışında bir değere ayarlanırsa ve bu üst bilgi ayarlanmadıysa 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-keybelirtebilirsiniz. Üst bilgi belirtilmezse, x-ms-file-permission üst bilgisi için varsayılan preserve değeri kullanılır.
x-ms-file-attributes: { preserve ¦ <FileAttributeList> } Gerekli, sürüm 2019-02-02 - 2021-04-10. İsteğe bağlı, sürüm 2021-06-08 ve üzeri. 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.
x-ms-file-creation-time: { preserve ¦ <DateTime> } Gerekli, sürüm 2019-02-02 - 2021-04-10. İsteğe bağlı, sürüm 2021-06-08 ve üzeri. Bir dosyanın 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> } Gerekli, sürüm 2019-02-02 - 2021-04-10. İsteğe bağlı, sürüm 2021-06-08 ve üzeri. Bir dosyanın 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. preserve belirtilirse ve dosyanın boyutu değiştirilirse, son yazma zamanı geçerli saate güncelleştirilir. Dosyanın boyutu değiştirilirse ancak açık bir zaman damgası sağlanırsa, açık zaman damgası kullanılır. Varsayılan değer preserve.
x-ms-lease-id: <ID> Dosyanın etkin bir kirası varsa gereklidir. 2019-02-02 ve sonraki sürümlerde kullanılabilir.
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-change-time: { now ¦ <DateTime> } Opsiyonel. Sürüm 2021-06-08 ve üzeri. Iso 8601 biçiminde biçimlendirilmiş dosyanın Eşgüdümlü Evrensel Saat (UTC) değişiklik saati özelliği. İsteğin zamanını belirtmek için now değerini kullanabilirsiniz. Varsayılan değer now.
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 eklenmişse 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. Daha fazla bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve başvurma.

İ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 üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgilerHTTP/1.1 protokol belirtimine uygundur.

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 Dosyanın 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 hizmetinin 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 falseolarak ayarlanır.
x-ms-file-permission-key Sürüm 2019-02-02 ve üzeri. Dosyanın izninin anahtarı.
x-ms-file-attributes Sürüm 2019-02-02 ve üzeri. Dosyadaki dosya sistemi öznitelikleri. Daha fazla bilgi içinkullanılabilir özniteliklerin listesine bakın.
x-ms-file-creation-time Sürüm 2019-02-02 ve üzeri. Dosyanın 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. Dosyanın 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. Dosyanın 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.

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

Açıklamalar

Bir dosyanın özelliklerini güncelleştirme semantiği aşağıdaki gibidir:

  • Dosyanın boyutu yalnızca istek x-ms-content-length üst bilgisi için bir değer belirtiyorsa değiştirilir.

  • bir istek yalnızca x-ms-content-length ayarlarsa ve başka bir özellik yoksa, dosyanın başka özellikleri değiştirilmez.

  • İstekte aşağıdaki özelliklerden biri veya daha fazlası ayarlanırsa, tüm bu özellikler birlikte ayarlanır. Aşağıdaki özelliklerden en az biri ayarlandığında belirtilen özellik için bir değer sağlanmazsa, bu özellik dosya için temizlenir.

    • x-ms-cache-control
    • x-ms-content-type
    • x-ms-content-md5
    • x-ms-content-encoding
    • x-ms-content-language

Not

Önceki dosya özellikleri, SMB istemcilerinin kullanabileceği dosya sistemi özelliklerinden ayrıdır. SMB istemcileri bu özellik değerlerini okuyamaz, yazamaz veya değiştiremez.

Set File 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.

Dosyanın etkin bir kirası varsa, istemcinin dosyaya özellik yazma isteğinde geçerli bir kira kimliği belirtmesi gerekir. İstemci bir kira kimliği belirtmezse veya geçersiz bir kira kimliği belirtirse, Dosya hizmeti durum kodu 412 (Önkoşul Başarısız) döndürür. İstemci bir kira kimliği belirtiyorsa ancak dosyanın etkin bir kirası yoksa, Dosya hizmeti de durum kodu 412 'yi döndürür (Önkoşul Başarısız oldu).

Ayrıca bkz.

Azure Dosyalar üzerinde İşlemleri