Kapsayıcıları, Blobları ve Meta Verileri Adlandırma ve Buna Başvurma
Bu konu, kapsayıcıları, blobları, meta verileri ve anlık görüntüleri adlandırmayı ve bunlara başvurmayı açıklar. Depolama hesabı sıfır veya daha fazla kapsayıcı içerebilir. Kapsayıcı özellikler, meta veriler ve sıfır veya daha fazla blob içerir. Hesabınızda hiyerarşik ad alanı varsa kapsayıcı sıfır veya daha fazla dizin içerebilir ve bu dizinler sıfır veya daha fazla blob içerebilir. Blob, ikili verilerden, özelliklerden ve meta verilerden oluşan herhangi bir tek varlıktır.
Kaynak Adları
Bir kapsayıcıya veya bloba başvurmak için URI benzersiz olmalıdır. Her hesap adı benzersiz olduğundan, iki hesap aynı ada sahip kapsayıcılara sahip olabilir. Ancak, belirli bir depolama hesabı içinde her kapsayıcının benzersiz bir adı olmalıdır. Belirli bir kapsayıcı içindeki her blob aynı zamanda bu kapsayıcı içinde benzersiz bir ada sahip olmalıdır.
Adlandırma kurallarını ihlal eden bir ada sahip bir kapsayıcı veya blob oluşturmaya çalışırsanız, istek 400 (Hatalı İstek) durum koduyla başarısız olur.
Blob ve kapsayıcı adları bir URL içindeki Blob hizmetine geçirilir. UTF-8 (tercih edilen) veya MBCS kullanılarak belirli karakterlerin URL'de görünmesi için yüzde olarak kodlanmış olması gerekir. Bu kodlama, Azure Depolama istemci kitaplıklarını kullandığınızda otomatik olarak gerçekleşir. Ancak, kodlandığında bile URL yollarında geçerli olmayan bazı karakterler vardır. Bu karakterler blob veya kapsayıcı adlarında görünüyorsa istek başarısız olabilir. Bu karakterlerin listesi için bkz. Kapsayıcı veya blob adlarında kullanılması önerilmez Unicode karakterleri.
NTFS dosya adlarında geçerliyken \uE000 gibi kod noktaları geçerli Unicode karakterleri olmadığından kullanılamazlar. Ayrıca, denetim karakterleri (0x1F, \u0081, vb. 0x00) gibi bazı ASCII veya Unicode karakterlere de izin verilmez.
HTTP/1.1'de Unicode dizelerini yöneten ek kurallar için bkz . RFC 2616, Bölüm 2.2: Temel Kurallar ve RFC 3987.
Kapsayıcı Adları
Kapsayıcı adı, aşağıdaki adlandırma kurallarına uygun geçerli bir DNS adı olmalıdır:
Kapsayıcı adları bir harf veya sayı ile başlamalı veya bitmelidir ve yalnızca harf, sayı ve kısa çizgi/eksi (-) karakterini içerebilir.
Her kısa çizgi/eksi (-) karakterinin hemen önüne ve arkasına bir harf veya sayı eklenmelidir; 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-63 karakter arası uzunlukta olmalıdır.
Dizin adları
Hesabınızın hiyerarşik ad alanı varsa, dizin adının aşağıdaki adlandırma kurallarına uyması gerekir:
Dizin adı herhangi bir karakter bileşimi içerebilir.
Dizin adı en az bir karakter uzunluğunda olmalı ve 1.024 karakterden uzun olamaz.
Dizin adları büyük/küçük harfe duyarlıdır.
Ayrılmış URL karakterleri doğru şekilde atlanmalıdır.
Not
Nokta (.), eğik çizgi (/), ters eğik çizgi (\) veya ikisinin dizisi veya birleşimiyle biten dizin adlarından kaçının. Hiçbir yol kesimi nokta (.) ile bitmemelidir.
Blob Adları
Blob adı aşağıdaki adlandırma kurallarına uymalıdır. Bu kurallar, aksi belirtilmediği sürece hiyerarşik ad alanına sahip hesaplardaki bloblar için de geçerlidir.
Blob adı herhangi bir karakter bileşimi içerebilir.
Blob adı en az bir karakter uzunluğunda olmalı ve Azure Depolama'daki bloblar için 1.024 karakterden uzun olamaz.
Azure Depolama öykünücüsü en fazla 256 karakter uzunluğunda blob adlarını destekler. Daha fazla bilgi için bkz. Geliştirme ve test için Azure depolama öykünücüsü kullanma.
Blob adları büyük/küçük harfe duyarlıdır.
Ayrılmış URL karakterleri doğru şekilde atlanmalıdır.
Blob adından oluşan yol kesimlerinin sayısında sınırlamalar vardır. Yol kesimi, dizine veya sanal dizine karşılık gelen ardışık sınırlayıcı karakterleri (örneğin eğik çizgi
/) arasındaki dizedir. Aşağıdaki yol kesimi sınırlamaları blob adlarına uygulanır:- Depolama hesabında hiyerarşik ad alanı etkin değilse, blob adından oluşan yol kesimlerinin sayısı 254'ü aşamaz.
- Depolama hesabında hiyerarşik ad alanı etkinleştirildiyse blob adından oluşan yol kesimlerinin sayısı 63'ü aşamaz (hesap adı ve kapsayıcı adı için yol kesimleri dahil).
Not
Nokta (.), eğik çizgi (/), ters eğik çizgi (\) veya ikisinin dizisi veya birleşimiyle biten blob adlarından kaçının. Hiçbir yol kesimi nokta (.) ile bitmemelidir.
Varsayılan olarak, Blob hizmeti hiyerarşik bir şemayı değil düz bir depolama düzenini temel alır. Ancak, sanal hiyerarşi oluşturmak için blob adı içinde bir karakter veya dize sınırlayıcısı belirtebilirsiniz. Örneğin, aşağıdaki listede geçerli ve benzersiz blob adları gösterilir. Bir dizenin hem blob adı hem de aynı kapsayıcıdaki sanal dizin adı olarak geçerli olabileceğine dikkat edin:
/A
/a.txt
/a/b
/a/b.txt
Blobları numaralandırırken sınırlayıcı karakterden yararlanabilirsiniz.
Meta Veri Adları
Kapsayıcı veya blob kaynağının meta verileri, kaynakla ilişkilendirilmiş 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ının oluşturuldukları büyük/küçük harf durumunu koruduğunu, ancak ayarlandığında veya okunduğunda büyük/küçük harfe duyarsız olduğunu unutmayın. Bir kaynak için aynı ada sahip iki veya daha fazla meta veri üst bilgisi gönderilirse Blob hizmeti 400 (Hatalı İstek) durum kodunu döndürür.
Kaynak URI Söz Dizimi
Her kaynağın kendisine karşılık gelen temel URI'leri vardır.
Depolama hesabı için temel URI yalnızca hesabın adını içerir:
https://myaccount.blob.core.windows.net
Kapsayıcı için temel URI hesabın adını ve kapsayıcının adını içerir:
https://myaccount.blob.core.windows.net/mycontainer
Blob için temel URI hesabın adını, kapsayıcının adını ve blobun adını içerir:
https://myaccount.blob.core.windows.net/mycontainer/myblob
Depolama hesabı, URI'den atlanabilen varsayılan bir kapsayıcı olan bir kök kapsayıcıya sahip olabilir. Kök kapsayıcıdaki bir bloba, kapsayıcı adlandırılmadan başvurulabilir veya kök kapsayıcıya adıyla ($root) açıkça başvurulabilir. Daha fazla bilgi için bkz. Kök Kapsayıcı ile Çalışma . Aşağıdaki URI'lerin her ikisi de kök kapsayıcıdaki bir bloba başvurur:
https://myaccount.blob.core.windows.net/myblob
https://myaccount.blob.core.windows.net/$root/myblob
Blob Anlık Görüntüleri
Anlık görüntü, anlık görüntü oluşturulduğu sırada olduğu gibi depolanan bir blobun salt okunur bir sürümüdür. Blobun yedeklemesini veya denetim noktasını oluşturmak için anlık görüntüleri kullanabilirsiniz. Anlık görüntü blobu adı, temel blob URI'sinin yanı sıra anlık görüntünün ne zaman oluşturulduğunu belirten bir tarih-saat değeri içerir.
Örneğin, bir blobda aşağıdaki URI'nin bulunduğunu varsayalım:
https://myaccount.blob.core.windows.net/mycontainer/myblob
Bu blobun anlık görüntüsü için URI aşağıdaki gibi oluşturulur:
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
Kapsayıcı veya blob adlarında kullanılması önerilmez Unicode karakterleri
Aşağıdaki tabloda, kapsayıcı veya blob adlarında kullanılması önerilmeyen Unicode karakterlerin listesi sağlanır. Bu karakterler, bu listedeki diğer karakterlerle birlikte kullanıldığında UTF-8 veya MBCS kod çözmede başarısız olabilir ve bu da Blob hizmetine yönelik isteğin başarısız olmasına neden olabilir.
| Unicode karakter |
|---|
| U+0080 |
| U+0082 |
| U+0083 |
| U+0084 |
| U+0085 |
| U+0086 |
| U+0087 |
| U+0088 |
| U+0089 |
| U+008A |
| U+008B |
| U+008C |
| U+008E |
| U+0091 |
| U+0092 |
| U+0093 |
| U+0094 |
| U+0095 |
| U+0096 |
| U+0097 |
| U+0098 |
| U+0099 |
| U+009A |
| U+009B |
| U+009C |
| U+009E |
| U+009F |
| U+FDD1 |
| U+FDD2 |
| U+FDD3 |
| U+FDD4 |
| U+FDD5 |
| U+FDD6 |
| U+FDD7 |
| U+FDD8 |
| U+FDD9 |
| U+FDDA |
| U+FDDB |
| U+FDDC |
| U+FDDE |
| U+FDDF |
| U+FDE0 |
| U+FDE1 |
| U+FDE2 |
| U+FDE3 |
| U+FDE4 |
| U+FDE5 |
| U+FDE6 |
| U+FDE7 |
| U+FDE8 |
| U+FDE9 |
| U+FDEA |
| U+FDEB |
| U+FDEC |
| U+FDED |
| U+FDEE |
| U+FDEF |
| U+FFF0 |
| U+FFF1 |
| U+FFF2 |
| U+FFF3 |
| U+FFF4 |
| U+FFF5 |
| U+FFF6 |
| U+FFF7 |
| U+FFF8 |
| U+FFF9 |
| U+FFFA |
| U+FFFB |
| U+FFFC |
| U+FFFD |
| U+FFFE |
| U+FFFF |
| U+1FFFE |
| U+1FFFF |
| U+2FFFE |
| U+2FFFF |
| U+3FFFE |
| U+3FFFF |
| U+5FFFE |
| U+5FFFF |
| U+6FFFE |
| U+6FFFF |
| U+7FFFE |
| U+7FFFF |
| U+9FFFE |
| U+9FFFF |
| U+AFFFE |
| U+AFFFF |
| U+BFFFE |
| U+BFFFF |
| U+DFFFE |
| U+DFFFF |
| U+EFFFE |
| U+EFFFF |
| U+FFFFE |
| U+FFFFF |