Partager via

API REST Azure Files

  • Article

Azure Files fournit des partages de fichiers cloud hébergés auxquels vous pouvez accéder (montage) à l’aide de protocoles de système de fichiers standard 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 pour le système de fichiers local. La redirection inclut les demandes d’API locales que vous effectuez à l’aide d’interfaces .NET System.IO ou de méthodes d’ouverture, de lecture ou d’écriture Python. Cela signifie que les utilisateurs de ces applications n’ont pas besoin de faire quelque chose de spécial ou même de savoir que leurs données se situent sur un partage de fichiers distant au lieu d’un stockage local.

Azure Files fournit également une API REST, souvent appelée API FileREST. 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 nous fournissons des kits SDK Azure qui utilisent l’API FileREST, en fournissant un wrapper de langage idiomatique sur l’API FileREST dans des langages courants tels que C#, Java, Python, JavaScript et Go.

É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 auxquelles vous ne pouvez pas accéder via SMB ou NFS. Il vous permet également d’effectuer certaines opérations, telles que la copie, plus efficacement que vous ne le pouvez via SMB ou NFS.

La nature sans état du protocole HTTPS rend l’API FileREST utile pour les services cloud ou les applications qui ont besoin d’accéder à de nombreux partages de fichiers Azure. Par exemple, vous pouvez attacher des applications ou des services à valeur ajoutée à un partage de fichiers Azure pour ajouter une fonctionnalité. Ces services ou applications peuvent inclure des produits antivirus, de sauvegarde, de gestion des données ou de réplication. Azure File Sync et Sauvegarde Azure sont des services Microsoft notables qui utilisent largement l’API FileREST pour ajouter de la valeur à un partage de fichiers Azure appartenant au client.

Envisagez d’utiliser l’API FileREST si vous créez des applications ou des services à valeur ajoutée, en particulier si vous fournissez ces services aux clients. Si vous construisez une application métier, en particulier une application que les utilisateurs utiliseront sur un partage de fichiers Azure monté, vous pouvez utiliser SMB/NFS ou FileREST. Toutefois, vous constaterez peut-être que l’utilisation de SMB ou NFS offre un chemin d’accès plus facile, car ces protocoles vous permettent d’utiliser des API de système de fichiers natifs.

Si vous avez une application existante qui a été écrite avec des API de système de fichiers natives, vous n’avez pas besoin de la réécrire pour tirer parti de Azure Files. La proposition de valeur clé de Azure Files est l’exposition des API de système de fichiers natives via l’utilisation 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 via Azure Resource Manager, qui fournit un moyen courant d’exposer les ressources Azure que le client gérera. L’unité de gestion de niveau supérieur est le compte de stockage. Le compte de stockage est une ressource suivie dans Azure Files et d’autres services de stockage, tels que Stockage Blob Azure.

Le compte de stockage est géré par le fournisseur de ressources de stockage, qui a l’espace de noms Microsoft.Storage. 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 :

  • Ressource FileService. Il fournit des paramètres spécifiques aux Azure Files qui s’appliquent à tous les partages de fichiers dans le compte de stockage. La FileService ressource est un enfant du compte de stockage. Un compte de stockage n’a toujours qu’une FileService seule ressource : default.

  • Ressource FileShare. Il 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’une FileService ressource 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 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 :

Les opérations sur les FileService objets et FileShare peuvent également être effectuées via le plan de données. Il s’agit d’un artefact de Azure Files antérieur à Azure Resource Manager. Bien que ces API soient entièrement prises en charge, dans la plupart des cas, vous devez utiliser les API du fournisseur de ressources de stockage pour gérer Azure Files pour les raisons suivantes :

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

  • Vous pouvez appeler les API Azure Resource Manager de manière impérative, soit via l’API REST directement, soit via un KIT de développement logiciel (SDK). Vous pouvez également les appeler de manière déclarative, en déclarant les ressources qui doivent être déployées via des modèles Azure. Pour les ressources qui doivent être créées à plusieurs reprises ensemble (par exemple, dans les déploiements de service), l’utilisation de modèles peut considérablement simplifier le travail requis.

  • Bien que nous vous recommandons d’utiliser le fournisseur de ressources de stockage pour gérer les ressources de stockage, l’utilisation des API de gestion du plan de données FileREST vous donnera de meilleures performances dans les cas qui nécessitent une mise à l’échelle élevée. Une charge de travail qui crée ou modifie des milliers de partages de fichiers au sein du même compte de stockage est un exemple d’un tel cas.

    • Microsoft.Storage storageAccounts/fileServices/shares déclenche une opération de plan de contrôle via le fournisseur de ressources de stockage.
    • Microsoft.Storage storageAccounts/fileServices/fileshares est une opération de plan de données. La définition de rôles au niveau du partage, tels que Lecteur de partage SMB de fichier de stockage , doit être une opération de plan de données et doit utiliser cette ressource.

Plan de données

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

Voir aussi