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 címtárak nulla vagy több blobot is tartalmazhatnak. A blobok a bináris adatokból, tulajdonságokból és metaadatokból álló egyetlen entitások.
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) meghiúsul.
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 még 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 a \uE000, míg az NTFS-fájlnevekben érvényesek, érvénytelen Unicode-karakterek, ezért nem használhatók. Ezenkívül egyes ASCII- vagy Unicode-karakterek, 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őjel/mínusz (-) karaktert tartalmazhatnak.
Minden kötőjel/mínusz (-) karaktert közvetlenül meg kell előzni, és betűvel vagy számmal kell követni; a tárolónevekben nem engedélyezettek az egymást követő kötőjelek.
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 a karakterek tetszőleges kombinációját tartalmazhatják.
A címtárnévnek legalább egy karakter hosszú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 azokat a könyvtárneveket, amelyek ponttal (.), perjellel (/), fordított perjellel (\) végződnek, illetve a kettő sorozatával vagy kombinációjával végződnek. 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, kivéve, ha másként fel vannak jegyezve.
A blobnevek a karakterek tetszőleges kombinációját tartalmazhatják.
A blobneveknek legalább egy karakter hosszúnak kell lenniük, és nem lehetnek 1024 karakternél hosszabbak az Azure Storage-beli blobok esetében.
Az Azure Storage emulátor 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 blobnévbő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 a következő 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 lapos 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 a határoló karakter előnyeit.
Metaadatok nevei
A tároló- vagy bloberőforrás metaadatai az erőforráshoz társított név-érték párokként lesznek tárolva. 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 érzéketlenek a be- 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érelem).
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
Előfordulhat, hogy a tárfiók rendelkezik 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 is hivatkozhat, vagy a gyökértárolóra explicit módon 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
Blob-pillanatképek
A pillanatkép egy blob írásvédett verziója, amely a pillanatkép létrehozásakor volt tárolva. A pillanatképek használatával biztonsági mentést 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 a következő 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>
A Unicode-karakterek nem ajánlottak tároló- vagy blobnevekben való használatra
Az alábbi táblázat olyan Unicode-karakterek listáját tartalmazza, amelyek nem ajánlottak tároló- vagy blobnevekben való használatra. Ha ezeket a karaktereket a listában szereplő többi karakterrel együtt használják, előfordulhat, hogy az UTF-8 vagy mcbs dekódolás meghiúsul, ami a blobszolgá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 |