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. 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 da 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 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üntülenemez. Bu karakterlerin listesi için bkz. Kapsayıcı veya blob adlarında desteklenmeyen Unicode karakterler.

NTFS dosya adlarında geçerli olan \uE000 gibi kod noktaları geçerli Unicode karakterleri olmadığından kullanılamaz. Ayrıca, denetim karakterleri (0x1F, \u0081 vb. için 0x00) gibi bazı ASCII veya Unicode karakterlerine 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ı oluştururken, bu kapsayıcı için aşağıdaki adlandırma kurallarına uygun geçerli bir DNS adı belirtmeniz gerekir:

  • Kapsayıcı adları bir harf veya sayı ile başlamalı veya bitmelidir ve yalnızca harf, sayı ve tire (-) karakterini içerebilir.

  • Her tire (-) karakterinin hemen önünde ve arkasında bir harf veya rakam bulunmalıdır; kapsayıcı adlarında art arda tirelere 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.

Blob Adları

Blob adı aşağıdaki adlandırma kurallarına uymalıdır:

  • 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ü, 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ını oluşturan yolun bölümleri 254 karakterden uzun olamaz. Yol kesimi, ardışık sınırlayıcı karakterleri (örneğin, eğik çizgi '/') arasındaki ve sanal dizinin adına karşılık gelen dizedir.

Not

Nokta (.), eğik çizgi (/) veya ikisinin dizisi veya birleşimiyle biten blob adlarından kaçının. Hiçbir yol kesimi nokta (.) ile bitmemelidir.

Blob hizmeti hiyerarşik bir düzen değil düz bir depolama şemasını 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 bir 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 bir 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 kök kapsayıcıya sahip olabilir. Kök kapsayıcıdaki bir bloba kapsayıcı adlandırılmadan başvurabilir veya kök kapsayıcıya adıyla ($root) açıkça başvurulabilir. Daha fazla bilgi için bkz. Kök Kapsayıcıyla Ç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ü, bir blobun anlık görüntü oluşturulduğu sırada olduğu gibi depolanan 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ü blob 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ünün URI'si aşağıdaki gibi oluşturulur:

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

Kapsayıcı veya blob adlarında desteklenmeyen Unicode karakterler

Aşağıdaki tabloda, kapsayıcı veya blob adlarında desteklenmeyen Unicode karakterlerin listesi sağlanır:

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

Ayrıca bkz.