API REST Azure Files

Azure Files fournit les partages de fichiers Cloud hébergés auxquels vous pouvez accéder (« monter ») à l’aide des protocoles standard du système de fichiers tels que SMB et NFS. Lorsque vous montez un partage de fichiers sur votre ordinateur à l’aide de SMB ou NFS, votre système d’exploitation redirige les demandes de l’API du système de fichiers local, telles que celles que vous pouvez effectuer à l’aide de. Les interfaces System.IO du réseau ou les méthodes d’ouverture/lecture/écriture de Python. Cela signifie que les applications, et les utilisateurs importants de ces applications, n’ont pas besoin de faire quelque chose de spécial (ou même de savoir que) leurs données se trouvent sur un partage de fichiers distant au lieu d’un stockage local.

Azure Files fournit également une API REST, souvent appelée API du serveur de fichiers, qui fournit une autre méthode d’accès aux données stockées dans les partages de fichiers Azure. Contrairement à SMB et NFS, qui permettent un accès transparent aux partages de fichiers distants à l’aide des API du système de fichiers natif, le protocole du filtre de fichiers fournit une méthode d’accès aux données de partage de fichiers différente. Pour utiliser l’API du serveur de fichiers, vous devez créer des requêtes HTTPs sur les points de terminaison HTTPs du serveur de fichiers. Vous pouvez écrire du code pour créer vous-même des requêtes HTTPs, mais la façon dont vous consommez l’API du serveur de fichiers est d’utiliser les kits de développement logiciel (SDK) Azure, qui fournissent des API de langage idiomatique pour des langages populaires tels que C#, Java, Python, JavaScript, Go et d’autres.

Étant donné que l’API du serveur de fichiers a été conçue spécifiquement pour Azure Files, elle vous permet d’accéder aux fonctionnalités de Azure Files qui ne sont pas accessibles via SMB ou NFS, et d’effectuer certaines opérations, telles que la copie, plus efficacement que via SMB/NFS. La nature sans état du protocole HTTPs rend l’API du filtre de fichiers utile pour une utilisation dans les services Cloud ou les applications qui doivent accéder à de nombreux partages de fichiers Azure, tels que des services à valeur ajoutée ou des applications qui peuvent être attachées au partage de fichiers Azure pour ajouter des fonctionnalités. Celles-ci peuvent inclure des produits antivirus, de sauvegarde, de gestion des données ou de réplication. Par exemple, Azure File Sync et Azure Backup sont des services à valeur ajoutée notables qui utilisent largement l’API du serveur de fichiers pour ajouter de la valeur en haut d’un partage de fichiers Azure appartenant à un client.

En règle générale, vous devez envisager d’utiliser l’API du serveur de fichiers si vous créez des services ou des applications à valeur ajoutée, en particulier si vous fournissez de tels services à valeur ajoutée à vos clients. Si vous construisez une application métier, en particulier celle que les utilisateurs finaux utiliseront sur un partage de fichiers Azure monté, vous pouvez utiliser SMB/NFS ou le serveur de fichiers le plus, mais vous constaterez peut-être que l’utilisation de SMB/NFS offre un chemin d’accès plus facile dans la mesure où ils vous permettent d’utiliser des API de système de fichiers natif. Si vous disposez d’une application existante qui a écrit des API du système de fichiers natif, vous n’avez absolument pas besoin de la réécrire pour tirer parti des Azure Files ; la proposition de valeur de clé de Azure Files consiste à exposer des API de système de fichiers natif à l’aide de SMB ou NFS.

Pour en savoir plus sur les Azure Files, notamment le déploiement, la mise en réseau et la configuration des identités, consultez :

Plan de contrôle

Dans Azure, le plan de contrôle est fourni par le Azure Resource Manager, parfois abrégé comme ARM, qui offre un moyen courant d’exposer les ressources Azure à gérer par le client. L’unité de gestion de niveau supérieur, ou ressource suivie dans Azure Files, et d’autres services de stockage tels que le stockage d’objets BLOB, est le compte de stockage. Le compte de stockage est géré par le fournisseur de ressources de stockage, qui a l’espace de noms Microsoft. Stockage. Le fournisseur de ressources de stockage expose également la gestion des ressources enfants, ou ressources de proxy, qui permettent de gérer les services de stockage regroupés dans le compte de stockage. Pour Azure Files, il existe deux ressources de proxy pertinentes :

  • La FileService ressource, qui fournit Azure Files paramètres spécifiques qui s’appliquent à tous les partages de fichiers dans le compte de stockage. La FileService ressource est un enfant de la ressource suivie du compte de stockage et un compte de stockage n’a jamais qu’une seule FileService ressource, appelée default .

  • FileShareRessource, qui représente un partage de fichiers (ou un instantané d’un partage de fichiers). La FileShare ressource est un enfant de la FileService ressource et peut contenir un nombre infini de partages de fichiers. Bien qu’un FileService puisse contenir un nombre infini de FileShare ressources, l’utilisation d’un très grand nombre n’est pas une bonne idée, car tout ce qui se trouve dans un compte de stockage partage un pool défini d’e/s, de bande passante et d’autres limites. Pour plus d’informations, voir Objectifs de performance et d’extensibilité d’Azure Files.

Pour savoir comment appeler les API de plan de contrôle, consultez :

Pour des raisons d’héritage, les opérations sur les FileService FileShare objets et peuvent également être effectuées par le biais du plan de données. Il s’agit d’un artefact de Azure Files la mise à jour de Azure Resource Manager. bien que ces API soient entièrement prises en charge, il est préférable d’utiliser les API du fournisseur de ressources de stockage pour gérer Azure Files pour plusieurs raisons :

  • Les opérations exposées via Azure Resource Manager utilisent Azure AD pour l’authentification et l’autorisation, ce qui vous permet de gérer les Azure Files avec le contrôle d’accès en fonction du rôle (RBAC). Vous pouvez autoriser votre application ou service à appeler ces API par programmation avec un principal de service Azure AD.

  • Azure Resource Manager API peuvent être appelées de manière impérative, à l’aide de l’API REST directement ou via un kit de développement logiciel (SDK), ou de façon déclarative, en déclarant les ressources qui doivent être déployées à l’aide de modèles Azure. Pour les ressources qui doivent être créées à plusieurs reprises, les déploiements de service, etc., l’utilisation de modèles peut considérablement simplifier le travail requis.

Bien qu’il soit préférable d’utiliser le fournisseur de ressources de stockage pour gérer les ressources de stockage, dans les cas nécessitant une grande échelle, par exemple une charge de travail qui crée ou modifie des milliers de partages de fichiers dans le même compte de stockage, l’utilisation des API de gestion du plan de données du serveur de fichiers est la plus performante.

Plan de données

Azure Files fournit un système de fichiers hiérarchique pour les données non structurées (« fichiers »). L’API du serveur de fichiers modélise les deux objets importants dans l’espace de système de fichiers : les fichiers et les répertoires. Pour savoir comment appeler les API du serveur de fichiers, consultez :

Voir aussi