Dizin Oluştur
İşlem, Create Directory
belirtilen paylaşım veya üst dizin altında yeni bir dizin oluşturur. Dizin kaynağı, bu dizinin özelliklerini içerir. Dizinin içerdiği dosyaların veya alt dizinlerin listesini içermez.
Protokol kullanılabilirliği
Etkin dosya paylaşımı protokolü | Kullanılabilir |
---|---|
SMB | |
NFS |
İstek
İsteği aşağıdaki gibi oluşturabilirsiniz Create Directory
. HTTPS kullanmanızı öneririz.
Yöntem | İstek URI'si | HTTP sürümü |
---|---|---|
PUT |
https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
İstek URI'sindeki yol bileşenlerini aşağıdaki tabloda gösterildiği gibi kendi yol bileşenlerinizle değiştirin:
Yol bileşeni | Description |
---|---|
myaccount |
Depolama hesabınızın adı. |
myshare |
Dosya paylaşımınızın adı. |
myparentdirectorypath |
İsteğe bağlı. Mydirectory öğesinin oluşturulacağı üst dizinin yolu. Üst dizin yolu atlanırsa, dizin belirtilen paylaşım içinde oluşturulur. Üst dizin belirtilirse, mydirectory'yi oluşturabilmeniz için önce paylaşımın içinde mevcut olması gerekir. |
mydirectory |
Oluşturulacak dizinin adı. |
Yol adlandırma kısıtlamaları hakkında daha fazla 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 gövdesi
Yok.
İstek üst bilgileri
Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:
Parametre | Açıklama |
---|---|
Authorization |
Gereklidir. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. Azure Depolama isteklerini 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 isteklerini 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-meta-name:value |
İsteğe bağlı. Sürüm 2015-02-21 veya üzeri. Dizinle meta veri olarak ilişkilendirilecek bir ad-değer çifti. Meta veri adları , C# tanımlayıcıları için adlandırma kurallarına uymalıdır. |
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 dizinin güvenlik tanımlayıcısıdır. İzin boyutu 8 kibibayt (KiB) üzerindeyse bu üst bilgi kullanılabilir. Aksi takdirde kullanabilirsiniz x-ms-file-permission-key . Belirtildiyse, sahip, grup ve isteğe bağlı erişim denetim listesine (DACL) sahip olmalıdır. Üst dizinden devralmak için değerini inherit geçirebilirsiniz.Not: veya x-ms-file-permission-key belirtebilirsinizx-ms-file-permission . Üst bilgi belirtilmezse varsayılan değeri inherit kullanılır. |
x-ms-file-permission-key: <PermissionKey> |
Dizin için ayarlanacak iznin anahtarı. 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. API'yi kullanarak Create-Permission bu anahtarı oluşturabilirsiniz.Not: veya x-ms-file-permission-key belirtebilirsinizx-ms-file-permission . Üst bilgi belirtilmezse, üst bilgi için x-ms-file-permission varsayılan değeri inherit kullanılır. |
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. Dizinde ayarlanacak dosya sistemi öznitelikleri. Kullanılabilir özniteliklerin listesine bakın. Varsayılan değer Dizin'dir. |
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 daha yeni. Dizin için Eşgüdümlü Evrensel Saat (UTC) oluşturma zamanı özelliği. İsteğin zamanını belirtmek için değerini now kullanabilirsiniz. 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 veya üzeri. Dizin 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-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ı. Eşgüdümlü Evrensel Saat (UTC) dizininin saat özelliğini ISO 8601 biçiminde değiştirir. Sürüm 2021-06-08 ve daha yeni. İ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 yetkilendirilmiş kimliğe atanan RBAC ilkesine dahil edildiyse veya Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action izni verilmesi Authorization gerektiğini belirtirMicrosoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action . 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. |
Örnek istek
PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1
Request headers:
x-ms-version: 2014-02-14
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT
x-ms-meta-Category: Images
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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 daha fazla 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 | Description |
---|---|
ETag |
Dizinin sürümünü tırnak içine alınmış olarak temsil eden bir değer içerir. |
Last-Modified |
Dizinin en son değiştirildiği tarihi 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 İşlemleri 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 veya üzeri. İsteğin içeriği belirtilen algoritma kullanılarak başarıyla şifrelenirse ve false aksi takdirde bu üst bilginin değeri olarak ayarlanırtrue . |
x-ms-file-permission-key |
Dizinin izninin anahtarı. |
x-ms-file-attributes |
Dizindeki dosya sistemi öznitelikleri. Kullanılabilir özniteliklerin listesine bakın. |
x-ms-file-creation-time |
Dizin için oluşturma zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-last-write-time |
Dizinin son yazma zamanı özelliğini temsil eden UTC tarih/saat değeri. |
x-ms-file-change-time |
Dizinin değişiklik zamanı özelliğini temsil eden değerin UTC tarihi/saati. |
x-ms-file-file-id |
Dizinin dosya kimliği. |
x-ms-file-parent-id |
Dizinin üst dosya kimliği. |
x-ms-client-request-id |
İsteklerde ve karşılık gelen yanıtlarda sorun gidermek için kullanılabilir. Bu üst bilginin değeri, istekte mevcutsa ve değer 1024'ten fazla görünür ASCII karakteri içermiyorsa üst bilginin değerine x-ms-client-request-id eşittir. İstekte x-ms-client-request-id üst bilgi yoksa, yanıtta bu üst bilgi yoktur. |
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 dizin. |
Gizli | FILE_ATTRIBUTE_HIDDEN | Dizin 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 dizin. |
Hiçbiri | FILE_ATTRIBUTE_NORMAL | Başka öznitelikleri ayarlı olmayan bir dizin. Bu öznitelik yalnızca tek başına kullanıldığında geçerlidir. |
Directory | FILE_ATTRIBUTE_DIRECTORY | Bir dizini tanımlayan tanıtıcı. |
Arşiv | FILE_ATTRIBUTE_ARCHIVE | Arşiv dizini olan bir dizin. Uygulamalar normalde dosyaları yedekleme veya kaldırma amacıyla işaretlemek için bu özniteliği kullanır. |
Çevrimdışı | FILE_ATTRIBUTE_OFFLINE | Bir dizinin 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 | Dizin, 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
Çağrıldığında Create Directory
aynı ada sahip bir dizin siliniyorsa, sunucu 409 (Çakışma) durum kodunu döndürür ve dizinin silindiğini belirten ek hata bilgileri sağlar.
Aynı ada sahip bir dizin veya dosya zaten varsa, işlem 409 (Çakışma) durum koduyla başarısız olur. Üst dizin yoksa, işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu).
Tek Create Directory
bir işlemle dizin hiyerarşisi oluşturmak mümkün değildir. Dizini yalnızca, yolda belirtildiği gibi, hemen üst öğesi zaten varsa oluşturabilirsiniz. Üst dizin yoksa, işlem 412 durum koduyla başarısız olur (Önkoşul Başarısız oldu).
Create Directory
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 olur