Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása

  • Cikk

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 címtárat tartalmaznak. A címtárak tulajdonságokat és nulla vagy több fájlt vagy címtárat tartalmaznak. A fájl minden olyan entitás, amely bináris adatokból, tulajdonságokból és metaadatokból áll.

Erőforrások neve

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 nevű 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.

Megosztási nevek

A fájlszolgáltatás-megosztások neveire vonatkozó szabályok szigorúbbak, mint az SMB-megosztások neveinek SMB-protokollja által előírtak, így a Blob- és a Fájlszolgáltatások hasonló elnevezési konvenciót oszthatnak meg a tárolókra és megosztásokra vonatkozóan. 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őjel/mínusz (-) karaktert közvetlenül meg kell előzni, és betűvel vagy számmal kell követni; a megosztásnevekben nem engedélyezettek az egymást követő kötőjelek.
  • 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 a 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ásnév-korlátozások
• A tároló nevének é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; a tárolónevekben nem engedélyezettek az egymást követő kötőjelek.
• 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 következő karakterek érvénytelenek a megosztás nevében: \ / [ ] : ¦ < > + = ; , * ? "
• 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 kis- és nagybetűk érzéketlenek.

Címtár- és fájlnevek

Azure Files a következő elnevezési szabályokat kényszeríti ki a címtárak és a fájlnevek esetében:

  • A címtár- és fájlnevek kis- és nagybetűk érzéketlenek.
  • 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 escape-karakterrel kell jelölni.
  • 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, míg az NTFS-fájlnevekben érvényesek, nem érvényesek Unicode-karakterek. Emellett egyes ASCII- vagy Unicode-karakterek, például a vezérlőkarakterek (0x00 -a 0x1F) szintén nem engedélyezettek. A HTTP/1.1 Unicode-sztringekre vonatkozó szabályaié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 az összes művelet során támogatják az U+FFFE és az U+FFFF karaktereket. Ezek a karakterek SMB- és REST-protokollokkal is támogatottak. A List Directory és a Files ésa List Handles műveletek speciális kezelést igényelnek ezekhez a karakterekhez, ahogy az a megfelelő dokumentációban is szerepel.

Alapértelmezés szerint a könyvtár végén lévő pont (.) karakterek és a kérelem URL-címeiben lévő fájlnevek figyelmen kívül lesznek hagyva vagy figyelmen kívül hagyva.

  • Ha például létrejön egy nevű file1... fájl, a rendszer figyelmen kívül hagyja a végén lévő pontokat, és létrehoz egy nevű file1 fájlt. Ugyanez vonatkozik az elérési úton lévő könyvtárakra is. Ha egy fájllétrehozási kérelem tartalmazza az elérési utat \Dir1\Dir2…\File1 , akkor a fájl a következő helyen lesz létrehozva: \Dir1\Dir2\File1.
  • A 2022-11-02-es verziótól kezdődően azonban az alapértelmezett viselkedés felülbíráltatható az URL-kérelem fejlécének x-ms-allow-trailing-dottrue beállításával.
  • Ha például létre szeretne hozni egy nevű file1... fájlt, és bele szeretné foglalni a záró elemet, a fájlnak szerepelnie kell a x-ms-allow-trailing-dot kérelemfejlécben, és be kell állítania a következőt true: . Ugyanez vonatkozik a címtárnevek létrehozására is.
  • Fájlmásolási kérelem esetén, ha a forrásfájlnévbe záró elemet szeretne belefoglalni, a fejlécet a x-ms-source-allow-trailing-dot következőre kell állítani: true. További információkért tekintse meg az egyes REST API-khoz elérhető fejlécbeállításokat.

Az alábbi táblázat a 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év-korlátozások
• A blobnévnek legalább egy karakter hosszú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 virtuális könyvtárelválasztóval végződhetnek, például perjellel (/)
• Érvénytelen URL-elérési utak karakterei nem engedélyezettek: Az olyan kódpontok, mint a \uE000, de az NTFS-fájlnevekben érvényesek, nem érvényesek Unicode-karakterek. Emellett egyes ASCII- vagy Unicode-karakterek, például vezérlőkarakterek (0x00 0x1F) szintén nem engedélyezettek. A HTTP/1.1 Unicode-sztringekre vonatkozó szabályaié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út-né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 a kis- és nagybetűk megkülönböztetése (két név, amelyek csak abban az esetben különböznek, ha nem engedélyezett).
• Nem lehet olyan könyvtárelérési út, amely megegyezik a fájl elérési útjának elérési útjára.
• A következő karakterek érvénytelenek egy összetevő nevében: \ / : ¦ < > * ? "
• 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ül minden elérésiút-összetevő a címtárakat jelöli. Az utolsó elérési út neve ö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 útvonal 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, amelyet 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.
  • Ugyanaz 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 fájl és egy névvel ellátott data könyvtár például nem létezhet ugyanabban a szülőútvonalban.

Metaadatok nevei

A megosztási vagy fájlerő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 é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, az Azure File 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.file.core.windows.net

Megosztás esetén az alap URI tartalmazza a fiók nevét és a megosztás nevét:

https://myaccount.file.core.windows.net/myshare

Címtár esetén az alap URI tartalmazza a fiók nevét, a megosztás nevét és a könyvtá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

Lásd még