Aracılığıyla paylaş

Paylaşımları, dizinleri, dosyaları ve meta verileri adlandırma ve başvurma

Depolama hesabı sıfır veya daha fazla Azure dosya paylaşımı içerebilir. Paylaşım özellikler, meta veriler ve sıfır veya daha fazla dosya veya dizin içerir. Dizin özellikleri ve sıfır veya daha fazla dosya veya dizin içerir. Dosya, ikili verilerden, özelliklerden ve meta verilerden oluşan herhangi bir tek varlıktır.

Kaynak adları

Bir paylaşıma, dizine veya dosyaya başvurmak için URI benzersiz olmalıdır. Belirli bir depolama hesabında her paylaşımın benzersiz bir adı olmalıdır. Belirli bir paylaşım veya dizin içindeki her dosyanın da bu paylaşım veya dizin içinde benzersiz bir adı olmalıdır.

Adlandırma kurallarını ihlal eden bir ada sahip bir paylaşım, dizin veya dosya oluşturmaya çalışırsanız, istek 400 (Hatalı İstek) durum koduyla başarısız olur.

Adları paylaşma

Dosya hizmeti paylaşım adları kuralları, SMB paylaşım adları için SMB protokolü tarafından belirtilenden daha kısıtlayıcıdır, böylece Blob ve Dosya hizmetleri kapsayıcılar ve paylaşımlar için benzer adlandırma kurallarını paylaşabilir. Paylaşımlar için adlandırma kısıtlamaları aşağıdaki gibidir:

  • Paylaşım adı geçerli bir DNS adı olmalıdır.
  • Paylaşım adları bir harf veya sayı ile başlamalıdır ve yalnızca harf, sayı ve kısa çizgi/eksi (-) karakterini içerebilir.
  • Her kısa çizgi/eksi (-) karakterinin hemen önüne ve ardından bir harf veya sayı gelmelidir; paylaşım adlarında ardışık kısa çizgilere izin verilmez.
  • Paylaşım adındaki tüm harfler küçük harf olmalıdır.
  • Paylaşım adları 3 ile 63 karakter uzunluğunda olmalıdır.

Aşağıdaki tablo, Azure Dosyalar ve Azure Blob depolama için adlandırma kısıtlamalarını karşılaştırır:

Kapsayıcıları, Blobları ve Meta Verileri adlandırma ve başvurma SMB Paylaşım Adı Kısıtlamaları
• Kapsayıcı adı geçerli bir DNS adı olmalıdır.
• Kapsayıcı adları bir harf veya sayı ile başlamalıdır ve yalnızca harf, sayı ve kısa çizgi/eksi (-) karakterini içerebilir.
• Her kısa çizgi/eksi (-) karakterinin hemen önüne ve ardından bir harf veya sayı gelmelidir; kapsayıcı adlarında ardışık kısa çizgilere izin verilmez.
• Kapsayıcı adındaki tüm harfler küçük harf olmalıdır.
• Kapsayıcı adları 3 ile 63 karakter uzunluğunda olmalıdır.		 • Paylaşım adı en fazla 80 karakter uzunluğunda olmalıdır.
• Paylaşım adında aşağıdaki karakterler geçersizdir: \ / [ ] : ¦ < > + = ; , * ? "
• 0x1F(dahil) aracılığıyla 0x00 aralıktaki denetim karakterleri paylaşım adında geçersizdir.
• Diğer tüm Unicode karakterler yasaldır.
• Adlar büyük/küçük harf koruyucu ve büyük/küçük harfe duyarlı değildir.

Dizin ve dosya adları

Azure Dosyalar, dizin ve dosya adları için aşağıdaki adlandırma kurallarını uygular:

  • Dizin ve dosya adları büyük/küçük harf koruma ve büyük/küçük harfe duyarlı değildir.
  • Dizin ve dosya bileşeni adları en fazla 255 karakter uzunluğunda olmalıdır.
  • Dizin adları eğik çizgi karakteriyle (/) bitemez. Sağlanırsa, otomatik olarak kaldırılır.
  • Dosya adları eğik çizgi karakteriyle (/) bitmemelidir.
  • Ayrılmış URL karakterlerinin düzgün bir şekilde kaçışı yapılmalıdır.
  • Aşağıdaki karakterlere izin verilmez: " \ / : | < > * ?
  • Geçersiz URL yolu karakterlerine izin verilmez. NTFS dosya adlarında geçerli olsa da \uE000gibi kod noktaları geçerli Unicode karakterleri değildir. Ayrıca, denetim karakterleri (0x000x1F) gibi bazı ASCII veya Unicode karakterlerine de izin verilmez. HTTP/1.1'de Unicode dizelerini yöneten kurallar için bkz. RFC 2616, Bölüm 2.2: Temel Kurallar ve rfc 3987 .
  • Geçersiz Unicode karakterleri (geçersiz vekil çiftler olarak adlandırılır) desteklenmez.
  • Şu dosya adlarına izin verilmez: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, nokta karakteri (.) ve iki nokta karakteri (..).
  • Sürüm 2021-12-02'den başlayarak, dizin ve dosya adları tüm işlemler boyunca U+FFFE ve U+FFFF karakterlerini destekler. Bu karakterler SMB ve REST protokolleri aracılığıyla da desteklenir. Liste Dizini ve Dosyaları ve Liste Tanıtıcıları işlemleri, ilgili belgelerde belirtildiği gibi bu karakterler için özel işleme gerektirir.

Varsayılan olarak SMB protokolü etkinleştirilmiş Dosya Paylaşımları için dizin sonundaki nokta (.) karakterler ve istek URL'lerindeki dosya adları yoksayılır veya dışarıda bırakılır.

  • Örneğin, file1... adlı bir dosya oluşturulursa, sonundaki noktalar yoksayılır ve file1 adlı bir dosya oluşturulur. Aynı durum yoldaki dizinler için de geçerlidir. Dosya oluşturma isteği yol \Dir1\Dir2…\File1 içeriyorsa, dosya \Dir1\Dir2\File1konumunda oluşturulur.
  • Ancak, 2022-11-02sürümünden başlayarak, üst bilgi x-ms-allow-trailing-dot URL isteğindeki true olarak ayarlanarak varsayılan davranış geçersiz kılınabilir.
  • Örneğin, file1... adlı bir dosya oluşturmak ve sondaki noktaları eklemek istiyorsanız, x-ms-allow-trailing-dot istek üst bilgisine eklenip trueolarak ayarlanmalıdır. Aynı durum dizin adları oluşturmak için de geçerlidir.
  • Dosya kopyalama isteğinde, kaynak dosya adına sondaki noktaları eklemek istiyorsanız, x-ms-source-allow-trailing-dot üst bilgisi trueolarak ayarlanmalıdır. Daha fazla bilgi için her rest API için kullanılabilir üst bilgi seçeneklerine göz atın.

NFS protokolü etkinleştirilmiş Dosya Paylaşımları için varsayılan olarak, dizin sonundaki nokta (.) karakterler ve istek URL'lerindeki dosya adları yoksayılmaz.

Aşağıdaki tablo, Azure Dosyalar ve Azure Blob depolama için adlandırma kısıtlamalarını karşılaştırır:

Kapsayıcıları, Blobları ve Meta Verileri adlandırma ve başvurma SMB Protokolü Adı Kısıtlamaları
• Blob adı en az bir karakter uzunluğunda olmalı ve 1.024 karakterden uzun olamaz.
• Blob adları büyük/küçük harfe duyarlıdır.
• Ayrılmış URL karakterleri doğru şekilde kaçılmalıdır.
• Blob adları eğik çizgi (/) gibi bir sanal dizin sınırlayıcısı ile bitebilir
• Geçersiz URL yolu karakterlerine izin verilmiyor: NTFS dosya adlarında geçerliyken \uE000gibi kod noktaları geçerli Unicode karakterler değildir. Ayrıca, denetim karakterleri (0x1F 0x00) gibi bazı ASCII veya Unicode karakterlerine de izin verilmez. HTTP/1.1'de Unicode dizelerini yöneten kurallar için bkz. RFC 2616, Bölüm 2.2: Temel Kurallar ve rfc 3987 .		 • Yol adı en fazla 32.760 karakter uzunluğunda olabilir.
• Her yol adı bileşeni (dosya/dizin) en fazla 255 karakter uzunluğunda olabilir.
• Yol adı, (\) ters eğik çizgi karakteriyle ayrılmış bir veya daha fazla yol adı bileşeninden oluşur.
• Yol adı büyük/küçük harf koruyucu ve büyük/küçük harfe duyarlı değildir (yalnızca büyük/küçük harfe izin verilmeyen iki ad).
• Dosya yolu ile aynı dizin yolu olamaz.
• Bileşen adında aşağıdaki karakterler geçersizdir: \ / : ¦ < > * ? "
• 0x1F(dahil) aracılığıyla 0x00 aralıktaki denetim karakterleri paylaşım adında geçersizdir.

Yol adları

Yol adı, eğik çizgi (/) karakteriyle ayrılmış bir veya daha fazla yol adı bileşeninden (dizin veya dosya adı) oluşur. Son yol adı bileşeni dışındaki tüm yol adı bileşenleri dizinleri belirtir. Son yol adı bileşeni bir dizini veya dosyayı belirtir. Aşağıdaki adlandırma kuralları geçerlidir:

  • Yol adı en fazla 2.048 karakter uzunluğunda olabilir. Yoldaki tek tek bileşenler en fazla 255 karakter uzunluğunda olabilir.
  • Yol adı, eğik çizgi (/) karakteriyle ayrılmış bir veya daha fazla yol adı bileşeninden oluşur.
  • Yoldaki alt dizinlerin derinliği 250'yi aşamaz.
  • Aynı ad, aynı üst dizini paylaşan bir dosya ve dizin için kullanılamaz. Örneğin, her data adlı bir dosya ve dizin aynı üst yol altında bulunamaz.

Meta veri adları

Bir paylaşım veya dosya kaynağının meta verileri, kaynakla ilişkili ad-değer çiftleri olarak depolanır. Meta veri adları, C# tanımlayıcıları için adlandırma kurallarına uymalıdır.

Meta veri adları oluşturuldukları büyük/küçük harf durumunu korur, ancak ayarlanırken veya okunurken büyük/küçük harfe duyarlı değildir. Bir kaynak için aynı ada sahip iki veya daha fazla meta veri üst bilgisi gönderilirse, Azure Dosya hizmeti durum kodu 400 (Hatalı İstek) döndürür.

Kaynak URI söz dizimi

Her kaynağın kendisine başvuran karşılık gelen bir temel URI'leri vardır. Depolama hesabı için temel URI yalnızca hesabın adını içerir:

https://myaccount.file.core.windows.net

Bir paylaşım için temel URI hesabın adını ve paylaşımın adını içerir:

https://myaccount.file.core.windows.net/myshare

Bir dizin için temel URI hesabın adını, paylaşımın adını ve dizinin yolunu içerir:

https://myaccount.file.core.windows.net/myshare/myparentdir/mydir

Bir dosya için temel URI hesabın adını, paylaşımın adını ve dosyanın yolunu içerir:

https://myaccount.file.core.windows.net/myshare/myfile  
https://myaccount.file.core.windows.net/myshare/mydir/myfile  
https://myaccount.file.core.windows.net/myshare/myparentdir/mydir/myfile

Ayrıca bkz.

  • Last updated on