Tárolók, blobok és metaadatok elnevezése és hivatkozása
Ez a témakör a tárolók, blobok, metaadatok és pillanatképek elnevezését és hivatkozását ismerteti. A tárfiókok nulla vagy több tárolót tartalmazhatnak. A tárolók tulajdonságokat, metaadatokat és nulla vagy több blobot tartalmaznak. Ha a fiókja hierarchikus névtérrel rendelkezik, akkor a tárolók nulla vagy több címtárat is tartalmazhatnak, és ezek a könyvtárak nulla vagy több blobot is tartalmazhatnak. A blobok egyetlen entitások, amelyek bináris adatokból, tulajdonságokból és metaadatokból állnak.
Erőforrásnevek
A tárolóra vagy blobra hivatkozó URI-nak egyedinek kell lennie. Mivel minden fióknév egyedi, két fiók rendelkezhet ugyanazzal a névvel rendelkező tárolókkal. Egy adott tárfiókon belül azonban minden tárolónak egyedi névvel kell rendelkeznie. Egy adott tárolón belül minden blobnak egyedi névvel kell rendelkeznie a tárolóban.
Ha olyan nevű tárolót vagy blobot próbál létrehozni, amely megsérti az elnevezési szabályokat, a kérés a 400-ás állapotkóddal (hibás kérés) hiúsul meg.
A blob- és tárolónevek egy URL-címen belül lesznek átadva a Blob szolgáltatásnak. Bizonyos karaktereket százalékban kell kódolni ahhoz, hogy megjelenjenek egy URL-címben UTF-8 (előnyben részesített) vagy MBCS használatával. Ez a kódolás automatikusan megtörténik az Azure Storage-ügyfélkódtárak használatakor. Vannak azonban olyan karakterek, amelyek kódoláskor sem érvényesek az URL-címekben. Ha ezek a karakterek blob- vagy tárolónevekben jelennek meg, a kérés meghiúsulhat. A karakterek listáját a Tároló- vagy blobnevekben nem ajánlott Unicode-karakterek című témakörben találja.
Az olyan kódpontok, mint az \uE000, de az NTFS-fájlnevekben érvényesek, érvénytelen Unicode-karakterek, ezért nem használhatók. Ezenkívül néhány ASCII- vagy Unicode-karakter, például vezérlőkarakterek (0x00 0x1F, \u0081 stb.) szintén nem engedélyezettek.
A HTTP/1.1 Unicode-sztringekre vonatkozó további szabályokért lásd: RFC 2616, 2.2. szakasz: Alapvető szabályok és RFC 3987.
Tárolónevek
A tároló nevének egy érvényes DNS-névnek kell lennie, amely megfelel az alábbi elnevezési szabályoknak:
A tárolóneveknek betűvel vagy számmal kell kezdődniük vagy végződniük, és csak betűket, számokat és kötőjelet/mínusz (-) karaktert tartalmazhatnak.
Minden kötőjelet/mínuszjelet (-) közvetlenül meg kell előzni, és betűvel vagy számmal kell kiegészíteni; egymást követő kötőjelek nem használhatók a tárolónevekben.
A tároló nevében szereplő összes betűnek kisbetűnek kell lennie.
A tároló nevének 3–63 karakter hosszúságúnak kell lennie.
Címtárnevek
Ha a fiók hierarchikus névtérrel rendelkezik, akkor a címtárnévnek meg kell felelnie az alábbi elnevezési szabályoknak:
A címtárnevek bármilyen karakterkombinációt tartalmazhatnak.
A könyvtárnévnek legalább egy karakter hosszúságúnak kell lennie, és nem lehet hosszabb 1024 karakternél.
A címtárnevek megkülönböztetik a kis- és nagybetűket.
A fenntartott URL-karaktereket escape-karakterrel kell jelölni.
Megjegyzés
Kerülje a ponttal (.), perjellel (/), fordított perjellel (\) végződő könyvtárneveket, illetve a kettő sorozatát vagy kombinációját. Egyetlen elérésiút-szegmens sem végződhet ponttal (.).
Blobnevek
A blobneveknek meg kell felelniük az alábbi elnevezési szabályoknak. Ezek a szabályok a hierarchikus névtérrel rendelkező fiókokban lévő blobokra is vonatkoznak, hacsak másként nem jelezzük.
A blobnevek bármilyen karakterkombinációt tartalmazhatnak.
A blobneveknek legalább egy karakter hosszúságúnak kell lenniük, és nem lehetnek 1024 karakternél hosszabbak az Azure Storage-blobok esetében.
Az Azure Storage Emulator legfeljebb 256 karakter hosszú blobneveket támogat. További információ: Az Azure Storage Emulator használata fejlesztéshez és teszteléshez.
A blobnevek megkülönböztetik a kis- és nagybetűket.
A fenntartott URL-karaktereket escape-karakterrel kell jelölni.
A blobnevekből álló elérésiút-szegmensek száma korlátozott. Az elérésiút-szegmens az egymást követő elválasztó karakterek (például perjel
/) közötti sztring, amely megfelel a könyvtárnak vagy a virtuális könyvtárnak. A blobnevekre az alábbi elérésiút-szegmenskorlátozások vonatkoznak:- Ha a tárfiókban nincs engedélyezve a hierarchikus névtér, a blobnevet tartalmazó elérésiút-szegmensek száma nem haladhatja meg a 254-et.
- Ha a tárfiókban engedélyezve van a hierarchikus névtér, a blobnevet tartalmazó elérésiút-szegmensek száma nem haladhatja meg a 63-at (beleértve a fióknév és a tárolónév elérésiút-szegmenseit is).
Megjegyzés
Kerülje a ponttal (.), perjellel (/), fordított perjellel (\) végződő blobneveket, illetve a kettő sorozatát vagy kombinációját. Egyetlen elérésiút-szegmens sem végződhet ponttal (.).
Alapértelmezés szerint a Blob szolgáltatás egy egybesimított tárolási sémán alapul, nem hierarchikus sémán. Azonban megadhat egy karaktert vagy sztringelválasztót egy blobnéven belül egy virtuális hierarchia létrehozásához. Az alábbi lista például érvényes és egyedi blobneveket jelenít meg. Figyelje meg, hogy egy sztring érvényes lehet blobnévként és virtuális könyvtárnévként is ugyanabban a tárolóban:
/A
/a.txt
/a/b
/a/b.txt
A blobok számbavételekor kihasználhatja az elválasztó karakter előnyeit.
Metaadatok nevei
A tároló- vagy bloberőforrás metaadatait az erőforráshoz társított név-érték párok tárolják. A metaadatok nevének meg kell felelnie a C#-azonosítók elnevezési szabályainak.
Vegye figyelembe, hogy a metaadatnevek megőrzik azt az esetet, amellyel létrehozták őket, de nem különböztetik meg a kis- és nagybetűket a beállításkor vagy olvasáskor. Ha egy erőforráshoz két vagy több azonos nevű metaadat-fejléc van elküldve, a Blob szolgáltatás a 400-es állapotkódot adja vissza (Hibás kérés).
Erőforrás URI-szintaxisa
Minden erőforrás rendelkezik egy megfelelő alap URI-vel, amely magára az erőforrásra hivatkozik.
A tárfiók esetében az alap URI csak a fiók nevét tartalmazza:
https://myaccount.blob.core.windows.net
Tároló esetén az alap URI tartalmazza a fiók nevét és a tároló nevét:
https://myaccount.blob.core.windows.net/mycontainer
Blob esetén az alap URI tartalmazza a fiók nevét, a tároló nevét és a blob nevét:
https://myaccount.blob.core.windows.net/mycontainer/myblob
Egy tárfiók rendelkezhet gyökértárolóval, amely az URI-ból kihagyható alapértelmezett tároló. A gyökértárolóban lévő blobra a tároló elnevezése nélkül lehet hivatkozni, vagy a gyökértárolóra kifejezetten hivatkozhat a neve alapján ($root). További információ : A gyökértároló használata . A következő URI-k a gyökértárolóban lévő blobra hivatkoznak:
https://myaccount.blob.core.windows.net/myblob
https://myaccount.blob.core.windows.net/$root/myblob
Blobpillanatképek
A pillanatkép egy blob írásvédett verziója, amely a pillanatkép létrehozásakor volt tárolva. Pillanatképek használatával biztonsági másolatot vagy ellenőrzőpontot hozhat létre egy blobról. A pillanatkép-blob neve tartalmazza az alapblob URI-ját, valamint egy dátum-idő értéket, amely jelzi a pillanatkép létrehozását.
Tegyük fel például, hogy egy blob az alábbi URI-t tartalmazza:
https://myaccount.blob.core.windows.net/mycontainer/myblob
A blob pillanatképének URI-ja a következőképpen jön létre:
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
Tároló- vagy blobnevekben nem ajánlott Unicode-karakterek használata
Az alábbi táblázat felsorolja azokat a Unicode-karaktereket, amelyeket nem ajánlott tároló- vagy blobnevekben használni. Ha ezeket a karaktereket a listában szereplő többi karakterrel együtt használják, az UTF-8 vagy MBCS dekódolása meghiúsulhat, ami a Blob szolgáltatásnak küldött kérés sikertelenségéhez vezethet.
| 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 |