Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na je

  • Článek

Účet úložiště může obsahovat nula nebo více sdílených složek Azure. Sdílená složka obsahuje vlastnosti, metadata a žádný nebo více souborů nebo adresářů. Adresář obsahuje vlastnosti a žádný nebo více souborů nebo adresářů. Soubor je libovolná entita, která se skládá z binárních dat, vlastností a metadat.

Názvy prostředků

Identifikátor URI, který odkazuje na sdílenou složku, adresář nebo soubor, musí být jedinečný. V rámci daného účtu úložiště musí mít každá sdílená složka jedinečný název. Každý soubor v dané sdílené složce nebo adresáři musí mít také jedinečný název v rámci této sdílené složky nebo adresáře.

Pokud se pokusíte vytvořit sdílenou složku, adresář nebo soubor s názvem, který porušuje pravidla pojmenování, požadavek selže se stavovým kódem 400 (Chybný požadavek).

Názvy sdílených složek

Pravidla pro názvy sdílených složek souborové služby jsou více omezující, než předepisuje protokol SMB pro názvy sdílených složek SMB, aby služby Blob a File mohly sdílet podobné zásady vytváření názvů pro kontejnery a sdílené složky. Omezení pojmenování sdílených složek jsou následující:

  • Název sdílené složky musí být platný název DNS.
  • Názvy sdílených složek musí začínat písmenem nebo číslicí a můžou obsahovat jenom písmena, číslice a znak spojovníku nebo minus (-).
  • Každý znak spojovníku/minus (-) musí bezprostředně předcházet a za ním musí následovat písmeno nebo číslo; Po sobě jdoucí pomlčky nejsou v názvech sdílených složek povoleny.
  • Všechna písmena v názvu sdílené složky musí být malá.
  • Názvy sdílených složek musí mít délku 3 až 63 znaků.

Následující tabulka porovnává omezení pojmenování pro Azure Files a Azure Blob Storage:

Pojmenování a odkazování na kontejnery, objekty blob a metadata Omezení názvu sdílené složky SMB
• Název kontejneru musí být platný název DNS.
• Názvy kontejnerů musí začínat písmenem nebo číslicí a mohou obsahovat pouze písmena, číslice a znak spojovníku/minus (-).
• Každý znak spojovníku nebo minus (-) musí bezprostředně předcházet a musí za ním následovat písmeno nebo číslo; Po sobě jdoucí spojovníky nejsou v názvech kontejnerů povoleny.
• Všechna písmena v názvu kontejneru musí být malá.
• Názvy kontejnerů musí mít délku 3 až 63 znaků.		 • Název sdílené složky nesmí být delší než 80 znaků.
• Následující znaky jsou v názvu sdílené složky neplatné: \ / [ ] : ¦ < > + = ; , * ? "
• Řídicí znaky v rozsahu 0x00 prostřednictvím 0x1F (včetně) jsou v názvu sdílené složky neplatné.
• Všechny ostatní znaky Unicode jsou legální.
• Názvy zachovávají malá a velká písmena a nerozlišují se.

Názvy adresářů a souborů

Azure Files pro názvy adresářů a souborů vynucuje následující pravidla pojmenování:

  • Názvy adresářů a souborů se zachovají a nerozlišují malá a velká písmena.
  • Názvy adresářů a komponent souborů nesmí být delší než 255 znaků.
  • Názvy adresářů nemůžou končit znakem lomítka (/). Pokud ho zadáte, automaticky se odebere.
  • Názvy souborů nesmí končit znakem lomítka (/).
  • Vyhrazené znaky v adresách URL musí být správně uzavřené do uvozovek.
  • Následující znaky nejsou povolené: " \ / : | < > * ?
  • Nepovolené znaky cesty URL nejsou povolené. Body kódu jako \uE000, i když jsou platné v souborech souborů NTFS, nejsou platné znaky Unicode. Kromě toho nejsou povoleny ani některé znaky ASCII nebo Unicode, například řídicí znaky (0x00 do 0x1F). Pravidla pro řetězce Unicode v HTTP/1.1 viz RFC 2616, Oddíl 2.2: Základní pravidla a RFC 3987.
  • Neplatné znaky Unicode (označované jako neplatné náhradní páry) nejsou podporovány.
  • Následující názvy souborů nejsou povolené: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, tečka (.) a dvě tečky (..).
  • Od verze 2021-12-02 podporují názvy adresářů a souborů znaky U+FFFE a U+FFFF ve všech operacích. Tyto znaky jsou podporovány také prostřednictvím protokolů SMB a REST. Operace výpisu adresáře a souborů a popisovačů seznamu budou pro tyto znaky potřebovat zvláštní zpracování, jak je uvedeno v příslušné dokumentaci.

Ve výchozím nastavení se tečky (.) na konci adresáře a názvů souborů v adresách URL požadavků ignorují nebo vynechávají.

  • Pokud se například vytváří soubor s názvem file1... , tečky na konci se ignorují a vytvoří se soubor s názvem file1 . Totéž platí pro adresáře v cestě. Pokud požadavek na vytvoření souboru obsahuje cestu \Dir1\Dir2…\File1 , soubor se vytvoří na adrese \Dir1\Dir2\File1.
  • Od verze 2022-11-02 je však možné výchozí chování přepsat nastavením hlavičky x-ms-allow-trailing-dot na true v požadavku url.
  • Pokud například chcete vytvořit soubor s názvem file1... a zahrnout koncové tečky, x-ms-allow-trailing-dot měla by být zahrnuta v hlavičce požadavku a nastavena na truehodnotu . Totéž platí pro vytváření názvů adresářů.
  • Pokud chcete v případě požadavku na kopírování souboru zahrnout koncové tečky do názvu zdrojového souboru, musí být hlavička x-ms-source-allow-trailing-dot nastavená na truehodnotu . Další informace najdete v dostupných možnostech hlaviček pro jednotlivá rozhraní REST API.

Následující tabulka porovnává omezení pojmenování pro Azure Files a Azure Blob Storage:

Pojmenování a odkazování na kontejnery, objekty blob a metadata Omezení názvu protokolu SMB
• Název objektu blob musí mít aspoň jeden znak a nesmí být delší než 1 024 znaků.
• V názvech objektů blob se rozlišují velká a malá písmena.
• Rezervované znaky adresy URL musí být správně u řídicích znaků.
• Názvy objektů blob můžou končit oddělovačem virtuálního adresáře, například lomítkem (/)
• Nepovolené znaky cesty URL: Body kódu, jako je \uE000, jsou sice platné v názvech souborů NTFS, ale nejsou platné znaky Unicode. Kromě toho nejsou povoleny ani některé znaky ASCII nebo Unicode, například řídicí znaky (0x00 0x1F). Pravidla pro řetězce Unicode v HTTP/1.1 viz RFC 2616, Oddíl 2.2: Základní pravidla a RFC 3987.		 • Název cesty nesmí být delší než 32 760 znaků.
• Každá komponenta názvu cesty (soubor nebo adresář) nesmí být delší než 255 znaků.
• Název cesty se skládá z jedné nebo více součástí názvu cesty oddělených znakem zpětného lomítka (\).
• Název cesty zachovává malá a velká písmena a nerozlišuje velká a malá písmena (dva názvy, které se liší pouze v případě, že nejsou povoleny).
• Nelze mít cestu k adresáři, která je stejná jako cesta k souboru.
• Následující znaky jsou v názvu komponenty neplatné: \ / : ¦ < > * ? "
• Řídicí znaky v rozsahu 0x00 prostřednictvím 0x1F (včetně) jsou v názvu sdílené složky neplatné.

Názvy cest

Název cesty se skládá z jedné nebo více součástí názvu cesty (název adresáře nebo souboru) oddělených znakem lomítka (/). Všechny komponenty názvu cesty kromě komponenty názvu poslední cesty označují adresáře. Komponenta názvu poslední cesty označuje adresář nebo soubor. Platí následující pravidla pojmenování:

  • Délka cesty nesmí být delší než 2 048 znaků. Jednotlivé komponenty v cestě mohou mít délku maximálně 255 znaků.
  • Název cesty se skládá z jedné nebo více součástí názvu cesty oddělených znakem lomítka (/).
  • Hloubka podadresářů v cestě nesmí překročit 250.
  • Stejný název nelze použít pro soubor a adresář, který sdílí stejný nadřazený adresář. Například soubor a adresář, které mají každý název data , nemohou existovat ve stejné nadřazené cestě.

Názvy metadat

Metadata sdílené složky nebo prostředku souboru se ukládají jako páry název-hodnota přidružené k prostředku. Názvy metadat musí splňovat pravidla pojmenování pro identifikátory jazyka C#.

Všimněte si, že názvy metadat zachovávají velikost písmen, se kterými byly vytvořeny, ale při nastavení nebo čtení nerozlišují malá a velká písmena. Pokud se pro prostředek odesílají dvě nebo více hlaviček metadat se stejným názvem, vrátí služba Azure File stavový kód 400 (Chybný požadavek).

Syntaxe identifikátoru URI prostředku

Každý prostředek má odpovídající základní identifikátor URI, který odkazuje na samotný prostředek. Základní identifikátor URI pro účet úložiště obsahuje pouze název účtu:

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

U sdílené složky obsahuje základní identifikátor URI název účtu a název sdílené složky:

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

U adresáře obsahuje základní identifikátor URI název účtu, název sdílené složky a cestu k adresáři:

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

Základní identifikátor URI souboru obsahuje název účtu, název sdílené složky a cestu k souboru:

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

Viz také