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. Bu işlem, NFS protokolü etkinleştirilmiş Dosya Paylaşımları için 2025-05-05 ve sonraki sürümlerde desteklenir.
Protokol kullanılabilirliği
| Etkin dosya paylaşımı protokolü | Mevcut |
|---|---|
| SMB |
|
| NFS |
|
İstek
Create Directory 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/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 üst bilgileri
Gerekli ve isteğe bağlı istek üst bilgileri aşağıdaki tablolarda açıklanmıştır:
Ortak istek üst bilgileri
| İstem başlığı | 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. |
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-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-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
| İstem başlığı | Açıklama |
|---|---|
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-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
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> |
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, inherit üst bilgisi için varsayılan x-ms-file-permission 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. |
Yalnızca NFS istek üst bilgileri
| İstem başlığı | Açıklama |
|---|---|
x-ms-mode |
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 0755'tir. bkz. POSIX dosya izinleri (mod). bkz. POSIX dosya izinleri (mod). |
x-ms-owner |
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 |
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). |
İstek gövdesi
Hiç kimse.
Ö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 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 |
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 İş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 aksi takdirde true bu üst bilginin değeri false olarak ayarlanır. |
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. |
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. Dizinin izninin anahtarı. |
x-ms-file-attributes |
Sürüm 2019-02-02 ve üzeri. Dizindeki 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. Dizinin modu. bkz. POSIX dosya izinleri (mod). |
x-ms-owner |
Sürüm 2025-05-05 ve üzeri. Dizin sahibinin kullanıcı tanımlayıcısı (UID). |
x-ms-group |
Sürüm 2025-05-05 ve üzeri. Dizin 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: Directory. |
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. |
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
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 oluyor
Ayrıca bkz.
Dizinlerde İşlemleri