Dela via

Azure Files REST API

  • Artikel

Azure Files tillhandahåller värdbaserade molnfilresurser som du kan komma åt (montera) med hjälp av branschstandardfilsystemprotokoll som SMB och NFS. När du monterar en filresurs på datorn med hjälp av SMB eller NFS omdirigerar operativsystemet API-begäranden för det lokala filsystemet. Omdirigeringen innehåller lokala API-begäranden som du gör med hjälp av .NET-gränssnitt System.IO eller python-metoder för att öppna, läsa eller skriva. Det innebär att användare av dessa program inte behöver göra något speciellt eller ens veta att deras data finns på en fjärrfilresurs i stället för lokal lagring.

Azure Files tillhandahåller också ett REST-API, som ofta kallas FileREST API. Om du vill använda FileREST-API:et skapar du HTTPS-begäranden mot HTTPS-slutpunkterna för FileREST. Du kan skriva kod för att skapa HTTPS-begäranden själv, men vi tillhandahåller Azure SDK:er som använder FileREST-API:et åt dig och tillhandahåller en idiomatisk språkomslutning över FileREST-API:et på populära språk som C#, Java, Python, JavaScript och Go.

Eftersom FileREST-API:et har utformats specifikt för Azure Files kan du komma åt funktioner i Azure Files som du inte kan komma åt via SMB eller NFS. Du kan också utföra vissa åtgärder, till exempel kopiera, mer effektivt än du kan via SMB eller NFS.

Den tillståndslösa typen av HTTPS gör FileREST-API:et användbart för molntjänster eller program som behöver åtkomst till många Azure-filresurser. Du kan till exempel koppla mervärdestjänster eller program till en Azure-filresurs för att lägga till en funktion. Dessa tjänster eller program kan innehålla produkter för antivirus, säkerhetskopiering, datahantering eller replikering. Azure File Sync och Azure Backup är viktiga Microsoft-tjänster som i stor utsträckning använder FileREST API för att lägga till värde ovanpå en kundägd Azure-filresurs.

Överväg att använda FileREST-API:et om du skapar mervärdestjänster eller program, särskilt om du tillhandahåller dessa tjänster till kunder. Om du skapar ett verksamhetsspecifikt program, särskilt ett som användarna använder mot en monterad Azure-filresurs, kan du använda antingen SMB/NFS eller FileREST. Du kan dock upptäcka att användning av SMB eller NFS är en enklare sökväg eftersom dessa protokoll gör att du kan använda interna filsystem-API:er.

Om du har ett befintligt program som har skrivits med interna filsystem-API:er behöver du inte skriva om det för att dra nytta av Azure Files. Det viktigaste värdet för Azure Files är att exponera interna filsystem-API:er med hjälp av SMB eller NFS.

Mer information om Azure Files, inklusive distribution, nätverk och identitetskonfiguration finns i:

Kontrollplan

I Azure tillhandahålls kontrollplanet via Azure Resource Manager, vilket är ett vanligt sätt att exponera Azure-resurser som kunden hanterar. Hanteringsenheten på den översta nivån är lagringskontot. Lagringskontot är en spårad resurs i Azure Files och andra lagringstjänster, till exempel Azure Blob Storage.

Lagringskontot hanteras av lagringsresursprovidern, som har namnområdet Microsoft.Storage. Lagringsresursprovidern exponerar också hantering av underordnade resurser eller proxyresurser som möjliggör hantering av lagringstjänster som paketeras i lagringskontot. För Azure Files finns det två relevanta proxyresurser:

  • Resursen FileService . Den innehåller inställningar som är specifika för Azure Files som gäller för alla filresurser i lagringskontot. Resursen FileService är underordnad lagringskontot. Ett lagringskonto har alltid bara en FileService resurs: default.

  • Resursen FileShare . Den representerar en filresurs eller en ögonblicksbild av en filresurs. Resursen FileShare är underordnad resursen FileService och kan innehålla ett oändligt antal filresurser.

Även om en FileService resurs kan innehålla ett oändligt antal FileShare resurser är det inte bra att använda ett mycket stort antal eftersom allt i ett lagringskonto delar en definierad pool med I/O, bandbredd och andra gränser. Mer information finns i Azure Files skalbarhets- och prestandamål.

Information om hur du anropar API:er för kontrollplanet finns i:

Åtgärder på objekten FileService och FileShare kan också utföras via dataplanet. Det här är en artefakt av Azure Files före Azure Resource Manager. Även om dessa API:er stöds fullt ut bör du i de flesta fall använda API:erna för lagringsresursprovidern för att hantera Azure Files av följande skäl:

  • Åtgärder som exponeras via Azure Resource Manager använda Microsoft Entra ID för autentisering och auktorisering, så att du kan hantera Azure Files med hjälp av rollbaserad åtkomstkontroll (RBAC). Du kan auktorisera ditt program eller din tjänst att programmatiskt anropa dessa API:er med ett Microsoft Entra tjänstens huvudnamn.

  • Du kan anropa Azure Resource Manager API:er tvingande, antingen via REST-API:et direkt eller via en SDK. Eller så kan du anropa dem deklarativt genom att deklarera vilka resurser som behöver distribueras via Azure-mallar. För resurser som behöver skapas upprepade gånger tillsammans (till exempel i tjänstdistributioner) kan det avsevärt förenkla det arbete som krävs med hjälp av mallar.

  • Även om vi rekommenderar att du använder lagringsresursprovidern för att hantera lagringsresurser, ger hanterings-API:erna för FileREST-dataplanet bättre prestanda i fall som kräver hög skala. Ett exempel på ett sådant fall är en arbetsbelastning som skapar eller ändrar tusentals filresurser i samma lagringskonto.

    • Microsoft.Storage storageAccounts/fileServices/shares utlöser en kontrollplansåtgärd via lagringsresursprovidern.
    • Microsoft.Storage storageAccounts/fileServices/fileshares är en dataplansåtgärd. Att ange roller på resursnivå, till exempel Storage File Data SMB Share Reader , bör vara en dataplansåtgärd och måste använda den här resursen.

Dataplanet

Azure Files tillhandahåller ett hierarkiskt filsystem för ostrukturerade data. FileREST-API:et modellerar de två viktiga objekten i filsystemutrymmet: filer och kataloger. Information om hur du anropar FileREST-API:er finns i:

Se även