Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A tárfiókok nulla vagy több Azure-fájlmegosztást tartalmazhatnak. A megosztások tulajdonságokat, metaadatokat és nulla vagy több fájlt vagy könyvtárat tartalmaznak. A címtárak tulajdonságokat és nulla vagy több fájlt vagy könyvtárat tartalmaznak. A fájl minden olyan entitás, amely bináris adatokból, tulajdonságokból és metaadatokból áll.
Erőforrásnevek
A megosztásra, könyvtárra vagy fájlra hivatkozó URI-nak egyedinek kell lennie. Egy adott tárfiókon belül minden megosztásnak egyedi névvel kell rendelkeznie. Egy adott megosztáson vagy könyvtáron belül minden fájlnak egyedi névvel kell rendelkeznie az adott megosztáson vagy könyvtáron belül.
Ha olyan megosztást, könyvtárat vagy fájlt 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.
Nevek megosztása
A fájlszolgáltatás-megosztások nevének szabályai szigorúbbak, mint az SMB-megosztások neveire vonatkozó SMB protokollban előírtak, így a blob- és fájlszolgáltatások hasonló elnevezési konvenciókonvenciákat oszthatnak meg a tárolókhoz és megosztásokhoz. A megosztások elnevezési korlátozásai a következők:
- A megosztás nevének érvényes DNS-névnek kell lennie.
- A megosztásneveknek betűvel vagy számmal kell kezdődniük, és csak betűket, számokat és kötőjel/mínusz (-) karaktert tartalmazhatnak.
- Minden kötőjelet/mínuszjelet (-) közvetlenül meg kell előzni, és betűvel vagy számmal kell követni; az egymást követő kötőjelek nem engedélyezettek a megosztásnevekben.
- A megosztás nevének minden betűje kisbetűs lehet.
- A megosztásneveknek 3–63 karakter hosszúságúnak kell lenniük.
Az alábbi táblázat az Azure Files és az Azure Blob Storage elnevezési korlátozásait hasonlítja össze:
| tárolók, blobok és metaadatok elnevezése és hivatkozása | SMB-megosztási névkorlátozások |
|---|---|
| • A tárolónévnek érvényes DNS-névnek kell lennie. • A tárolóneveknek betűvel vagy számmal kell kezdődniük, és csak betűket, számokat és kötőjel/mínusz (-) karaktert tartalmazhatnak. • Minden kötőjelet/mínuszjelet (-) közvetlenül meg kell előzni, és betűvel vagy számmal kell követni; az egymást követő kötőjelek nem engedélyezettek a tárolónevekben. • A tárolónévben szereplő összes betűnek kisbetűsnek kell lennie. • A tárolóneveknek 3–63 karakter hosszúságúnak kell lenniük. |
• A megosztás neve legfeljebb 80 karakter hosszúságú lehet. • A megosztás nevében a következő karakterek érvénytelenek: \ / [ ] : ¦ < > + = ; , * ? "• A 0x1F 0x00 tartományában lévő vezérlőkarakterek a megosztás nevében érvénytelenek. • Minden más Unicode-karakter legális. • A nevek a kis- és nagybetűk érzéketlenek. |
Címtár- és fájlnevek
Az Azure Files a következő elnevezési szabályokat kényszeríti ki a címtárakra és a fájlnevekre:
- A címtár- és fájlnevek kis- és nagybetűket nem érzékenek.
- A címtár- és fájlösszetevők neve legfeljebb 255 karakter hosszúságú lehet.
- A címtárnevek nem végződhetnek perjeljellel (/). Ha meg van adva, a rendszer automatikusan eltávolítja.
- A fájlnevek nem végződnek perjel karakterrel (/).
- A fenntartott URL-karaktereket megfelelően kell feloldani.
- A következő karakterek nem engedélyezettek:
" \ / : | < > * ? - Érvénytelen URL-elérési út karakterek nem engedélyezettek. Az olyan kódpontok, mint a
\uE000, de az NTFS-fájlnevekben érvényesek, nem érvényesek Unicode-karakterek. Emellett néhány ASCII- vagy Unicode-karakter, például a vezérlőkarakterek (0x00a0x1F) szintén nem engedélyezettek. A HTTP/1.1 Unicode-sztringjeire vonatkozó szabályokért lásd RFC 2616, 2.2. szakasz: Alapvető szabályok és RFC 3987. - Érvénytelen Unicode-karakterek (más néven érvénytelen helyettesítő párok) nem támogatottak.
- A következő fájlnevek nem engedélyezettek: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, dot character (.), és két pont karakter (..).
- A 2021-12-02-es verziótól kezdve a címtár- és fájlnevek minden műveletben támogatják az U+FFFE és az U+FFFF karaktereket. Ezek a karakterek SMB- és REST-protokollokkal is támogatottak. List Directory és Files és Listakezelők műveletek speciális kezelést igényelnek ezekhez a karakterekhez a megfelelő dokumentációjukban leírtak szerint.
Alapértelmezés szerint az SMB protokollt használó fájlmegosztások esetében a rendszer figyelmen kívül hagyja vagy kihagyja a könyvtár végén lévő pont (.) karaktereket, valamint a kérelem URL-címeiben szereplő fájlneveket.
- Ha például létrejön egy
file1...nevű fájl, a rendszer figyelmen kívül hagyja a műveletet, és létrejön egyfile1nevű fájl. Ugyanez vonatkozik az elérési út címtáraira is. Ha egy fájllétrehozási kérelem tartalmazza a\Dir1\Dir2…\File1elérési útját, akkor a fájl\Dir1\Dir2\File1. - A 2022-11-02 verziótól kezdve azonban az alapértelmezett viselkedés felülbíráltatható az URL-kérelemben
x-ms-allow-trailing-dotfejléctruebeállításával. - Ha például létre szeretne hozni egy
file1...nevű fájlt, és bele szeretné foglalni a záró elemet, ax-ms-allow-trailing-dotszerepelnie kell a kérelem fejlécében, éstruekell beállítania. Ugyanez vonatkozik a címtárnevek létrehozására is. - Fájlmásolási kérelem esetén, ha a forrásfájl nevére záró elemet szeretne felvenni, a
x-ms-source-allow-trailing-dotfejlécettruekell beállítani. További információkért tekintse meg az egyes REST API-khoz elérhető fejlécbeállításokat.
Alapértelmezés szerint az engedélyezett NFS protokollal rendelkező fájlmegosztások esetében a könyvtár végén lévő pont (.) karakterek és a kérelem URL-címeiben lévő fájlnevek nem figyelmen kívül hagyni.
Az alábbi táblázat az Azure Files és az Azure Blob Storage elnevezési korlátozásait hasonlítja össze:
| tárolók, blobok és metaadatok elnevezése és hivatkozása | SMB protokollnévkorlátozások |
|---|---|
| • A blobnévnek legalább egy karakter hosszúságúnak kell lennie, és nem lehet hosszabb 1024 karakternél. • A blobnevek megkülönböztetik a kis- és nagybetűket. • A fenntartott URL-karaktereket megfelelően kell feloldani. • A blobnevek végződhetnek virtuális könyvtárelválasztóval, például perjellel (/) • Érvénytelen URL-elérési utak karakterei nem engedélyezettek: Az olyan kódpontok, mint a \uE000, az NTFS-fájlnevekben érvényesek, nem érvényesek Unicode-karakterek. Ezenkívül néhány ASCII- vagy Unicode-karakter, például vezérlőkarakterek (0x00 0x1F) szintén nem engedélyezettek. A HTTP/1.1 Unicode-sztringjeire vonatkozó szabályokért lásd RFC 2616, 2.2. szakasz: Alapvető szabályok és RFC 3987. |
• Az elérési út neve legfeljebb 32 760 karakter hosszúságú lehet. • Minden elérési útnév-összetevő (fájl/könyvtár) legfeljebb 255 karakter hosszúságú lehet. • Az elérési út neve egy vagy több, a (\) fordított perjel karakterrel elválasztott elérésiút-összetevőből áll. • Az elérési út neve a kis- és nagybetűk megőrzése és érzéketlen (két név, amelyek csak abban az esetben különböznek, ha nem engedélyezett). • Nem lehet olyan könyvtár elérési útja, amely megegyezik a fájl elérési útjának elérési útjára. • Az összetevő nevében a következő karakterek érvénytelenek: \ / : ¦ < > * ? "• A 0x1F 0x00 tartományában lévő vezérlőkarakterek a megosztás nevében érvénytelenek. |
Elérési utak nevei
Az elérési út neve egy vagy több elérésiút-összetevőből (könyvtárból vagy fájlnévből) áll, amelyet a perjel (/) karakter választ el egymástól. A vezetéknév-összetevőn kívüli összes elérésiút-összetevő a címtárakat jelöli. A vezetéknév-összetevő egy könyvtárat vagy egy fájlt jelöl. A következő elnevezési szabályok érvényesek:
- Az elérési út neve legfeljebb 2048 karakter hosszúságú lehet. Az elérési út egyes összetevői legfeljebb 255 karakter hosszúságúak lehetnek.
- Az elérési út neve egy vagy több elérésiút-összetevőből áll, amelyeket a perjel (/) karakter választ el egymástól.
- Az elérési út alkönyvtárainak mélysége nem haladhatja meg a 250-et.
- Ugyanez a név nem használható olyan fájlokhoz és címtárakhoz, amelyek ugyanazt a szülőkönyvtárat használják. Egy
datanevű fájl és könyvtár például nem létezhet ugyanabban a szülőútvonalban.
Metaadatok nevei
A megosztási vagy fájlerő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 C#-azonosítókelnevezési szabályainak.
A metaadatok nevei megőrzik azt az esetet, amellyel létrehozták őket, de a kis- és nagybetűk nem érzékenek a beállításukhoz vagy olvasásukhoz. Ha egy erőforráshoz két vagy több azonos nevű metaadat-fejlécet küld, az Azure File service 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-val, 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.file.core.windows.net
Egy megosztás esetében az alap URI tartalmazza a fiók nevét és a megosztás nevét:
https://myaccount.file.core.windows.net/myshare
Egy címtár esetében az alap URI tartalmazza a fiók nevét, a megosztás nevét és a címtár elérési útját:
https://myaccount.file.core.windows.net/myshare/myparentdir/mydir
Egy fájl esetében az alap URI tartalmazza a fiók nevét, a megosztás nevét és a fájl elérési útját:
https://myaccount.file.core.windows.net/myshare/myfile
https://myaccount.file.core.windows.net/myshare/mydir/myfile
https://myaccount.file.core.windows.net/myshare/myparentdir/mydir/myfile