Dizin Oluştur

Create Directory işlemi, 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ü	Mevcut
SMB
NFS	Yok

İstek

Create Directory isteğini aşağıdaki gibi oluşturabilirsiniz. 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

Aşağıdaki tabloda gösterildiği gibi, istek URI'sindeki 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ı.
myparentdirectorypath	Opsiyonel. mydirectory oluşturulacağı üst dizinin yolu. Üst dizin yolu atlanırsa, dizin belirtilen paylaşım içinde oluşturulur. Üst dizin belirtilirse, mydirectoryoluşturabilmeniz için önce paylaşımda zaten var 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	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 gövdesi

Hiç kimse.

İstek üst bilgileri

Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tabloda açıklanmıştır:

Parametre	Açıklama
Authorization	Gerekli. Yetkilendirme düzenini, hesap adını ve imzayı belirtir. Daha fazla bilgi için bkz. azure depolamaistekleri 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 depolamaistekleri 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	Opsiyonel. 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> ¦ <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 dizinin 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 kibibayttan (KiB) büyükse bu üst bilgi kullanılabilir. Aksi takdirde, x-ms-file-permission-keykullanabilirsiniz. Belirtilmişse 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. Not: x-ms-file-permission veya x-ms-file-permission-keybelirtebilirsiniz. Üst bilgi belirtilmezse varsayılan inherit değeri kullanılır.
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-key inheritolarak ayarlandıysa, bu üst bilgi ayarlanmamalıdır. x-ms-file-permission-key inheritdışında bir değere ayarlanırsa ve bu üst bilgi ayarlanmadıysa varsayılan sddl değeri 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, 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. Create-Permission API'sini kullanarak bu anahtarı oluşturabilirsiniz. Not: x-ms-file-permission veya x-ms-file-permission-keybelirtebilirsiniz. Üst bilgi belirtilmezse, x-ms-file-permission üst bilgisi için varsayılan inherit değeri 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 now değerini kullanabilirsiniz. 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 veya üzeri. Dizin için 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-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-change-time: { now ¦ <DateTime> }	Opsiyonel. Iso 8601 biçimindeki dizin için Eşgüdümlü Evrensel Saat (UTC) değiştirme zamanı özelliği. Sürüm 2021-06-08 ve daha yeni. İsteğin zamanını belirtmek için now değerini kullanabilirsiniz. Varsayılan değer now.
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 eklenmişse 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. Daha fazla bilgi için bkz. Paylaşımları, dizinleri, dosyaları ve meta verileriadlandırma ve 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 bilgilerHTTP/1.1 protokol belirtimine uygundur.

Yanıt üst bilgisi	Açıklama
ETag	Dizinin sürümünü temsil eden, tırnak içine alınmış bir değer içerir.
Last-Modified	Dizinin 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 İşlemlerisorunları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 aksi takdirde false bu üst bilginin değeri true olarak ayarlanır.
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	Dizinin 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 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 ilgili 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 x-ms-client-request-id üst bilgisinin değerine eşittir. İstekte x-ms-client-request-id üst bilgisi yoksa, yanıtta bu üst bilgi yoktur.

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 dizin.
Gizli	FILE_ATTRIBUTE_HIDDEN	Dizin gizlidir. Sıradan bir dizin listesine dahil değildir.
Sistem	FILE_ATTRIBUTE_SYSTEM	İşletim sisteminin bir bölümünü kullandığı veya özel olarak kullandığı bir dizin.
Hiç kimse	FILE_ATTRIBUTE_NORMAL	Başka öznitelikleri ayarlı olmayan bir dizin. Bu öznitelik yalnızca tek başına kullanıldığında geçerlidir.
Dizin	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 okunması kullanıcı veri akışı. Bu dosya sistemi özniteliği öncelikle Windows ile uyumluluk sağlamak için sunulur.

Açıklamalar

Create Directory çağrıldığında 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 bir Create Directory işlemiyle 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

Ayrıca bkz.

dizinlerde İşlemleri