Dosya Oluştur

Create File işlemi yeni bir dosya oluşturur veya bir dosyanın yerini alır. Bu işlem, NFS protokolü etkinleştirilmiş Dosya Paylaşımları için 2025-05-05 ve sonraki sürümlerde desteklenir. Create Fileçağırdığınızda, yalnızca dosyayı başlatırsınız. Dosyaya içerik eklemek için Put Range işlemini çağırırsınız. 2026-02-06 sürümünden itibaren, işlem ile 4MiB'ye Create File kadar içerik içeren dosya da oluşturabilirsiniz.

Protokol kullanılabilirliği

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

İstek

Create File 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/myfile	HTTP/1.1

aşağıdaki tabloda açıklandığı gibi, istek URI'sinde gösterilen yol bileşenlerini 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. Dosyanın oluşturulacağı dizinin yolu. Dizin yolu atlanırsa, dosya belirtilen paylaşım içinde oluşturulur. Dizin belirtilirse, dosyayı oluşturabilmeniz için önce paylaşımda zaten bulunması gerekir.
myfile	Oluşturulacak 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 Saat (UTC) saatini 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.
Content-Length	İstek gövdesinde iletilen bayt sayısını belirtir. 2019-02-02'den 2025-11-05'e kadar olan versiyon: Opsiyonel. Varsa sıfır olmalıdır. 2026-02-06 veya daha sonraki sürüm: İstek gövdesinde içerik yer alıyorsa gereklidir. Eğer içerik yoksa ve başlık dahil edilmişse, değeri sıfır olmalıdır. Başlıkta belirtilen x-ms-content-length dosyanın boyutu ' Content-Lengthden küçükse, işlem hata kodu 400 ile başarısız olur.
x-ms-content-length: byte value	Gerekli. Bu üst bilgi, dosya için en fazla 4 tebibayt (TiB) boyutu belirtir.
Content-MD5	Opsiyonel. 2026-02-06 veya daha sonraki sürümlerde destekleniyor. İçeriğin MD5 karması. Bu karma, aktarım sırasında verilerin bütünlüğünü doğrulamak için kullanılır. Content-MD5 başlığı belirlendiğinde, Azure Files gelen içeriğin hash'ını gönderilen başlık değeriyle karşılaştırır. İki karma eşleşmezse, işlem 400 (Hatalı İstek) hata koduyla başarısız olur.
Content-Type veya x-ms-content-type	Opsiyonel. Dosyanın MIME içerik türü. Varsayılan tür application/octet-stream.
Content-Encoding veya x-ms-content-encoding	Opsiyonel. Dosyaya hangi içerik kodlamalarının uygulandığını belirtir. Dosya kaynağında Dosya Al işlemi gerçekleştirildiğinde bu değer istemciye döndürülür ve bunu kullanarak dosya içeriğinin kodunu çözebilirsiniz.
Content-Language veya x-ms-content-language	Opsiyonel. Bu kaynak tarafından kullanılan doğal dilleri belirtir.
Cache-Control veya x-ms-cache-control	Opsiyonel. Azure Dosyalar bu değeri depolar ancak kullanmaz veya değiştirmez.
x-ms-content-md5	Opsiyonel. Dosyanın MD5 karması olarak ayarlar.
x-ms-content-disposition	Opsiyonel. Dosyanın Content-Disposition üst bilgisini ayarlar.
x-ms-type: file	Gerekli. Bu üst bilgiyi fileolarak ayarlayın.
x-ms-meta-name:value	Opsiyonel. Dosyayla meta veri olarak ilişkili ad-değer çiftleri. Meta veri adları, C# tanımlayıcıları için adlandırma kurallarına uymalıdır. Not: Azure Dosyalar aracılığıyla belirtilen dosya meta verilerine Sunucu İleti Bloğu (SMB) istemcisinden erişilemez.
x-ms-file-creation-time: { now ¦ <DateTime> }	Gerekli: sürüm 2019-02-02 - 2021-04-10. İsteğe bağlı: sürüm 2021-06-08 ve üzeri. Dosyanın Eşgüdümlü Evrensel Saat (UTC) oluşturma zamanı özelliği. now değeri, isteğin zamanını belirtmek için kullanılabilir. Varsayılan değer now.
x-ms-file-last-write-time: { now ¦ <DateTime> }	Gerekli: sürüm 2019-02-02 - 2021-04-10. İsteğe bağlı: sürüm 2021-06-08 ve üzeri. Dosyanın Eşgüdümlü Evrensel Saat (UTC) son yazma özelliği. İsteğin zamanını belirtmek için now değerini kullanabilirsiniz. Varsayılan değer now.
x-ms-lease-id:<ID>	Dosyanın etkin bir kirası varsa gereklidir. 2019-02-02 ve sonraki sürümlerde kullanılabilir. Dosya, dosya kiralamalarını desteklemeyen NFS protokolü etkinleştirilmiş bir Dosya Paylaşımında bulunuyorsa bu üst bilgi yoksayılır.
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.
x-ms-structured-body	Eğer istek gövdesinin mesaj formatı yapılandırılmışsa gereklidir. Bu başlığın değeri, mesaj şeması versiyonu ve özelliklerini içerir. Şu anda desteklenen XSM/1.0; properties=crc64tek değer , bu da isteğin kodlanmış mesajda crc64 kontrol toplamı segmentleri kullandığını gösterir. Değer bu değerle eşleşmezse, işlem hata kodu 400 (Kötü İstek) ile başarısız olur. Talep ayrıca istekte sağlanan içerik, belirli bir segment için sağlanan kontrol toplamıyla eşleşmiyorsa da başarısız olur. 2026-06-06 ve sonrasında mevcut olan versiyon için mevcuttur. Yalnızca İçerik Uzunluğu sıfırdan büyük olan istekler için desteklenir.
x-ms-structured-content-length	Eğer istek gövdesinin mesaj formatı yapılandırılmışsa, yani x-ms-structured-body talekle birlikte belirtilmişse gereklidir. Bu başlığın değeri, dosya içeriğinin uzunluğudur ve mesaj kodlaması nedeniyle her zaman başlık değerinden daha küçük Content-Length olacaktır. Başlığın değeri, istekte verilen blok içeriğinin uzunluğuyla eşleşmiyorsa, işlem hata kodu 400 (Kötü İstek) ile başarısız olur. 2026-06-06 ve sonrasında mevcut olan versiyon için mevcuttur.

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. Dosyanın ISO 8601 biçiminde 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: { inherit ¦ <SDDL> ¦ <binary> }	Sürüm 2019-02-02 ile 2021-04-10 arasında, 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 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. Üst bilgiyi belirtirseniz, sahip, grup ve isteğe bağlı erişim denetimi listesi (DACL)olmalıdır. Üst dizinden devralmak için inherit değerini geçirebilirsiniz.
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 inheritolarak ayarlandıysa, bu üst bilgi ayarlanmalıdır. x-ms-file-permission inheritdışı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>	Sürüm 2019-02-02 ile 2021-04-10 arasında, 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. Üst bilgi belirtilmezse, inherit üst bilgisi için varsayılan x-ms-file-permission değeri kullanılır. Create Permission API'sini çağırarak anahtarı oluşturabilirsiniz.
x-ms-file-attributes	Gerekli: sürüm 2019-02-02 - 2021-04-10. İsteğe bağlı: sürüm 2021-06-08 ve üzeri. Bu üst bilgi, dosyada ayarlanacak dosya sistemi özniteliklerini içerir. Daha fazla bilgi için kullanılabilir özniteliklerin listesine bakın. Varsayılan değer None.
x-ms-file-property-semantics: { New ¦ Restore }	Opsiyonel. 2026-02-06 veya daha sonraki sürümlerde destekleniyor. Varsayılan değer New. New / Restore Semantik, başlığın x-ms-file-permission dosyaya nasıl uygulanacağını ayarlar. Başlık x-ms-file-permission olarak inheritayarlandığında, bu anlamsal bilgiler dosya izni üzerinde hiçbir etkisi yoktur. Belirli bir izin başlık x-ms-file-permission kullanılarak belirtildiğinde, New anlam sistemi varsayılan win32 dosya oluşturma kurallarını kullanır ve ana dizin izinlerine göre belirlenmiş biraz farklı bir izni uygulayabilir; Restore semantikler ise varsayılan güncelleme semantiklerini kullanır ve iznleri dosyaya tam olarak belirtildiği gibi atar. New semantik, başlıkta x-ms-file-attributes belirtilmemiş olsa bile dosyaya Arşiv özniteliğini ekler.

Yalnızca NFS istek üst bilgileri

İstek üst bilgisi	Açıklama
x-ms-mode	Opsiyonel. 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. Varsayılan değer 0644'dür. bkz. POSIX dosya izinleri (mod).
x-ms-owner	Opsiyonel. Sürüm 2025-05-05 ve üzeri. Dosya üzerinde ayarlanacak dosya sahibinin kullanıcı tanımlayıcısı (UID). Varsayılan değer 0'dır (kök).
x-ms-group	Opsiyonel. Sürüm 2025-05-05 ve üzeri. Dosya üzerinde ayarlanacak dosya sahibinin grup tanımlayıcısı (GID). Varsayılan değer 0'dır (kök grup).
x-ms-file-file-type	Opsiyonel. Sürüm 2025-05-05 ve üzeri. Dosyanın türü. Varsa 'Normal' olmalıdır.

İstek gövdesi

Hiç yoksa, Content-Length sıfırdır. Başlık sıfır değilse gereklidir Content-Length . Bu, 2026-02-06 veya daha sonraki sürümlerde desteklenmektedir. İstek gövdesinde ve İçerik-Uzunluğu başlığında belirtilen bayt sayısı, oluşturma dosyası ile veri işlemini gerçekleştirmek için eşleşmelidir. İstek gövdesinde belirtilebilecek maksimum bayt sayısı 4MiB'dir.

Örnek istek

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT  
Content-Type: text/plain; charset=UTF-8  
x-ms-content-length: 1024  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  

Başlık ile örnek talebi Content-Length

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1  
  
Request Headers:  
x-ms-version: 2026-02-06
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT  
Content-Type: text/plain; charset=UTF-8  
x-ms-content-length: 1024
Content-Length: 512
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  

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 201 (Oluşturuldu) 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 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, 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 istek 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 Azure Dosyalar 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-request-server-encrypted: true/false	Sürüm 2017-04-17 ve üzeri. Belirtilen algoritmayı kullanarak isteğin içeriğini başarıyla şifrelediyseniz, bu üst bilginin değeri true olarak ayarlanır. Şifreleme başarısız olursa, değeri falseolur.
x-ms-file-creation-time	Dosyanın oluşturma zamanı özelliğini temsil eden UTC tarih/saat değeri.
x-ms-file-last-write-time	Dosyanın son yazma zamanı özelliğini temsil eden UTC tarih/saat değeri.
x-ms-file-change-time	Dosyanın değişiklik zamanı özelliğini temsil eden UTC tarihi/saati.
x-ms-file-file-id	Dosyanın dosya kimliği.
x-ms-file-parent-id	Dosyanın üst dosya kimliği.
Content-MD5	2026-02-06 ve sonrası sürümler. İstemcinin ileti içerik bütünlüğünü denetleyebilmesi için bu üst bilgi döndürülür. Bu üst bilginin değeri Dosya hizmeti tarafından hesaplanır.
x-ms-client-request-id	İstekleri ve karşılık gelen yanıtlarını gidermek için kullanılır. 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. Dosyanın izninin anahtarı.
x-ms-file-attributes	Sürüm 2019-02-02 ve üzeri. Dosyanın 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. Dosyanın modu. bkz. POSIX dosya izinleri (mod).
x-ms-owner	Sürüm 2025-05-05 ve üzeri. Dosya sahibinin kullanıcı tanımlayıcısı (UID).
x-ms-group	Sürüm 2025-05-05 ve üzeri. Dosya 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ğer: 'Regular'.

Yanıt gövdesi

Hiç kimse.

Örnek yanıt

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
Date: Mon, 27 Jan 2014 23:00:12 GMT  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT  
x-ms-version: 2014-02-14  
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çenekleriyle 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	Arka plan veri bütünlüğü tarayıcısı tarafından okunması kullanıcı veri akışı. 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

Yeni bir dosya oluşturmak için önce Create File çağırarak ve en fazla boyutunu (en fazla 4 TiB) belirterek dosyayı başlatın. Bu işlemi gerçekleştirirken, istek gövdesine içerik eklemeyin. Dosyayı oluşturduktan sonra, dosyaya içerik eklemek veya dosyayı değiştirmek için Put Range çağırın.

2026-02-06 ve sonrasındaki sürümlerden itibaren, istek gövdesinde içerik sağlayarak 4MiB'ye kadar veri içeren dosya oluşturabilirsiniz. Veriyle dosya oluşturduktan sonra, dosyaya daha fazla veri eklemek veya onu değiştirmek için ara Put Range . Oluşturulan dosyanın maksimum boyutu 4 TiB'ye kadar değişir.

Set File Propertiesçağırarak dosyanın boyutunu değiştirebilirsiniz.

Paylaşım veya üst dizin yoksa işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu).

Not

, cache-control, content-type, content-md5ve content-encodingcontent-languagedosya özellikleri, SMB istemcilerinin kullanabileceği dosya sistemi özelliklerinden ayrıdır. SMB istemcileri bu özellik değerlerini okuyamaz, yazamaz veya değiştiremez.

Dosyayı oluşturmak için, mevcut dosyanın etkin bir kirası varsa istemcinin istekte geçerli bir kira kimliği belirtmesi gerekir. İstemci kiralama kimliği belirtmezse veya geçersiz bir kira kimliği belirtirse, Azure Dosyalar 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, Azure Dosyalar bu örnekte 412 (Önkoşul Başarısız) durum kodunu da döndürür. İstemci henüz var olmayan bir dosyada kira kimliği belirtirse, Azure Dosyalar sürüm 2019-02-02 ve sonraki sürümlere göre yapılan istekler için durum kodu 412 (Önkoşul Başarısız) döndürür.

Etkin kiraya sahip mevcut bir dosyanın üzerine bir Create File işlemi yazılırsa, kira, yayımlanana kadar güncelleştirilmiş dosyada kalır.

Create File, 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) durum koduyla başarısız oluyor.

Ayrıca bkz.

Dosyalarda İşlemleri