Namnge och referera till resurser, kataloger, filer och metadata

  • Artikel

Ett lagringskonto kan innehålla noll eller flera Azure-filresurser. En resurs innehåller egenskaper, metadata och noll eller fler filer eller kataloger. En katalog innehåller egenskaper och noll eller fler filer eller kataloger. En fil är en enskild entitet som består av binära data, egenskaper och metadata.

Resursnamn

URI:n för att referera till en resurs, katalog eller fil måste vara unik. I ett visst lagringskonto måste varje resurs ha ett unikt namn. Varje fil i en viss resurs eller katalog måste också ha ett unikt namn i resursen eller katalogen.

Om du försöker skapa en resurs, katalog eller fil med ett namn som strider mot namngivningsregler misslyckas begäran med statuskoden 400 (felaktig begäran).

Dela namn

Reglerna för filtjänstresursnamn är mer restriktiva än vad som föreskrivs i SMB-protokollet för SMB-resursnamn, så att blob- och filtjänsterna kan dela liknande namngivningskonventioner för containrar och resurser. Namngivningsbegränsningarna för resurser är följande:

  • Ett resursnamn måste vara ett giltigt DNS-namn.
  • Resursnamn måste börja med en bokstav eller ett nummer och får endast innehålla bokstäver, siffror och bindestreck/minustecken (-).
  • Varje bindestreck/minustecken (-) måste omedelbart föregås och följas av en bokstav eller siffra. efterföljande bindestreck tillåts inte i resursnamn.
  • Alla bokstäver i ett resursnamn måste vara gemener.
  • Resursnamn måste vara mellan 3 och 63 tecken långa.

I följande tabell jämförs namngivningsbegränsningarna för Azure Files och Azure Blob Storage:

Namnge och referera till containrar, blobar och metadata Begränsningar för SMB-resursnamn
• Ett containernamn måste vara ett giltigt DNS-namn.
• Containernamn måste börja med en bokstav eller ett nummer och får endast innehålla bokstäver, siffror och bindestreck/minustecken (-).
• Varje bindestreck/minustecken (-) måste omedelbart föregås och följas av en bokstav eller ett tal. efterföljande bindestreck tillåts inte i containernamn.
• Alla bokstäver i ett containernamn måste vara gemener.
• Containernamnen måste vara mellan 3 och 63 tecken långa.		 • Ett resursnamn får inte vara längre än 80 tecken.
• Följande tecken är ogiltiga i ett resursnamn: \ / [ ] : ¦ < > + = ; , * ? "
• Kontrolltecken i intervall 0x00 via 0x1F, inklusive, är olagliga i ett resursnamn.
• Alla andra Unicode-tecken är lagliga.
• Namn är skiftlägesbevarande och skiftlägesokänsliga.

Katalog- och filnamn

Azure Files tillämpar följande namngivningsregler för katalog- och filnamn:

  • Katalog- och filnamn är skiftlägesbevarande och skiftlägesokänsliga.
  • Katalog- och filkomponentnamn får inte vara längre än 255 tecken.
  • Katalognamn kan inte sluta med snedstreckstecknet (/). Om den tillhandahålls tas den bort automatiskt.
  • Filnamn får inte sluta med snedstreckstecknet (/).
  • Reserverade URL-tecken måste undantas korrekt.
  • Följande tecken tillåts inte: " \ / : | < > * ?
  • Ogiltiga URL-sökvägstecken tillåts inte. Kodpunkter som \uE000, även om de är giltiga i NTFS-filnamn, är inte giltiga Unicode-tecken. Dessutom är vissa ASCII- eller Unicode-tecken, till exempel kontrolltecken (0x00 till 0x1F), inte heller tillåtna. Regler som styr Unicode-strängar i HTTP/1.1 finns i RFC 2616, avsnitt 2.2: Grundläggande regler och RFC 3987.
  • Ogiltiga Unicode-tecken (kallas ogiltiga surrogatpar) stöds inte.
  • Följande filnamn tillåts inte: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, punkttecken (.) och två punkttecken (..).
  • Från och med version 2021-12-02 stöder katalog- och filnamn U+FFFE- och U+FFFF-tecken genom alla åtgärder. Dessa tecken stöds också via SMB- och REST-protokoll. Åtgärder för listkatalog- och fil- och listreferenser behöver särskild hantering av dessa tecken enligt deras respektive dokumentation.

Som standard ignoreras eller utelämnas punkttecken (.) i slutet av katalogen och filnamnen i url:er för begäran.

  • Om till exempel en fil med namnet file1... skapas ignoreras punkterna i slutet och en fil med namnet file1 skapas. Samma sak gäller för kataloger i sökvägen. Om en begäran om att skapa en fil innehåller sökvägen \Dir1\Dir2…\File1 skapas filen på \Dir1\Dir2\File1.
  • Men från och med version 2022-11-02 kan standardbeteendet åsidosättas genom att ange rubriken x-ms-allow-trailing-dot till true i URL-begäran.
  • Om du till exempel vill skapa en fil med namnet file1... och inkludera de avslutande punkterna ska den x-ms-allow-trailing-dot inkluderas i begärandehuvudet och anges till true. Samma sak gäller för att skapa katalognamn.
  • Om du vill inkludera avslutande punkter i källfilens namn måste rubriken anges till trueom du vill inkludera avslutande punkter i källfilens namnx-ms-source-allow-trailing-dot. Mer information finns i de tillgängliga rubrikalternativen för varje enskilt REST API.

I följande tabell jämförs namngivningsbegränsningarna för Azure Files och Azure Blob Storage:

Namnge och referera till containrar, blobar och metadata Namnbegränsningar för SMB-protokoll
• Ett blobnamn måste vara minst ett tecken långt och får inte vara längre än 1 024 tecken.
• Blobnamn är skiftlägeskänsliga.
• Reserverade URL-tecken måste vara korrekt undantagna.
• Blobnamn kan sluta med en avgränsare för virtuell katalog, till exempel ett snedstreck (/)
• Ogiltiga URL-sökvägstecken tillåts inte: Kodpunkter som \uE000, även om de är giltiga i NTFS-filnamn, är inte giltiga Unicode-tecken. Dessutom tillåts inte några ASCII- eller Unicode-tecken, till exempel kontrolltecken (0x00 till 0x1F). Regler som styr Unicode-strängar i HTTP/1.1 finns i RFC 2616, avsnitt 2.2: Grundläggande regler och RFC 3987.		 • Ett sökvägsnamn får inte vara längre än 32 760 tecken.
• Varje sökvägsnamnkomponent (fil/katalog) får inte vara längre än 255 tecken.
• Ett sökvägsnamn består av en eller flera sökvägsnamnkomponenter avgränsade med (\) bakåtsnedstreck.
• Sökvägens namn är skiftlägesbevarande och skiftlägesokänsligt (två namn som endast skiljer sig åt om det inte är tillåtet).
• Det går inte att ha en katalogsökväg som är samma som en filsökväg.
• Följande tecken är ogiltiga i ett komponentnamn: \ / : ¦ < > * ? "
• Kontrolltecken i intervall 0x00 via 0x1F, inklusive, är olagliga i ett resursnamn.

Sökvägsnamn

Ett sökvägsnamn består av en eller flera sökvägsnamnkomponenter (katalog eller filnamn) avgränsade med snedstreckstecknet (/). Alla sökvägsnamnkomponenter förutom den sista sökvägsnamnkomponenten anger kataloger. Den sista sökvägsnamnkomponenten anger en katalog eller en fil. Följande namngivningsregler gäller:

  • Ett sökvägsnamn får inte vara längre än 2 048 tecken. Enskilda komponenter i sökvägen kan vara högst 255 tecken långa.
  • Ett sökvägsnamn består av en eller flera sökvägsnamnkomponenter avgränsade med snedstreckstecknet (/).
  • Djupet av underkataloger i sökvägen får inte överstiga 250.
  • Samma namn kan inte användas för en fil och en katalog som delar samma överordnade katalog. En fil och en katalog som vart och ett heter data kan till exempel inte finnas under samma överordnade sökväg.

Metadatanamn

Metadata för en resurs eller filresurs lagras som namn/värde-par som är associerade med resursen. Metadatanamn måste följa namngivningsreglerna för C#-identifierare.

Observera att metadatanamn bevarar det skiftläge som de skapades med, men är skiftlägesokänsliga när de anges eller läss. Om två eller flera metadatahuvuden med samma namn skickas för en resurs returnerar Azure File Service statuskod 400 (felaktig begäran).

Resurs-URI-syntax

Varje resurs har en motsvarande bas-URI, som refererar till själva resursen. För lagringskontot innehåller bas-URI:n endast namnet på kontot:

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

För en resurs innehåller bas-URI:n namnet på kontot och namnet på resursen:

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

För en katalog innehåller bas-URI:n namnet på kontot, namnet på resursen och sökvägen till katalogen:

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

För en fil innehåller bas-URI:n namnet på kontot, namnet på resursen och sökvägen till filen:

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

Se även