Azure Files REST API

  • Artikel

Azure Files biedt gehoste cloudbestandsshares die u kunt openen (koppelen) met behulp van bestandssysteemprotocollen zoals SMB en NFS. Wanneer u een bestandsshare op uw computer koppelt met behulp van SMB of NFS, stuurt uw besturingssysteem API-aanvragen voor het lokale bestandssysteem om. De omleiding bevat lokale API-aanvragen die u maakt met behulp van .NET-interfaces System.IO of python-methoden voor openen, lezen of schrijven. Dit betekent dat gebruikers van deze toepassingen niets speciaals hoeven te doen of zelfs weten dat hun gegevens zich op een externe bestandsshare bevinden in plaats van op lokale opslag.

Azure Files biedt ook een REST API, die vaak de FileREST-API wordt genoemd. Als u de FileREST-API wilt gebruiken, maakt u HTTPS-aanvragen voor de FileREST HTTPS-eindpunten. U kunt zelf code schrijven om HTTPS-aanvragen te maken, maar we bieden Azure SDK's die gebruikmaken van de FileREST-API voor u. Deze bieden een idiomatische taalwraper over de FileREST-API in populaire talen zoals C#, Java, Python, JavaScript en Go.

Omdat de FileREST-API speciaal is ontworpen voor Azure Files, hebt u toegang tot functies van Azure Files waartoe u geen toegang hebt via SMB of NFS. Het stelt u ook in staat om bepaalde bewerkingen, zoals kopiëren, efficiënter uit te voeren dan via SMB of NFS.

De staatloze aard van HTTPS maakt de FileREST-API nuttig voor cloudservices of toepassingen die toegang moeten hebben tot veel Azure-bestandsshares. U kunt bijvoorbeeld services of toepassingen met toegevoegde waarde koppelen aan een Azure-bestandsshare om een mogelijkheid toe te voegen. Deze services of toepassingen kunnen antivirus-, back-up-, gegevensbeheer- of replicatieproducten bevatten. Azure File Sync en Azure Backup zijn belangrijke Microsoft-services die uitgebreid gebruikmaken van de FileREST-API om waarde toe te voegen aan een Azure-bestandsshare die eigendom is van de klant.

Overweeg het gebruik van de FileREST-API als u services of toepassingen met toegevoegde waarde bouwt, met name als u deze services aan klanten levert. Als u een Line-Of-Business-toepassing maakt, met name een toepassing die gebruikers gebruiken voor een gekoppelde Azure-bestandsshare, kunt u SMB/NFS of FileREST gebruiken. Het is echter mogelijk dat het gebruik van SMB of NFS een eenvoudiger pad biedt, omdat u met deze protocollen systeemeigen bestandssysteem-API's kunt gebruiken.

Als u een bestaande toepassing hebt die is geschreven met systeemeigen bestandssysteem-API's, hoeft u deze niet opnieuw te schrijven om te profiteren van Azure Files. De belangrijkste waardepropositie van Azure Files is het beschikbaar maken van systeemeigen bestandssysteem-API's via het gebruik van SMB of NFS.

Zie voor meer informatie over Azure Files, waaronder implementatie, netwerken en identiteitsconfiguratie:

Besturingsvlak

In Azure wordt het besturingsvlak geleverd via Azure Resource Manager, wat een algemene manier biedt om Azure-resources beschikbaar te maken die door de klant worden beheerd. De beheereenheid op het hoogste niveau is het opslagaccount. Het opslagaccount is een bijgehouden resource in Azure Files en andere opslagservices, zoals Azure Blob Storage.

Het opslagaccount wordt beheerd door de opslagresourceprovider, die de naamruimte Microsoft.Storageheeft. De opslagresourceprovider maakt ook het beheer beschikbaar van onderliggende resources, of proxyresources, waarmee het beheer van de opslagservices die in het opslagaccount zijn gebundeld, kunnen worden beheerd. Voor Azure Files zijn er twee relevante proxyresources:

  • De FileService resource. Het biedt instellingen die specifiek zijn voor Azure Files die van toepassing zijn op alle bestandsshares in het opslagaccount. De FileService resource is een onderliggend element van het opslagaccount. Een opslagaccount heeft altijd maar één FileService resource: default.

  • De FileShare resource. Het vertegenwoordigt een bestandsshare of een momentopname van een bestandsshare. De FileShare resource is een onderliggend element van de FileService resource en kan een oneindig aantal bestandsshares bevatten.

Hoewel een FileService resource een oneindig aantal resources kan bevatten, is het gebruik van FileShare een zeer groot aantal geen goed idee omdat alles binnen een opslagaccount een gedefinieerde pool van I/O, bandbreedte en andere limieten deelt. Zie schaalbaarheids- en prestatiedoelen Azure Files voor meer informatie.

Zie voor meer informatie over het aanroepen van de BESTURINGSvlak-API's:

Bewerkingen op de FileService objecten en FileShare kunnen ook worden uitgevoerd via het gegevensvlak. Dit is een artefact van Azure Files van vóór Azure Resource Manager. Hoewel deze API's volledig worden ondersteund, moet u in de meeste gevallen de API's van de opslagresourceprovider gebruiken voor het beheren van Azure Files om de volgende redenen:

  • Bewerkingen die worden weergegeven via Azure Resource Manager Microsoft Entra ID gebruiken voor verificatie en autorisatie, zodat u Azure Files kunt beheren met behulp van op rollen gebaseerd toegangsbeheer (RBAC). U kunt uw toepassing of service autoriseren om deze API's programmatisch aan te roepen met een Microsoft Entra service-principal.

  • U kunt Azure Resource Manager API's imperatief aanroepen, hetzij rechtstreeks via de REST API of via een SDK. U kunt ze ook declaratief aanroepen door te declareren welke resources moeten worden geïmplementeerd via Azure-sjablonen. Voor resources die herhaaldelijk samen moeten worden gemaakt (bijvoorbeeld in service-implementaties), kan het gebruik van sjablonen het vereiste werk aanzienlijk vereenvoudigen.

  • Hoewel u wordt aangeraden de opslagresourceprovider te gebruiken voor het beheren van opslagresources, kunt u met behulp van de FileREST-gegevensvlakbeheer-API's betere prestaties leveren in gevallen waarin grote schaalaanpassing is vereist. Een voorbeeld van een dergelijk geval is een workload waarmee duizenden bestandsshares in hetzelfde opslagaccount worden gemaakt of gewijzigd.

    • Microsoft.Storage storageAccounts/fileServices/shares activeert een besturingsvlakbewerking via de opslagresourceprovider.
    • Microsoft.Storage storageAccounts/fileServices/fileshares is een gegevensvlakbewerking. Het instellen van rollen op shareniveau, zoals SMB-sharelezer voor opslagbestandsgegevens , moet een gegevensvlakbewerking zijn en moet deze resource gebruiken.

Gegevenslaag

Azure Files biedt een hiërarchisch bestandssysteem voor ongestructureerde gegevens. De FileREST-API modelleert de twee belangrijke objecten in de bestandssysteemruimte: bestanden en mappen. Zie voor meer informatie over het aanroepen van de FileREST-API's:

Zie ook