Dosya Özelliklerini Ayarla

İşlem, Set File Properties dosyadaki sistem özelliklerini ayarlar.

Protokol kullanılabilirliği

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

İstek

İstek Set File 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/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	Description
myaccount	Depolama hesabınızın adı.
myshare	Dosya paylaşımınızın adı.
mydirectorypath	İsteğe bağlı. Ü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	İ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-cache-control	İsteğe bağlı. Dosyanın önbellek denetim dizesini değiştirir. İstekte bu özellik belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al'a yapılan sonraki çağrılar, dosyada yeniden açıkça ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-type	İsteğe bağlı. Dosyanın içerik türünü ayarlar. İstekte bu özellik belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al'a yapılan sonraki çağrılar, dosyada yeniden açıkça ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-md5	İsteğe bağlı. Dosyanın MD5 karması ayarlar. İstekte bu özellik belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al'a yapılan sonraki çağrılar, dosyada yeniden açıkça ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-encoding	İsteğe bağlı. Dosyanın içerik kodlamasını ayarlar. İstekte bu özellik belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al'a yapılan sonraki çağrılar, dosyada yeniden açıkça ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-language	İsteğe bağlı. Dosyanın içerik dilini ayarlar. İstekte bu özellik belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al'a yapılan sonraki çağrılar, dosyada yeniden açıkça ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-disposition	İsteğe bağlı. Dosyanın Content-Disposition üst bilgisini ayarlar. İstekte bu özellik belirtilmezse, dosya için özellik temizlenir. Dosya Özelliklerini Al'a yapılan sonraki çağrılar, dosyada yeniden açıkça ayarlanmadığı sürece bu özelliği döndürmez.
x-ms-content-length: bytes	İsteğe bağlı. 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> }	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 dosyanın 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. Belirtilirse, bir sahip, grup ve isteğe bağlı erişim denetimi listesi (DACL) olmalıdır. Mevcut bir değeri preserve değiştirmeden tutmak için değeri geçirilebilir. Not: veya x-ms-file-permission-keybelirtebilirsinizx-ms-file-permission. Üst bilgi belirtilmezse 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> }	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 preserve değiştirmeden tutmak için değeri geçirilebilir. preserve varsayılan değerdir.
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 dosya için Eşgüdümlü Evrensel Saat (UTC) oluşturma zamanı özelliği. Var olan 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> }	Gerekli, sürüm 2019-02-02 - 2021-04-10. İsteğe bağlı, sürüm 2021-06-08 ve üzeri. Bir dosya için Eşgüdümlü Evrensel Saat (UTC) son yazma özelliği. Var olan bir değeri preserve değiştirmeden tutmak için değeri geçirilebilir. belirtilirse ve dosyanın boyutu değiştirilirse preserve , 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. preserve varsayılan değerdir.
x-ms-lease-id: <ID>	Dosyanın etkin bir kirası varsa gereklidir. Sürüm 2019-02-02 ve üzeri için kullanılabilir.
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-change-time: { now ¦ <DateTime> }	İsteğe bağlı. 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ş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 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 ve yanıt üst bilgileri kümesi 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
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 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. Dosyalardaki işlemler dizinin son değiştirilme saatini etkilemez.
x-ms-request-id	Yapılan isteği benzersiz olarak tanımlar ve istekle ilgili sorunları 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 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 olarak ayarlanır true . Aksi takdirde, değer olarak falseayarlanı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çin kullanı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 saati özelliğini temsil eden UTC tarih/saat değeri.
x-ms-client-request-id	İsteklerin ve karşılık gelen yanıtların sorunları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 üst bilginin değerine x-ms-client-request-id eşittir. x-ms-client-request-id Üst bilgi istekte 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 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çbiri	FILE_ATTRIBUTE_NORMAL	Ayarlanmış başka öznitelikleri 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

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

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

• bir istek yalnızca x-ms-content-length ayarlıysa 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 yazmak için istekte geçerli bir kira kimliği belirtmesi gerekir. İstemci bir kira kimliği belirtmezse veya geçersiz bir kira kimliği belirtiyorsa, Dosya hizmeti 412 durum kodunu döndürür (Önkoşul Başarısız oldu). İstemci bir kira kimliği belirtiyorsa ancak dosyanın etkin kiralaması yoksa, Dosya hizmeti 412 durum kodunu da döndürür (Önkoşul Başarısız oldu).

Ayrıca bkz.

Azure Dosyalar üzerinde işlemler