Dosya Oluştur
İşlem Create File
yeni bir dosya oluşturur veya bir dosyanın yerini alır. çağrısı Create File
yaptığınızda yalnızca dosyayı başlatırsınız. Dosyaya içerik eklemek için işlemi çağırırsınız Put Range
.
Protokol kullanılabilirliği
Etkin dosya paylaşımı protokolü | Kullanılabilir |
---|---|
SMB | |
NFS |
İstek
Aşağıdakileri yaparak bir Create File
istek oluşturabilirsiniz. HTTPS kullanmanızı öneririz.
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
PUT |
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 kendi yol bileşenlerinizle değiştirin:
Yol bileşeni | Açıklama |
---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
mydirectorypath |
İsteğe bağlı. 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 |
İ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) saatini 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. |
Content-Length |
İsteğe bağlı. Varsa sıfır olmalıdır. |
x-ms-content-length: byte value |
Gereklidir. Bu üst bilgi, dosya için en fazla 4 tebibayt (TiB) boyutu belirtir. |
Content-Type veya x-ms-content-type |
İsteğe bağlı. Dosyanın MIME içerik türü. Varsayılan tür: application/octet-stream . |
Content-Encoding veya x-ms-content-encoding |
İsteğe bağlı. 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 dosya içeriğinin kodunu çözmek için bunu kullanabilirsiniz. |
Content-Language veya x-ms-content-language |
İsteğe bağlı. Bu kaynak tarafından kullanılan doğal dilleri belirtir. |
Cache-Control veya x-ms-cache-control |
İsteğe bağlı. Azure Dosyalar bu değeri depolar ancak kullanmaz veya değiştirmez. |
x-ms-content-md5 |
İsteğe bağlı. Dosyanın MD5 karması ayarlar. |
x-ms-content-disposition |
İsteğe bağlı. Dosyanın Content-Disposition üst bilgisini ayarlar. |
x-ms-type: file |
Gereklidir. Bu üst bilgiyi olarak file ayarlayın. |
x-ms-meta-name:value |
İsteğe bağlı. 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-permission: { inherit ¦ <SDDL> } |
Sürüm 2019-02-02 ile 2021-04-10 arasında, 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 . Üst bilgiyi belirtirseniz, bir sahip, grup ve isteğe bağlı erişim denetimi listesi (DACL) olmalıdır. üst dizinden devralmak için değerini inherit geçirebilirsiniz. |
x-ms-file-permission-key: <PermissionKey> |
Sürüm 2019-02-02 ile 2021-04-10 arasında, 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. Üst bilgi belirtilmezse, üst bilgi için x-ms-file-permission varsayılan değeri inherit kullanılır.API'yi çağırarak Create Permission 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.
None varsayılan değerdir. |
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. değerini now isteğin zamanını belirtmek için kullanılabilir.
now varsayılan değerdir. |
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. Dosya için Eşgüdümlü Evrensel Saat (UTC) son yazma özelliği. İsteğin zamanını belirtmek için değerini now kullanabilirsiniz.
now 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. Eşgüdümlü Evrensel Saat (UTC) dosyası için ISO 8601 biçiminde saat özelliğini değiştirir. İ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.
Ö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 yanıt üst bilgileri kümesi 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 tabloda açıklanan ü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 | 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 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 zamanını 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 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ı true kullanarak isteğin içeriğini başarıyla şifrelediyseniz bu üst bilginin değeri olarak ayarlanır. Şifreleme başarısız olursa değeri olur false . |
x-ms-file-permission-key |
Dosyanın izninin anahtarı. |
x-ms-file-attributes |
Dosyadaki dosya sistemi öznitelikleri. Daha fazla bilgi için kullanılabilir özniteliklerin listesine bakın. |
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 saati özelliğini temsil eden UTC tarih/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 ilgili 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 üst bilginin değerine x-ms-client-request-id eşittir.
x-ms-client-request-id Üst bilgi istekte yoksa yanıtta mevcut değildir. |
Yanıt gövdesi
Yok.
Ö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
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 | 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 okunmayacak kullanıcı veri akışı. Bu dosya sistemi özniteliği öncelikle Windows ile uyumluluk sağlamak için sunulur. |
Açıklamalar
Yeni bir dosya oluşturmak için önce çağırarak Create File
ve en fazla 4 TiB boyutunu 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 çağrısında Put Range
bulunabilirsiniz.
çağırarak Set File Properties
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
, , content-type
content-md5
, content-encoding
ve content-language
dosya özelliklericache-control
, 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 bir kira kimliği belirtmezse veya geçersiz bir kira kimliği belirtirse, Azure Dosyalar durum kodu 412 (Önkoşul Başarısız oldu) döndürür. İstemci bir kira kimliği belirtiyorsa ancak dosyanın etkin kiralaması 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 kiralama kimliği belirtirse, Azure Dosyalar sürüm 2019-02-02 ve sonraki sürümlerde yapılan istekler için durum kodu 412 (Önkoşul Başarısız) döndürür.
Etkin kiraya sahip bir dosyanın üzerine bir Create File
işlem 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.