REST-API für Azure Files

Azure Files stellt gehostete Clouddateifreigaben bereit, auf die Sie zugreifen können (mounten), indem Sie Branchenstandard-Dateisystemprotokolle wie SMB und NFS verwenden. Wenn Sie eine Dateifreigabe auf Ihrem Computer mithilfe von SMB oder NFS bereitstellen, leitet Ihr Betriebssystem API-Anforderungen für das lokale Dateisystem um. Die Umleitung enthält lokale API-Anforderungen, die Sie mithilfe von .NET-Schnittstellen System.IO oder Python-Open-, Lese- oder Schreibmethoden vornehmen. Dies bedeutet, dass Benutzer dieser Anwendungen nichts Besonderes tun müssen oder sogar wissen, dass sich ihre Daten auf einer Remotedateifreigabe anstelle des lokalen Speichers befinden.

Azure Files stellt auch eine REST-API bereit, die häufig als FileREST-API bezeichnet wird. Es bietet eine weitere Methode für den Zugriff auf daten, die in Azure-Dateifreigaben gespeichert sind. SMB und NFS ermöglichen transparenten Zugriff auf Remotedateifreigaben über systemeigene Dateisystem-APIs, das FileREST-Protokoll bietet jedoch eine andere Methode für den Zugriff auf Dateifreigabedaten.

Um die FileREST-API zu verwenden, erstellen Sie HTTPS-Anforderungen für die FileREST-HTTPS-Endpunkte. Sie könnten Code schreiben, um HTTPS-Anforderungen selbst zu erstellen, aber die erwartete Art und Weise, wie Sie die FileREST-API nutzen, ist über die Azure SDKs. Diese SDKs stellen idiomatische Sprach-APIs für beliebte 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. Kopieren, effizienter ausführen, als sie über SMB oder NFS möglich sind.

Die zustandslose Art von HTTPS macht die FileREST-API für Clouddienste oder Anwendungen nützlich, 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 verwenden, um über eine kundeneigene Azure-Dateifreigabe einen Mehrwert hinzuzufügen.

Erwägen Sie die Verwendung der FileREST-API, wenn Sie Mehrwertdienste 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 bereitgestellte 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, systemeigene Dateisystem-APIs zu verwenden.

Wenn Sie über eine vorhandene Anwendung verfügen, die mit systemeigenen Dateisystem-APIs geschrieben wurde, müssen Sie sie nicht neu schreiben, um Azure Files zu nutzen. Der wichtigste Wertvorschlag von Azure Files stellt systemeigene Dateisystem-APIs über die Verwendung von SMB oder NFS zur Verfügung.

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

Steuerungsebene

In Azure wird die Steuerebene über Azure Resource Manager bereitgestellt, was eine gemeinsame Möglichkeit bietet, Azure-Ressourcen verfügbar zu machen, die der Kunde verwaltet. 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 untergeordneter Ressourcen oder Proxyressourcen verfügbar, die die Verwaltung der Speicherdienste ermöglichen, die im Speicherkonto gebündelt sind. Für Azure Files gibt es zwei relevante Proxyressourcen:

  • Die Ressource FileService. Es stellt Einstellungen bereit, die speziell für Azure Files gelten, die für alle Dateifreigaben im Speicherkonto gelten. Die FileService Ressource ist ein untergeordnetes Element des Speicherkontos. Ein Speicherkonto hat immer nur eine FileService Ressource: default.

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

    Obwohl eine FileService Ressource eine unendliche Anzahl von FileShare Ressourcen enthalten kann, ist die Verwendung einer sehr großen Zahl keine gute Idee, da alles innerhalb eines Speicherkontos einen definierten Pool von E/A, Bandbreite und anderen Grenzwerten teilt. Weitere Informationen finden Sie unter Skalierbarkeits- und Leistungsziele für Azure Files.

Informationen zum Aufrufen der Steuerebenen-APIs finden Sie unter:

Vorgänge auf den FileService Und FileShare Objekten können auch über die Datenebene ausgeführt werden. Dies ist ein Artefakt von Azure Files, das Azure Resource Manager vorangestellt hat. Obwohl diese APIs vollständig unterstützt werden, sollten Sie die ApIs des Speicherressourcenanbieters bevorzugen, um Azure Files aus diesen Gründen zu verwalten:

  • Vorgänge, die über Azure Resource Manager verfügbar gemacht werden, verwenden Azure Active Directory (Azure AD) für Authentifizierung und Autorisierung, sodass Sie Azure Files mithilfe der rollenbasierten Zugriffssteuerung (RBAC) verwalten können. Sie können Ihre Anwendung oder Ihren Dienst autorisieren, diese APIs programmgesteuert mit einem Azure AD-Dienstprinzipal aufzurufen.

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

Obwohl wir empfehlen, den Speicherressourcenanbieter zum Verwalten von Speicherressourcen zu verwenden, erhalten Sie mithilfe der FileREST-Datenebenenverwaltungs-APIs eine bessere 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.

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