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.
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 |
Opsiyonel. Varsa sıfır olmalıdır. |
x-ms-content-length: byte value |
Gerekli. Bu üst bilgi, dosya için en fazla 4 tebibayt (TiB) boyutu belirtir. |
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. |
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. |
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ç kimse.
Ö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=
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. |
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.
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