Partager via


Opérations sur la ressource FileShare

La FileShare ressource fournit une interface de gestion pour le partage de fichiers Azure, qui vous permet de contrôler le nom du partage de fichiers, le protocole activé, la taille allouée (« quota »), etc. La FileShare ressource est un enfant de la FileService ressource, et un compte de stockage peut contenir un nombre infini de partages de fichiers, sous réserve des limites de ressources du compte de stockage.

Vous pouvez interagir avec FileShare les ressources de deux façons :

  • (Recommandé) Le fournisseur de ressources de stockage (Microsoft.Storage), qui fournit une API de plan de contrôle à gérer via Azure Resource Manager.
  • (Hérité) L’API FileREST, qui fournit des points de terminaison HTTPS supplémentaires pour gérer FileShares.

À moins que vous n’ayez une raison spécifique, vous devez utiliser l’API de plan de contrôle (fournisseur de ressources de stockage) pour toutes les activités de gestion. Les API à gérer FileShares sont exposées via le plan de données pour des raisons héritées. Les API de plan de données qui effectuent des actions de gestion sont entièrement prises en charge et acceptables pour une utilisation dans les circonstances suivantes :

  • Vous avez une application ou un service hérité qui utilise déjà ces API.
  • Vous avez des exigences de mise à l’échelle très élevées. L’API de contrôle fournie par le fournisseur de ressources de stockage offre des garanties de mise à l’échelle beaucoup plus faibles que l’API FileREST.

Les nouveaux paramètres et actions sur ne FileService peuvent pas être ajoutés aux kits SDK REST du plan de données, même s’ils sont exposés dans FileREST. Utilisez les SDK du plan de contrôle pour accéder aux paramètres et aux actions.

Pour en savoir plus sur la surface d’exposition de l’API Azure Files, consultez Azure Files’API REST.

API de gestion

Action API du plan de contrôle (Microsoft.Storage) API de plan de données (FileREST) Disponible sur les partages de fichiers SMB Disponible sur les partages de fichiers NFS
Créez FileShare. Partages de fichiers - Create Création de partage Oui Oui
Delete FileShare Partages de fichiers - Supprimer Supprimer le partage Oui Oui
Get FileShare Partages de fichiers - Obtenir Oui Oui
Bail FileShare Partages de fichiers - Bail Partage de bail Oui Oui
Liste FileShares Partages de fichiers - Liste Partages de liste Oui Oui
Restaurer FileShare Partages de fichiers - Restaurer Restaurer le partage Oui Non
Mettre à jour FileShare Partages de fichiers - Mise à jour - Définir les propriétés du partage
- Définir les métadonnées de partage
Oui Oui
Instantané FileShare -- partage de fichiers d'instantanés Oui Oui
Obtenir des FileShare stratégies d’accès stockées -- Obtention de l'ACL du partage Oui Non
Définir des FileShare stratégies d’accès stockées -- Définir l’ACL de partage Oui Non

API de données

Action API Disponible sur les partages de fichiers SMB Disponible sur les partages de fichiers NFS
Create autorisation de liste de contrôle d’accès Créer une autorisation Oui Non
Obtenir l’autorisation de liste de contrôle d’accès Autorisation Get Oui Non

Voir aussi