Kapsayıcıları, Blobları ve Meta Verileri Adlandırma ve 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ızın hiyerarşik ad alanı varsa, kapsayıcı da 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ında 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ünüyorsa istek başarısız olabilir. Bu karakterlerin listesi için bkz.kapsayıcı veya blob adlarında kullanılması önerilmez
NTFS dosya adlarında geçerli olan \uE000gibi kod noktaları geçerli Unicode karakterleri olmadığından kullanılamaz. Ayrıca, denetim karakterleri (0x1F, \u0081vb. 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ı 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 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.
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 karakterlerinin düzgün bir şekilde kaçışı yapılmalı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 uygun olmalıdır. Bu kurallar, aksi belirtilmedikçe 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ü 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 karakterlerinin düzgün bir şekilde kaçışı yapılmalıdır.
Blob adını içeren yol kesimlerinin sayısıyla ilgili 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ı hiyerarşik ad alanı etkin yoksa, blob adını oluşturan yol kesimlerinin sayısı 254'ü aşamaz.
- Depolama hesabında hiyerarşik ad alanı etkinse, blob adını oluşturan 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 düzen 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 aynı kapsayıcıda hem blob adı hem de 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ı karakterinden yararlanabilirsiniz.
Meta Veri Anahtarı ve Değer Adları
Kapsayıcı veya blob kaynağının meta verileri, kaynakla ilişkilendirilmiş ad-değer çiftleri olarak depolanır. Meta veri anahtarı adları aşağıdaki adlandırma kurallarına uymalıdır:
Harf veya alt çizgiyle başlamalıdır
Aşağıdaki karakterler harf, sayı veya alt çizgi olabilir
Meta veri anahtarı adı geçerli ASCII olmalıdır
Meta veri değer adları da geçerli ASCII olmalıdır. Meta veri adlarının oluşturuldukları büyük/küçük harf durumunu koruduğuna, ancak ayarlandığında veya okunduğunda büyük/küçük harfe duyarlı olmadığını unutmayın. Bir kaynak için aynı ada sahip iki veya daha fazla meta veri üst bilgisi gönderilirse, Blob 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.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ının kök kapsayıcısı, URI'den atlanabilecek varsayılan kapsayıcısı 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ı ile çalışma
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ü blob adı, temel blob URI'sinin yanı sıra anlık görüntünün ne zaman oluşturulduğunu gösteren 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ı önerilmez Unicode karakterlerinin 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 karakteri |
|---|
| 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.
- Blob Depolama Hizmeti Kullanma
- blob kaynaklarını numaralandırmayı
- blob hizmeti kavramlarını
- kök kapsayıcı ile çalışma
- Anlık Görüntü Blobu