Freigeben über

REST-API für Azure Files

  • Artikel

Azure Files stellt gehostete Clouddateifreigaben bereit, auf die Sie mithilfe branchenüblicher Dateisystemprotokolle wie SMB und NFS zugreifen (einbinden) können. Wenn Sie eine Dateifreigabe mithilfe von SMB oder NFS auf Ihrem Computer bereitstellen, leitet Ihr Betriebssystem API-Anforderungen für das lokale Dateisystem um. Die Umleitung umfasst lokale API-Anforderungen, die Sie mithilfe von .NET-Schnittstellen System.IO oder Python-Methoden zum Öffnen, Lesen oder Schreiben durchführen. Dies bedeutet, dass Benutzer dieser Anwendungen nichts Besonderes tun müssen oder sogar wissen müssen, dass sich ihre Daten auf einer Remotedateifreigabe anstatt auf lokalem Speicher befinden.

Azure Files stellt auch eine REST-API bereit, die häufig als FileREST-API bezeichnet wird. Um die FileREST-API zu verwenden, erstellen Sie HTTPS-Anforderungen für die FileREST-HTTPS-Endpunkte. Sie könnten selbst Code zum Erstellen von HTTPS-Anforderungen schreiben, aber wir stellen Azure SDKs bereit, die die FileREST-API für Sie verwenden, und stellen einen idiomatischen Sprachwrapper über die FileREST-API in beliebten Sprachen wie C#, Java, Python, JavaScript und Go bereit.

Da die FileREST-API speziell für Azure Files entwickelt wurde, können Sie auf Features von Azure Files zugreifen, auf die Sie nicht über SMB oder NFS zugreifen können. Außerdem können Sie bestimmte Vorgänge, z. B. Das Kopieren, effizienter ausführen, als sie über SMB oder NFS möglich sind.

Die zustandslose Art von HTTPS macht die FileREST-API nützlich für Clouddienste oder Anwendungen, die auf viele Azure-Dateifreigaben zugreifen müssen. Sie können beispielsweise Mehrwertdienste oder Anwendungen an eine Azure-Dateifreigabe anfügen, um eine Funktion hinzuzufügen. Diese Dienste oder Anwendungen können Antiviren-, Sicherungs-, Datenverwaltungs- oder Replikationsprodukte umfassen. Azure-Dateisynchronisierung und Azure Backup sind wichtige Microsoft-Dienste, die die FileREST-API umfassend nutzen, um zusätzlich zu einer kundeneigenen Azure-Dateifreigabe einen Mehrwert zu bieten.

Erwägen Sie die Verwendung der FileREST-API, wenn Sie mehrwertige Dienste oder Anwendungen erstellen, insbesondere wenn Sie diese Dienste für Kunden bereitstellen. Wenn Sie eine Branchenanwendung erstellen, insbesondere eine Anwendung, die Benutzer für eine eingebundene Azure-Dateifreigabe verwenden, können Sie entweder SMB/NFS oder FileREST verwenden. Möglicherweise stellen Sie jedoch fest, dass die Verwendung von SMB oder NFS einen einfacheren Pfad bietet, da diese Protokolle es Ihnen ermöglichen, native Dateisystem-APIs zu verwenden.

Wenn Sie über eine vorhandene Anwendung verfügen, die mit nativen Dateisystem-APIs geschrieben wurde, müssen Sie sie nicht umschreiben, um Azure Files zu nutzen. Das wichtigste Wertversprechen von Azure Files ist die Bereitstellung nativer Dateisystem-APIs durch die Verwendung von SMB oder NFS.

Weitere Informationen zu Azure Files, einschließlich Bereitstellung, Netzwerk- und Identitätskonfiguration, finden Sie unter:

Steuerungsebene

In Azure wird die Steuerungsebene über Azure Resource Manager bereitgestellt, was eine gängige Möglichkeit zum Verfügbarmachen von Azure-Ressourcen bietet, die der Kunde verwalten wird. Die Verwaltungseinheit auf oberster Ebene ist das Speicherkonto. Das Speicherkonto ist eine nachverfolgte Ressource in Azure Files und anderen Speicherdiensten, z. B. Azure Blob Storage.

Das Speicherkonto wird vom Speicherressourcenanbieter verwaltet, der über den Namespace Microsoft.Storageverfügt. Der Speicherressourcenanbieter macht auch die Verwaltung von untergeordneten Ressourcen oder Proxyressourcen verfügbar, die die Verwaltung der im Speicherkonto gebündelten Speicherdienste ermöglichen. Für Azure Files gibt es zwei relevante Proxyressourcen:

  • Die Ressource FileService. Sie bietet spezifische Einstellungen für Azure Files, die für alle Dateifreigaben im Speicherkonto gelten. Die FileService Ressource ist ein untergeordnetes Element des Speicherkontos. Ein Speicherkonto verfügt immer nur über eine FileService Ressource: default.

  • Die Ressource FileShare. Sie stellt eine Dateifreigabe oder eine Momentaufnahme einer Dateifreigabe dar. Die FileShare Ressource ist ein untergeordnetes Element der FileService Ressource und kann eine unbegrenzte Anzahl von Dateifreigaben enthalten.

Obwohl eine FileService Ressource eine unbegrenzte Anzahl von FileShare Ressourcen enthalten kann, ist die Verwendung einer sehr großen Anzahl keine gute Idee, da alles in einem Speicherkonto einen definierten Pool mit E/A-, Bandbreiten- und anderen Grenzwerten gemeinsam verwendet. Weitere Informationen finden Sie unter Skalierbarkeits- und Leistungsziele für Azure Files.

Informationen zum Aufrufen der STEUERUNGsebenen-APIs finden Sie unter:

Vorgänge für die FileService Objekte und FileShare können auch über die Datenebene ausgeführt werden. Dies ist ein Artefakt von Azure Files, die Azure Resource Manager voraus sind. Obwohl diese APIs vollständig unterstützt werden, sollten Sie in den meisten Fällen die Speicherressourcenanbieter-APIs verwenden, um Azure Files aus den folgenden Gründen zu verwalten:

  • Vorgänge, die über Azure Resource Manager verfügbar gemacht werden, verwenden Microsoft Entra ID für Authentifizierung und Autorisierung, sodass Sie Azure Files mithilfe der rollenbasierten Zugriffssteuerung (Role-Based Access Control, RBAC) verwalten können. Sie können Ihre Anwendung oder Ihren Dienst zum programmgesteuerten Aufrufen dieser APIs mit einem Microsoft Entra Dienstprinzipal autorisieren.

  • Sie können Azure Resource Manager-APIs zwingend aufrufen, entweder direkt über die REST-API oder über ein SDK. Sie können sie auch deklarativ aufrufen, indem Sie deklarieren, welche Ressourcen über Azure-Vorlagen bereitgestellt werden müssen. Für Ressourcen, die wiederholt zusammen erstellt werden müssen (z. B. in Dienstbereitstellungen), kann die Verwendung von Vorlagen die erforderliche Arbeit erheblich vereinfachen.

  • Es wird zwar empfohlen, den Speicherressourcenanbieter zum Verwalten von Speicherressourcen zu verwenden, die Verwendung der FileREST-Datenebenenverwaltungs-APIs führt jedoch zu einer besseren Leistung in Fällen, die eine hohe Skalierung erfordern. Ein Beispiel für einen solchen Fall ist eine Workload, die Tausende von Dateifreigaben innerhalb desselben Speicherkontos erstellt oder ändert.

    • Microsoft.Storage storageAccounts/fileServices/shares löst einen Vorgang auf Steuerungsebene über den Speicherressourcenanbieter aus.
    • Microsoft.Storage storageAccounts/fileServices/fileshares ist ein Vorgang auf Datenebene. Das Festlegen von Rollen auf Freigabeebene, z. B. Speicherdateidaten-SMB-Freigabeleser , sollte ein Vorgang auf Datenebene sein und diese Ressource verwenden.

Datenebene

Azure Files stellt ein hierarchisches Dateisystem für unstrukturierte Daten bereit. Die FileREST-API modelliert die beiden wichtigen Objekte im Dateisystembereich: Dateien und Verzeichnisse. Informationen zum Aufrufen der FileREST-APIs finden Sie unter:

Weitere Informationen