API REST Azure Files

Azure Files fournit des partages de fichiers cloud hébergés auxquels vous pouvez accéder (« monter ») à l’aide de protocoles de système de fichiers standard du secteur, 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 d’API du système de fichiers local, telles que celles que vous pouvez utiliser. Les interfaces System.IO net ou les méthodes open/read/write de Python. Cela signifie que les applications, et surtout les utilisateurs de ces applications, n’ont pas besoin de faire quelque chose de spécial (ou même de savoir) leurs données se trouve sur un partage de fichiers distant au lieu du stockage local.

Azure Files fournit également une API REST, souvent appelée API FileREST, qui fournit une autre méthode d’accès aux données stockées dans des partages de fichiers Azure. Contrairement à SMB et NFS, qui permettent un accès transparent aux partages de fichiers distants à l’aide d’API de système de fichiers natives, le protocole FileREST fournit une autre méthode d’accès aux données de partage de fichiers. Pour utiliser l’API FileREST, vous créez des requêtes HTTPS sur les points de terminaison HTTPS FileREST. Vous pouvez écrire du code pour créer vous-même des requêtes HTTPS, mais la façon attendue de consommer l’API FileREST consiste à 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, etc.

Étant donné que l’API FileREST 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 FileREST 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 ou des applications à valeur ajoutée pouvant être attachés au partage de fichiers Azure pour ajouter une fonctionnalité. Il peut s’agir d’antivirus, de sauvegarde, de gestion des données ou de produits de réplication. Par exemple, Azure File Sync et Sauvegarde Azure sont des services importants à valeur ajoutée qui utilisent largement l’API FileREST pour ajouter de la valeur au-dessus d’un partage de fichiers Azure appartenant au client.

En règle générale, vous devez envisager d’utiliser l’API FileREST 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 une application métier que les utilisateurs finaux utiliseront par rapport à un partage de fichiers Azure monté, vous pouvez utiliser SMB/NFS ou FileREST, mais vous pouvez constater que l’utilisation de SMB/NFS offre un chemin d’accès plus facile, car ils vous permettent d’utiliser des API de système de fichiers natives. Si vous disposez d’une application existante qui a été écrite des API de système de fichiers natifs, vous n’avez absolument pas besoin de la réécrire pour tirer parti de Azure Files ; la proposition de valeur clé de Azure Files expose les API de système de fichiers natives à 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 biais du Resource Manager Azure, parfois abrégé en tant qu’ARM, qui fournit un moyen courant d’exposer les ressources Azure à gérer par le client. L’unité de gestion de niveau supérieur ou la ressource suivie dans Azure Files et d’autres services de stockage tels que le stockage Blob sont 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 des ressources proxy, qui permettent la gestion des services de stockage groupés dans le compte de stockage. Pour Azure Files, il existe deux ressources 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 FileService seule ressource, appelée default.

  • Ressource FileShare , 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’il 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 du plan de contrôle, consultez :

Pour des raisons héritées, les opérations sur les objets et FileShare les FileService objets peuvent également être effectuées via le plan de données. Il s’agit d’un artefact de Azure Files prédéfini d’Azure Resource Manager et, bien que ces API soient entièrement prises en charge, vous devez préférer 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 utiliser Azure AD pour l’authentification et l’autorisation, ce qui vous permet de gérer Azure Files avec le contrôle d’accès en fonction du rôle (RBAC). Vous pouvez autoriser votre application ou votre service à appeler ces API par programmation avec un principal de service Azure AD.

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

Bien que l’utilisation du fournisseur de ressources de stockage pour gérer les ressources de stockage soit préférable, dans les cas nécessitant une mise à l’échelle élevée, telle qu’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 FileREST sera 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 FileREST modélise les deux objets importants dans l’espace du système de fichiers : fichiers et répertoires. Pour savoir comment appeler les API FileREST, consultez :

Voir aussi